File Locations
What lives where on your Mac.
CLI launcher
~/.local/bin/verne: the verne command. Run verne mcp to start the MCP server, or verne --help for other subcommands.
User data directory
~/.verne/ holds everything you configure:
| Path | Contents |
|---|---|
~/.verne/settings.json |
All preferences and keybinding overrides |
~/.verne/*.verne.json |
Custom theme files (appear in Settings › Appearance) |
~/.verne/worktrees/ |
Default root for new worktrees (configurable in Settings › Workspace) |
Internal app data
~/Library/Application Support/build.verne/ is Verne’s internal data store. You rarely need to touch it directly, but knowing the layout helps when debugging or clearing state:
| Path | Contents |
|---|---|
build.verne/db/ |
App database (workspace state, panel sizes, etc.) |
build.verne/sockets/ |
Unix sockets used by the daemon |
build.verne/logs/ |
Daemon and app logs |
build.verne/notes/ |
Notes storage, one directory per workspace |
build.verne/browser/ |
Browser-control state |
Worktrees root
New worktrees are created under ~/.verne/worktrees/ by default. Change this in Settings › Workspace › Worktrees root folder.
Next steps
- Settings: change the worktrees root and other preferences.
- Installation: how the CLI and app data directory are set up during install.