Skip to content

Commit aa5d8a0

Browse files
grimmerkclaude
andcommitted
docs: add App Mode comparison table to README
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 36a9694 commit aa5d8a0

1 file changed

Lines changed: 17 additions & 1 deletion

File tree

README.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Quick switcher for VS Code/Cursor projects, Claude Code session manager with liv
88

99
### Quick Switcher for VS Code / Cursor Projects
1010

11-
Spotlight-like quick open: press `⌃+⌘+R` or click the menu bar icon to launch the Quick Switcher. Search and select a project to open or switch to it in VS Code or Cursor — even if the IDE is not running yet.
11+
Press `⌃+⌘+R` or click the menu bar icon to launch the Quick Switcher. Search and select a project to open or switch to it in VS Code or Cursor — even if the IDE is not running yet. In Normal App mode, the window stays visible for monitoring; in Menu Bar mode, it works like Spotlight.
1212

1313
- **Recent projects** (white items): your latest VS Code/Cursor folders, workspaces, and recently opened files — read directly from IDE data, no extension required
1414
- **Working folder items** (green items): first-level subfolders found by scanning a folder you choose (Settings → Working Directory)
@@ -52,6 +52,22 @@ CodeV includes a built-in terminal tab (powered by xterm.js + node-pty, same tec
5252
- `Cmd+←/→` jumps to beginning/end of line
5353
- **"Claude in Terminal" button**: launches a new Claude Code session in the configured external terminal using the current working directory
5454

55+
### App Mode
56+
57+
CodeV supports two window modes, configurable in Settings → App Mode:
58+
59+
| | Normal App (default) | Menu Bar |
60+
|--|--|--|
61+
| **Dock** | Visible | Hidden |
62+
| **On blur** | Stays visible | Auto-hides |
63+
| **Window position** | Remembers last position, draggable | Centers on screen each time |
64+
| **On startup** | Shows window | Hidden until shortcut/tray click |
65+
| **`⌃+⌘+R`** | Toggle show/hide | Toggle show/hide |
66+
| **Click Dock icon** | Shows hidden window | N/A |
67+
| **Best for** | Dashboard / monitoring (keep in corner) | Quick access (spotlight-like) |
68+
69+
**Real-time updates when unfocused (Normal mode):** Status dots, final assistant/user messages, and session order update via fs.watch — no need to re-focus. New sessions and full list refresh only occur on re-focus.
70+
5571
### Tab Switching
5672

5773
| Shortcut | Action |

0 commit comments

Comments
 (0)