Everything below is optional.

pane.json

Drop a pane.json in your project root to automate setup, dev server, and cleanup.


{
  "scripts": {
    "setup": "npm install",
    "run": "npm run dev",
    "archive": "npm run cleanup"
  }
}

setup — runs once when a new worktree is created
run — runs when you press Play
archive — runs before a pane is deleted

Pane auto-detects config files in this priority order:

pane.json
conductor.json (setup → start)
.gitpod.yml (init → command)
devcontainer.json (postCreateCommand → postStartCommand)

Project Settings

Open via the gear icon next to any project in the sidebar.

System Prompt — instructions prepended to every agent session. Repo-specific rules, coding style, context.
Main Branch — defaults to main. Change if you use staging or develop.
Run Script — override pane.json from the UI.

Notifications

On by default. You get alerted the moment an agent finishes or needs input.

Settings → Notifications — toggle sound, status changes, waiting, and completion alerts individually.

Worktree File Sync

Gitignored files like .env are automatically copied into every new worktree. Your pane is ready to run the moment it’s created — no missing credentials, no manual copying.

Worktree File Sync3 files synced

📄.env

📄.env.local

📄.env.development

📁node_modules/

📄.DS_Store

Click to toggle — synced files are copied into every new worktree

Files sync on worktree creation only. Updates to .env after creation require re-creating the pane or manually copying. Only gitignored files are synced — committed files are handled by git. Configure in Settings → General → Worktree File Sync.