Configuration & hooks

Plexus works with zero configuration, but a few settings and hooks let you tailor it to your workflow.

Settings

Open settings with ⌘,. Configure your default agent, base branch naming, worktree location, and the icon/theme preferences.

Project config

Drop a .plexus.toml at a repo root to set per-project defaults:

[session]
agent = "claude-code"
base_branch = "main"
branch_prefix = "agent/"

[worktrees]
dir = ".plexus/wt"

Hooks

Hooks run shell commands around a worktree's lifecycle — setup, run, and teardown. Use them to install dependencies when a worktree is created, prepare the environment before the agent runs, or clean up when it's removed. Edit them in .plexus/hooks.json, or set them up visually in Settings → Hooks with no file editing.

{
  "create": "pnpm install",
  "run": "cp .env.example .env",
  "teardown": "docker compose down"
}

Theme

Plexus ships light and dark as equal peers and follows your system preference by default. Toggle it from the title bar or with the theme switch in settings — the same control you'll find in the top-right of this site.