Keyboard & Command Reference

These work from any screen, including when focus is inside an input.

Ctrl+B does different things depending on mode. In Chat mode it toggles the session list; in Code mode it toggles the file tree. These are the same physical shortcut bound to different actions.

Open specific AI panels in Code mode. All five shortcuts open the Bodega Panel if it's closed, then activate the right tab. They have no effect in Chat mode.

Ctrl+Shift+E opens the Debug panel - not the file explorer. The file explorer has no dedicated shortcut; use Ctrl+B to toggle it.

Files and tabs

Search and navigation

AI editing

Git and source control

Formatting and diagnostics

Ctrl+P only works in Code mode. Ctrl+F and Ctrl+Alt+F are Monaco native overlays - not intercepted by the app shell. Ctrl+H (Find and Replace) is the default Monaco binding on Windows but collides with "Hide Application" on macOS; use Ctrl+Alt+F instead for consistency across platforms.

Fleet shortcuts only fire in Code mode unless noted.

Ctrl+W closes an editor tab. Ctrl+Shift+W closes the active fleet session - the extra Shift is intentional to prevent accidental session termination.

Fill-in-the-Middle completions appear as inline ghost text in the Monaco editor while you type.

Completions trigger automatically after a short debounce. The FIM model is auto-detected from installed models; assign a specific model at Settings → Models → My Models → FIM.

Models with native FIM tokens: qwen2.5-coder, codellama, deepseek-coder, codestral, starcoder, starcoder2, codegemma, stable-code. qwen3-coder uses prompt-injection fallback.

Tab and Ctrl+Right only accept ghost text when a suggestion is visible. When no suggestion is shown, Tab inserts a literal tab.

Panel control (work from any focus point)

When the terminal has focus

Inside the AI Assist overlay (Ctrl+I)

Ctrl+F in the terminal opens terminal output search - distinct from Ctrl+Shift+F (project file search). Ctrl+I and block-navigation only fire when the terminal has focus. The AI Assist generator scopes commands to the current working directory.

Type / in any chat or AI panel input. A autocomplete menu appears with all available commands.

/reset and /model are not registered commands. Typing them shows a toast listing the actual available commands (the same list /help prints).

/export shows an info toast instead of exporting when used in Code mode.

Ten built-in skills ship as SKILL.md files. Their triggers pass through to the backend LLM as structured workflow invocations - they're not handled client-side.

Skill triggers load from the backend on startup. Disabling a skill in Settings → Extensions → Skills removes its trigger from the autocomplete list. You can define custom skills there too; user-created skills live in ~/.bodega/skills/<name>/SKILL.md.

/review (the skill) is distinct from the Git panel "Review" button. The skill reads a recent project file; the button reviews the current git diff using your LLM.

1. Press Ctrl+Shift+P to open.
2. Type any part of the action name - fuzzy matching works. For example, ter max matches "Toggle Terminal Maximize".
3. Press Enter or click an action to execute. Esc closes without acting.

Actions grouped by category:

• Navigation: Switch to Chat Mode (Ctrl+1), Switch to Code Mode (Ctrl+2), Toggle Settings Panel (Ctrl+,), Show Usage Panel, Show Agents Panel
• Terminal: Toggle Terminal (Ctrl+\``), Toggle Terminal Maximize (Ctrl+Shift+`), New Terminal Tab (Ctrl+Shift+T`)
• View: Toggle Sidebar (Ctrl+B), Reload Window (Ctrl+R), Show Keyboard Shortcuts (Ctrl+/)
• Panels: Debug Panel (Ctrl+Shift+E)
• Editor: Toggle File Explorer (Ctrl+Shift+B), Close Active Editor Tab (Ctrl+W), Go to Line (Ctrl+G), Toggle Split Editor (Ctrl+\\)
• Search: Search in Files (Ctrl+Shift+F), Go to File... (Ctrl+P)
• Source Control: Open Source Control (Ctrl+Shift+G)

The Command Palette lists "Focus File Explorer" as Ctrl+Shift+B (toggle Bodega Panel). Ctrl+Shift+E is Debug Panel, not File Explorer - an older label that was corrected in a post-beta.23 audit.

18 shortcuts can be rebound and saved persistently.

1. Go to Settings → Workspace → Keybindings. (This section only appears when Show advanced settings is enabled in the Settings sidebar.)
2. Filter the list by action name or current key combination.
3. Click any shortcut badge. It pulses with "Press keys..."
4. Press the combination you want. If it conflicts with another bound action, a toast names the conflict and cancels capture.
5. Press Esc to cancel without changing.
6. To restore a default: hover the entry and click Reset.

Custom bindings are saved to the editor.keybindings setting as JSON. Changes require an app restart to take full effect.

Rebindable shortcuts by category:

Shortcuts handled at the OS level (Ctrl+C, Ctrl+V) cannot be remapped.

The Git panel has a Review button that sends the current diff to your LLM and returns a structured review grouped under Critical / High / Suggestions headings.

1. Open the Git panel with Ctrl+Shift+G or click the branch name in the status bar.
2. Click Review (in the panel header actions row, next to Generate and Stage All).
3. Review output appears inline above the file list. Dismiss it with the X button.

The review uses the model assigned to the explain role (the same model used for code explanations in the editor). Large diffs are capped at 14,000 characters; a truncation note appears in the output if the diff is cut.

When the working tree is dirty, the review covers staged + unstaged changes (the pre-commit case). When the working tree is clean, it falls back to the branch-vs-base diff (the PR scope).

Requires an open project folder. Returns an error if the folder isn't a git repository or has no changes.

Fast Mode disables extended thinking on Anthropic Claude models globally. It does not change the model - it removes the extended thinking overhead so responses come back faster.

Enable: the Fast toggle in the message composer (next to the reasoning control; shown only for Claude models).

The per-message reasoning control in the composer pill still wins. If you set reasoning to Low / Medium / High for a specific message, that overrides Fast Mode for that message only.

Fast Mode has no effect on non-Claude models. The setting key is llm.claude_fast_mode (boolean, default false).

You can define named agents with a custom system prompt, pinned model, tool allowlist, read-only filesystem flag, and iteration cap.

Create an agent:

1. Go to Settings → AI → Custom Agents. (Requires Show advanced settings.)
2. Click New Agent.
3. Fill in: name, optional description, system prompt, model override (blank = active model), tool allowlist, read-only filesystem toggle, max iterations.

Activate an agent:

• In Code mode, the Agent panel header shows a profile picker (robot icon with the current agent name).
• Click it to see a dropdown with Default and your custom agents.
• Select one - it applies to the next message and persists until you switch back to Default.
• The picker is hidden when you have no custom agents.

The tool allowlist narrows available tools - it cannot grant access to tools not available to the default agent. Custom agents are distinct from the built-in skills (/commit, /debug, etc.), which are managed via Settings → Extensions → Skills.

Bodega One can run as an ACP (Agent Client Protocol) server so external editors - like Zed - can drive it as an AI agent over stdio.

Start the server:

bodega --acp

Bodega starts in headless JSON-RPC mode on stdio. No Electron window appears.

Protocol methods: initialize (advertises capabilities + tool list), session/new (creates a session, confines the working directory), session/prompt (runs one agentic turn), session/cancel.

Connecting external ACP agents to Fleet (Claude Code, Gemini CLI, Codex, Cursor): Settings → Extensions → ACP Agents. Each agent needs its binary installed and an API key (or login auth for Cursor). The section shows install hints and key fields for each supported agent.

CWD confinement is enforced - session/new validates that the requested working directory is within your allowed projects directory. Claude Code requires an interactive /login before use outside of Bodega; authenticate once before running Fleet.

Bodega can manage the llama-server --embedding process automatically (port 8081), and the Embeddings settings show a dropdown of your installed GGUFs so you don't have to type a path.

Set up managed embeddings:

1. Go to Settings → Models and scroll to the Codebase Embeddings section (or search "embeddings").
2. Select llama.cpp as the provider.
3. Enable Let Bodega manage the embedding server.
4. Pick a GGUF from the dropdown - it lists everything installed via Models → llama.cpp → Discover. Or type a manual path in the text field below.
5. Set the port (default 8081).

Bodega starts the server lazily on the first index build. If the model path is empty with managed mode on, Bodega points at any server you're already running.

Recommended embedding models: nomic-embed-text, BGE series.

The llama.cpp binary must be installed (Settings → Models → llama.cpp) for managed mode to work. The embedding server (port 8081) and the chat llama-server (port 8080) are separate processes.

Bodega Map is an interactive dependency graph of your codebase. Nodes are files; edges are imports. It runs in Code mode only.

Open the Map:

• Activity Bar (left sidebar) → Map icon
• Command Palette → "Open Codebase Map"
• Type /map in any AI panel input

Requires the Dockview layout engine (Settings → Layout → Dockview). In Legacy layout, the Map falls back to an editor tab.

Interactions:

• Click a node to open the detail drawer (imports, exports, relationships).
• Explain this module in the drawer - your LLM writes a plain-English summary, cached by file content hash.
• Toolbar model picker - choose which model writes explanations (blank = active model).
• Generate Map button - bulk-explains all visible files (4 concurrently, with live progress and a cancel button).
• Ask the Map bar at the bottom - free-form questions answered via RAG over your codebase embeddings.

Staleness: amber dots on nodes mean the cached explanation is out of date (file content changed since last generation). The drawer badge shows the stale count.

"Ask the Map" uses two models: a chat model for the answer and an embeddings model for retrieval. Configure the embeddings model at Settings → Models → Codebase Embeddings. The first question triggers the index build, which may take a few seconds.