Troubleshooting & FAQ

FAQ

Yes. Pane is open-source under the AGPL-3.0 license. There is no paid tier, no usage limits, and no account required.

Any CLI agent works — if it runs in a terminal, it runs in Pane. Built-in support (dedicated panel, token tracking, session resume) is available for Claude Code and OpenAI Codex CLI. See the Quick Starts section for setup guides.

No. Pane is an agent manager, not an IDE. It orchestrates agents working in git worktrees alongside your existing editor. Open the same project in VS Code, Zed, or Neovim — Pane and your editor coexist on the same files.

Session history is stored in ~/.pane/pane.db (SQLite). Application config (settings, shortcuts, project list) is stored in the OS-standard config path: macOS — ~/Library/Application Support/Pane/ Windows — %APPDATA%\Pane\ Linux — ~/.config/Pane/ Nothing leaves your machine. Pane makes no outbound requests except to GitHub’s API to fetch the latest release version for update checks.

Go to Settings → Updates → Check Now. If an update is available, click Download and Install.Alternatively, re-run the install script from the Download page — it installs over the existing version.

Yes. Toggle Use Worktrees off in the New Pane dialog. The agent runs in your main working tree instead of an isolated branch. Useful for repos where worktree setup is impractical (large monorepos with complex setups).

Common Issues

Pane requires git to be installed and available on your PATH. Install git from git-scm.com , then restart Pane. On macOS, xcode-select --install also provides git.

The agent binary isn’t on the PATH Pane sees. Go to Settings → Advanced → Additional PATH and add the directory containing your agent binary (e.g., /usr/local/bin or ~/.local/bin). Restart Pane after saving.

Stale worktree references can block new worktree creation. Run this in your repo root:git worktree pruneThen retry creating the pane. If the error persists, check that you have write access to the directory and that the branch name doesn’t already exist.

Pane binaries are not yet universally code-signed. macOS — Open System Settings → Privacy & Security and click Open Anyway next to the Pane entry. One-time step. Windows — Click More info → Run anyway on the SmartScreen prompt. Code signing is in progress. See Known Issues below.

Restart Pane. Sessions and project config are preserved — nothing is lost. If the freeze recurs on a specific project, check the terminal for errors before restarting.If the issue is reproducible, open a bug report at github.com/Dcouple-Inc/Pane/issues with steps to reproduce.

Known Issues

Unsigned releases — Builds are not code-signed on all platforms yet. OS security warnings (Gatekeeper, SmartScreen) appear on first launch. Code signing is in progress.
Git history graph — The git history panel is read-only. Click-to-diff on individual commits is not yet implemented.
runScriptMode: nonconcurrent — Pane detects this setting in pane.json but does not enforce it yet. The run script always starts concurrently regardless of the value.

Track progress and report new issues at github.com/Dcouple-Inc/Pane .