Code Spots
Files, commands, AI rules, and Bitwarden access for a project — in VS Code, Cursor, and Antigravity.
Product info, pricing, and purchase: ready-4-it.com — Code Spots
Guides & FAQ: Product guides · Catalog: Products
Screenshots

Bookmarks — files, lines, and commands in the sidebar

Shell — a command bookmark with parameters

AI memory — workspace-wide or user-wide rules the AI follows

Secrets — Bitwarden access for this workspace, used through references you define

Unlock — Bitwarden login, display PIN, and deploy on this PC
What it does
- Keeps the working set of a project together: files and lines, frequent texts, commands with parameters, URLs, AI prompts, clipboard snippets, shell commands, workflows, and cursor positions
- Shares that project information through the Git repo
- Gives the AI instructions that apply workspace-wide or user-wide, in VS Code, Cursor, and Antigravity
- Lets the AI manage Bitwarden access for this code through references you define, after you unlock the session
- Organizes those entries in categories in the sidebar, including multi-root workspaces
Who it's for
- People who keep project URLs, commands, texts, and AI rules in tabs, notes, and chats
- Teams who want that project information in the Git repo, and access in Bitwarden
Quick Start
- Install the extension and open any VS Code workspace
- Click the Code Spots icon in the Activity Bar — or press
Ctrl+Alt+B
- Right-click a file in the Explorer → Code Spots: Add to Category to create your first bookmark
Key Features
Bookmark types
| Type |
What it stores |
| File |
A workspace file, opened on click |
| Line |
A file + line number anchor |
| URL |
External or internal URL |
| AI Clip |
A reusable AI prompt snippet |
| Clipboard |
A reusable text/clipboard snippet |
| Shell |
A shell command to run in the terminal |
| Position |
A cursor position anchor |
| Workflow |
A multi-step workflow reference |
Team & Personal Storage
- Shared —
.csvs/shared.json, committed with your code so the team shares the same bookmarks
- Personal —
.csvs/personal.<hash>.enc.json, encrypted with a per-developer data key (XSalsa20-Poly1305). The same display PIN wraps that key in this editor. A PIN change leaves the file unchanged. A lost PIN cannot be created again. Committed but unreadable to others; identity derived from OS username and machine ID (not Git config)
Categories
Organize bookmarks in named categories. Use the 15 built-in defaults or define your own. Assign files via drag-and-drop or the Assign Files panel.
Secrets Vault
Open Secrets from the sidebar and turn the connection on from that screen. Collections apply to this workspace, and the display PIN stays in this editor. Overlay auto-lock hides Secrets and does not drop the Bitwarden session. Idle drops only this editor’s unlock key.
Export / Import
Share or back up the full bookmark set with Export (Ctrl+Alt+E). Import is available in Trial/Pro/Team (Ctrl+Alt+I).
Licensing & Free limits
Code Spots runs in Free mode by default (no activation required). Free has soft limits: existing items remain usable, but creating new ones is blocked after the limit.
- URL bookmarks: 10
- Shell command bookmarks: 10
- AI Clip bookmarks: 10
- Workflow bookmarks: 5
- Vault secrets: 3
Trial/Pro/Team remove these limits and unlock features like Import, encrypted personal storage, and global (cross-workspace) storage.
Repair & Diagnose
Built-in commands recover from Git merge-conflict markers and inspect storage state.
Why it's different
Code Spots keeps the working set of a project in one place: files and lines, frequent texts, commands with parameters, URLs, AI prompts, clipboard snippets, shell commands, workflows, and cursor positions. That project information is shared through the Git repo. Personal items stay encrypted, protected in Bitwarden, and in sync for the team.
The AI receives instructions, workspace-wide or user-wide, in VS Code, Cursor, and Antigravity, and is meant to follow them.
The AI manages access in Bitwarden for your own code. On deploy, after you unlock the session, it uses references you define. Without that unlock the credentials stay closed. No other AI currently offers this for your own code.
Commands
| Command |
Shortcut |
Description |
| Code Spots: Reveal Sidebar |
Ctrl+Alt+B |
Open the sidebar panel |
| Code Spots: Add Bookmark from Current Line |
Ctrl+Alt+L |
Bookmark the current editor line |
| Code Spots: Add to Category |
Ctrl+Alt+A |
Bookmark a file from the Explorer |
| Code Spots: Add URL from Selection |
Ctrl+Alt+U |
Bookmark a selected URL |
| Code Spots: Export Bookmarks |
Ctrl+Alt+E |
Export the full bookmark set |
| Code Spots: Import Bookmarks |
Ctrl+Alt+I |
Import a bookmark set |
| Code Spots: Add URL Bookmark |
— |
Add a custom URL bookmark |
| Code Spots: Add AI Clip Bookmark |
— |
Add a reusable AI prompt snippet |
| Code Spots: Add Clipboard Bookmark |
— |
Add a clipboard snippet |
| Code Spots: Add Shell Command Bookmark |
— |
Add a shell command |
| Code Spots: Add Workflow Bookmark |
— |
Add a workflow reference |
| Code Spots: Add Position Bookmark |
— |
Anchor the current cursor position |
| Code Spots: Categories |
— |
Manage categories |
| Code Spots: Assign Files |
— |
Assign files to categories |
| Code Spots: Manage Secrets |
— |
Open the Secrets vault panel |
| Code Spots: Repair Bookmarks |
— |
Recover from storage / merge issues |
| Code Spots: Diagnose Storage |
— |
Inspect current storage state |
| Code Spots: Settings |
— |
Open the extension settings panel |
Settings
| Key |
Default |
Description |
codespots.htmlOpenMode |
internal |
How to open .html bookmarks: internal (VS Code preview) or external (browser) |
codespots.mdViewerCommandId |
markdown.showPreviewToSide |
Command used to open .md bookmarks — swap to any Markdown viewer extension |
codespots.defaultCategories.selected |
(15 defaults) |
Which default category templates are active and their order |
codespots.defaultCategories.custom |
[] |
Extra category templates available in the Settings panel |
codespots.secrets.autoLockSeconds |
60 |
Inactivity timeout before the Secrets vault auto-locks (10–600 s) |
Troubleshooting
Sidebar is blank after install
→ Run Code Spots: Reveal Sidebar (Ctrl+Alt+B) to focus the view.
Bookmarks missing after a Git pull
→ Run Code Spots: Repair Bookmarks — it resolves merge conflict markers in .csvs/shared.json.
Storage looks wrong
→ Use Code Spots: Diagnose Storage to inspect the current state of shared and personal storage.
Secrets vault locked / PIN forgotten
→ Unlock with the Bitwarden master password and a new PIN (at least 4 characters). There is no Forgot PIN and Diagnose Storage does not clear the PIN.
Privacy & Data Handling
Code Spots does not send telemetry or workspace content to any external service.
| Data |
Where stored |
Leaves device? |
| Shared bookmarks |
.csvs/shared.json in workspace |
Only if you commit and push to Git |
| Personal bookmarks |
.csvs/personal.<hash>.enc.json (encrypted) |
Only if you commit and push to Git |
| Secrets |
Bitwarden vault for this workspace |
Only through the Bitwarden account you unlock |
| Display PIN |
This editor |
Never |
| Activation token |
VS Code SecretStorage |
Never after local storage; activation itself is completed by the user on ready-4-it / LB |
See PRIVACY.md for the full statement.
Support
License
See LICENSE.txt.
Copyright (c) 7/2025 Ready-4-IT