FAQ
Common questions about agents, worktrees, GitHub, and Metaphor workflows.
Which parts of the workflow are autonomous?
You choose the repository and coding agent for a task. Metaphor runs the agent, tracks its work, and verifies the result.
With Handoff, Metaphor can also commit and push the changes and create a pull request.
Which coding agents can I use?
Metaphor currently works with Claude Code and Codex. You continue using the agent CLIs and subscriptions you already have.
Pull request review tools such as CodeRabbit or Greptile can also provide feedback that Metaphor sends back to an agent to resolve.
Can I switch agents during a task?
Yes. You can continue a task with another agent without starting over.
The next agent continues from the task’s existing worktree and the context Metaphor has already gathered.
Does each task get its own worktree?
Yes. Each task gets its own Git worktree, keeping its changes separate from your main checkout and other tasks.
If you continue the same task, Metaphor keeps using the same worktree. See Worktrees.
Can I work on the agent's changes locally?
Yes. You can open the task’s worktree in your editor or IDE to run, test, or modify the agent’s work.
Changes you make there appear in the task’s diff, and the agent can continue working from them.
What happens when Handoff is on?
Metaphor verifies the agent’s work, then commits and pushes the changes and creates a pull request.
Metaphor doesn’t merge the pull request. You still review and merge when you’re ready. See Handoff.
What are checks?
Checks define what Metaphor verifies before an agent’s work is ready.
With Handoff on, Metaphor creates checks based on your task. You can also add your own checks for requirements you want Metaphor to verify explicitly. See Checks.
When is a worktree removed?
Worktrees aren’t removed automatically when a task finishes or its pull request is merged.
When you no longer need a task’s worktree, archive the task in Metaphor. Archiving removes the worktree and the task from your sidebar.
Do you store my code?
No. Metaphor doesn’t store your repository code.
Your repository and task worktrees remain on your machine.
I don't see my agent in the list. What should I do?
Email subhajit@withmetaphor.com or ask in Discord.
Is Windows or Linux supported?
Not yet. Metaphor currently supports macOS on Apple Silicon. Join the waitlist for Linux and Windows.
How do I start a task from Slack?
Mention @Metaphor in Slack with your prompt and repository. If Metaphor
can’t determine which repository to use, it asks you to choose one.
See Slack.