---
title: FAQ
description: Common questions about agents, worktrees, GitHub, and Metaphor workflows.
sidebar:
  label: FAQ
  order: 0
---

<Accordion>
  <AccordionItem title="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](/handoff), Metaphor can also commit and push the changes and
    create a pull request.

  </AccordionItem>

  <AccordionItem title="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.

  </AccordionItem>

  <AccordionItem title="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.

  </AccordionItem>

  <AccordionItem title="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](/worktree).

  </AccordionItem>

  <AccordionItem title="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.

  </AccordionItem>

  <AccordionItem title="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](/handoff).

  </AccordionItem>

  <AccordionItem title="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](/checks).

  </AccordionItem>

  <AccordionItem title="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.

  </AccordionItem>

  <AccordionItem title="Do you store my code?">
    No. Metaphor doesn't store your repository code.

    Your repository and task worktrees remain on your machine.

  </AccordionItem>

<AccordionItem title="I don't see my agent in the list. What should I do?">
  Email [subhajit@withmetaphor.com](mailto:subhajit@withmetaphor.com) or ask in
  [Discord](https://discord.gg/fkCa2kaCMQ).
</AccordionItem>

<AccordionItem title="Is Windows or Linux supported?">
  Not yet. Metaphor currently supports macOS on Apple Silicon. [Join the
  waitlist](https://tally.so/r/xXdk1d) for Linux and Windows.
</AccordionItem>

  <AccordionItem title="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](/slack).

  </AccordionItem>
</Accordion>