docs / configuration
Configuration
Everything configurable, in one place.
Server environment variables
| Variable | Default | Meaning |
|---|---|---|
| PORT | 3002 | Port the server listens on. |
| AUTH_REQUIRED | false | Require login for the web app and API. |
| VIBETREE_USERNAME | Username when auth is enabled. | |
| VIBETREE_PASSWORD | Password when auth is enabled. | |
| VIBETREE_PROJECTS_ROOT | Directories the server browser and repo discovery may list, comma separated. | |
| SESSION_IDLE_TIMEOUT_MS | 86400000 | Idle time before a session is cleaned up. Default 24 hours. |
Project config
.vibetree/config.json lives in your repository and is safe to commit:
{
"agentCommand": "claude"
}The agent command gets a one click launch button in every terminal of the project, and vibetree run uses it as the default agent.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
| Cmd/Ctrl+Shift+K | New worktree |
| Cmd/Ctrl+Shift+E | Toggle the Changes view |
| Cmd/Ctrl+Alt+Up/Down | Previous or next worktree |
| Cmd/Ctrl+B | Toggle the sidebar (desktop) |
| ? | Show shortcuts (web) |