![\"Duality](\"DI_logo_light.png\"){kind=logo}
\n \n\n \n \n \n
A native OpenCode engineering team with human oversight.
\n\nClone runs a task as a small engineering organization:\n\n- an **IC** researches, implements, and verifies the work;\n- a **Manager** reviews the actual repository state and assigns the next step;\n- **you** answer only genuine product decisions.\n\nYou are the **Skip-Level Manager**: set the goal, then step back. The Manager\nhandles planning, assignments, and review while the IC does the hands-on work.\nYou are brought back only for genuine product decisions, completion, or aborts.\n\n```mermaid\nflowchart LR\n You([\"You - Skip-Level Manager\"]):::human\n\n subgraph worktree [\"isolated worktree ยท agent loop\"]\n direction LR\n Manager[\"Manager - plan, assign & review\"]:::ai\n IC[\"IC - research, implement & verify\"]:::ai\n Manager <-->|\"assign / report\"| IC\n end\n\n You <-->|\"goals / decisions\"| Manager\n\n classDef human fill:#1f6feb,stroke:#1158c7,color:#ffffff;\n classDef ai fill:#8250df,stroke:#6639ba,color:#ffffff;\n style worktree fill:transparent,stroke:#8b949e,stroke-dasharray:5 5;\n```\n\n๐ฆ **You** (human) ยท ๐ช **Manager** and **IC** (AI agents)\n\n## Requirements\n\n- [OpenCode](https://opencode.ai/)\n- [Bun](https://bun.sh/) 1.3 or newer\n- Git\n- macOS or Linux\n\n## Install\n\n```bash\nbunx @dualityinstitute/clone-ai@latest install\n```\n\nThe installer globally installs the `clone` CLI with Bun and adds\n`@dualityinstitute/clone-ai` to the existing global OpenCode plugin array\nwithout replacing unrelated settings. It removes only stale cached Clone plugin\ncopies so OpenCode resolves the newly installed release on restart. Restart\nOpenCode after installation. OpenCode installs npm plugins with Bun on startup.\n\n## Start a run\n\nInside the OpenCode TUI:\n\n```text\n/clone Fix the login redirect and verify it\n```\n\nClone creates two child sessions and an isolated worktree:\n\n```text\nYour OpenCode session\nโโโ Clone IC\nโโโ Clone Manager\n```\n\nIt also opens the owner process's authenticated local Clone Control dashboard\nin the default browser. `/clone-worktree` opens the same dashboard after\nstarting its run.\n\nOpenCode may not show custom-tool child sessions as inline cards. In the TUI,\nuse `Ctrl+X`, then `Down` to open the child Clone chat. Use `Left`/`Right` to\nswitch between IC and Manager, and `Up` to return to the parent session.\n\nThe Manager receives the task first. It keeps the run in planning until it has\na concrete implementation plan, then directs the IC. The main OpenCode client\nreceives notifications only for human decisions, completion, abort, or failure.\n\nTo start another task in an existing worktree instead of creating a new\nworktree:\n\n```text\n/clone-worktree