FAQ

Why macOS 26 or newer?

Supacode currently targets macOS 26.0+ and is implemented as a native SwiftUI app with GhosttyKit.

Where are worktrees stored?

Managed worktrees live under ~/.supacode/repos/<repository-name>/.

Do I need the GitHub CLI?

Only for GitHub features. Core repository, worktree, and terminal workflows work without gh.

Can I use bare repositories?

Yes. Supacode supports bare repositories, but copy-ignored and copy-untracked creation flags are disabled there.

What agents are supported?

Any terminal-based agent that can run in a shell works well in Supacode, including Codex, Claude Code, Opencode, Aider, and similar tools.

How do I start an agent automatically?

Put the agent command in the repository setup script. New worktrees can launch that script automatically after creation.

How do I theme the terminal?

Supacode respects Ghostty's config. Adjust terminal appearance in ~/.config/ghostty/config.

What is the difference between archive and delete?

Archive hides a worktree from the active list but keeps it on disk. Delete removes the worktree directory and can also remove the local branch depending on your settings.

How do I get meaningful branch names?

Enable prompted worktree creation, rename from the toolbar, or teach your agent to rename the branch before it starts.

Where should I report a bug?

Open an issue at github.com/supabitapp/supacode/issues.