# Verne > Verne is an open-source IDE that wraps Claude Code, Codex, and any CLI coding agent in a real macOS workspace with terminals, a code editor, an embedded browser, git, and agent-readable notes. Run several projects side by side, isolate work in git worktrees, and see what every agent is doing without reading each terminal. ## Documentation - [Overview](https://verne.build/docs/): Verne is the IDE for your CLI agents. Wrap Claude Code, Codex, or any CLI agent in a real workspace with files, editor, browser, and git. ## Getting Started - [What is Verne?](https://verne.build/docs/getting-started/what-is-verne/): Verne is an open-source macOS IDE for your CLI coding agents, with terminals, a code editor, an embedded browser, git, and agent-readable notes in one window. - [Installation](https://verne.build/docs/getting-started/installation/): Download Verne for macOS, install the verne CLI, and keep the app up to date. - [Your First Session](https://verne.build/docs/getting-started/first-session/): Open a project, launch a CLI agent, and watch Verne track its status as it works. - [Supported Agents](https://verne.build/docs/getting-started/supported-agents/): The CLI agents Verne detects, and its three levels of integration, from detection to lifecycle hooks to MCP. ## Concepts - [Workspaces & Worktrees](https://verne.build/docs/concepts/workspaces-and-worktrees/): How Verne tracks your repositories as workspaces and isolates agent work in git worktrees. - [Terminals, Tabs & Panes](https://verne.build/docs/concepts/terminals-tabs-panes/): How terminals, tabs, and split panes work in Verne, the surface where your agents run. - [Agents & Status](https://verne.build/docs/concepts/agents-and-status/): How Verne detects which agent is running in a terminal and tracks whether it's working, blocked, or idle. - [Persistent Sessions](https://verne.build/docs/concepts/persistent-sessions/): Why your terminals and agents keep running after you close Verne, and how sessions reconnect. ## Agents - [The Agents Panel](https://verne.build/docs/agents/agents-panel/): The Agents panel lists every running agent across your workspaces with live status, so you can track and switch between them without hunting through tabs. - [Hooks & MCP Setup](https://verne.build/docs/agents/hooks-and-mcp-setup/): How Verne integrates with agent lifecycle hooks and installs the MCP server to give agents notes and browser tools. - [Add Files to an Agent](https://verne.build/docs/agents/add-files-to-agent/): Two ways to hand a file or folder path to a running agent from the file explorer or the editor. - [Multi-Agent Workflows](https://verne.build/docs/agents/multi-agent-workflows/): How to run several agents at once across workspaces and worktrees without them stepping on each other. ## Editing - [File Explorer](https://verne.build/docs/editing/file-explorer/): A virtual file tree for browsing, creating, and managing files in the active workspace or worktree. - [Code Editor](https://verne.build/docs/editing/code-editor/): A Monaco-based editor with syntax highlighting, a TypeScript/JavaScript language server, and Markdown preview. - [Search](https://verne.build/docs/editing/search/): Full-text content search across the active workspace, with case sensitivity and glob filtering. - [Notes](https://verne.build/docs/editing/notes/): Per-workspace Markdown notes that you and your agents can read and write through the Verne MCP server. ## Source Control - [Changes & Commits](https://verne.build/docs/source-control/changes-and-commits/): How to stage files and write commit messages from the Source Control tab. - [Commit History](https://verne.build/docs/source-control/history/): How to browse the git log and inspect past commits in the Commits tab. - [Diff Viewer](https://verne.build/docs/source-control/diff-viewer/): How Verne displays file diffs and lets you add inline review comments on selected lines. - [Code Review](https://verne.build/docs/source-control/code-review/): How Verne collects diff comments and delivers them to your Review Agent as a structured task. ## Browser - [Embedded Browser](https://verne.build/docs/browser/embedded-browser/): A real Chromium browser built into the right panel, so you can keep your app open beside your code. - [Agent Browser Control](https://verne.build/docs/browser/agent-browser-control/): Agents can drive the embedded browser through the Verne MCP server, acting on the same tabs you see. ## Voice - [Voice Setup](https://verne.build/docs/voice/setup/): Configure on-device speech recognition so no audio ever leaves your machine. - [Using Dictation](https://verne.build/docs/voice/using-dictation/): How to start a dictation session and where Verne inserts the transcript. ## Reference - [Reference](https://verne.build/docs/reference/overview/): Complete reference for Verne's keyboard shortcuts, command palette, settings, MCP server, themes, and file locations. - [Keyboard Shortcuts](https://verne.build/docs/reference/keyboard-shortcuts/): Default keyboard shortcuts in Verne, grouped by category, with notes on how to override them. - [Command Palette](https://verne.build/docs/reference/command-palette/): The three command palette modes in Verne (unified, file search, and actions) and how to switch between them. - [Settings](https://verne.build/docs/reference/settings/): Every settings category in Verne, what each option controls, and where settings are stored. - [MCP Server](https://verne.build/docs/reference/mcp-server/): The tools Verne's MCP server exposes to agents, covering workspace notes and the embedded browser. - [Themes](https://verne.build/docs/reference/themes/): Built-in themes in Verne and how to add custom theme files. - [File Locations](https://verne.build/docs/reference/file-locations/): Where Verne keeps the CLI, your config, internal app data, and worktrees on disk. ## Guides - [Guides](https://verne.build/docs/guides/overview/): End-to-end walkthroughs for common tasks in Verne. - [Review an AI Diff](https://verne.build/docs/guides/review-an-ai-diff/): Review what an agent changed, annotate it with comments, and send it back for fixes. - [Isolate Work in a Worktree](https://verne.build/docs/guides/isolate-work-in-a-worktree/): Let an agent attempt a risky change on a separate branch without touching your working directory. - [Drive the Browser with an Agent](https://verne.build/docs/guides/drive-the-browser-with-an-agent/): Have an agent open your app in the embedded browser, interact with it, and verify a change. ## Help - [Troubleshooting](https://verne.build/docs/help/troubleshooting/): Fixes for common problems you may run into with Verne. - [FAQs](https://verne.build/docs/help/faqs/): Answers to common questions about Verne. ## Optional - [Changelog](https://verne.build/changelog/): New features, improvements, and fixes in each version of Verne.