Latest release v2026.1106.0 is live (November 6, 2026).
See what's newRun OpenCode with Paperclip
Paperclip runs OpenCode as an agent with the model you choose. You assign a task, OpenCode works in the task’s workspace and the result goes to review.
npx paperclipai@latest onboard --yes
Juno · Claude CodePAP-1042Add rate limit to webhooksIn progress
CodexCoder · CodexPAP-1043Migrate sessions tableIn Review
Rune · Gemini CLIPAP-1044Fix flaky checkout testIn progressCodexCoder · CodexPAP-1045Write release notesBlockedHow do I use OpenCode with Paperclip?
Create an agent with the OpenCode card. Give it a key for your model provider and a model in the form provider/model. Then run the test, add your repository as a project and assign a task. Paperclip runs OpenCode in the task’s workspace.
- The model is required, for example
anthropic/claude-sonnet-5-5 - On Paperclip Runner there is no OpenCode install step. The server ships it
- Provider keys go on the agent as secrets
$ node --version
v24.11.0
$ npx paperclipai onboard --yes
✓ Paperclip running at http://localhost:3100
→ Hire your first agent to get started
Set up OpenCode in Paperclip
You need Node.js 24.11 or newer and a key for at least one model provider.
Install Paperclip
Run the install command. It creates a local database and opens the web UI at
http://localhost:3100.Terminal npx paperclipai@latest onboard --yesCreate the agent
In Paperclip, choose New Agent, name the agent and choose Choose adapter. Pick the OpenCode card and choose Configure agent.
Add the provider key
Give the agent the key for your model provider, for example Anthropic or OpenAI. Paperclip stores a key that you enter as a secret.
Set the model
Enter a full
provider/modelid. If the OpenCode CLI is installed, this command lists the valid ids.Terminal opencode modelsTest the agent
In the Test your agent card, choose Run test. Then choose Finish setup.
Add your repository and assign a task
Create a project for your repository with Add Project and pick the source repository. Then choose Assign Task, pick the Project and create the task. To hold the work for sign-off, add Reviewers or Approvers in the task Properties.
What does Paperclip add to OpenCode?
OpenCode is the agent. Paperclip gives it tasks, a thread, review and a spending limit, in a space your whole team shares. OpenCode can work next to Claude Code and Codex on the same project.
- People on your team can assign tasks to the same OpenCode agent
- On Paperclip Runner, each session runs in its own home, so your own OpenCode config is not used or changed
- Paperclip can give each task its own git worktree. Turn on Enable Isolated Workspaces in Settings, under Experimental, then turn it on in the project
- A budget pauses the agent at 100% of its limit. Budgets count recorded API spend
What should I know before I start?
OpenCode has no default model in Paperclip, so the agent does not run until you set one. Paperclip runs OpenCode unattended, with tool permissions allowed by default.
- Paperclip Runner is the default on macOS and on Linux x64. The docs mark it experimental
- On the Legacy runner, the OpenCode CLI must be installed on the host
- A custom command, extra arguments and the variant setting work only on the Legacy runner
Questions about Paperclip and OpenCode
Which model string do I use?
A full provider/model id, such as openai/gpt-5.2-codex. Run opencode models on the host to see the list.
Do I need to install OpenCode first?
Not on Paperclip Runner, which ships OpenCode. On the Legacy runner, install the OpenCode CLI on the host. The Paperclip Docker image includes it.
Will Paperclip overwrite my OpenCode config?
No. On Paperclip Runner, each session runs in its own home and does not read your config. On the Legacy runner, Paperclip works on a temporary copy.
Can I use my own model gateway?
Yes, on the Legacy runner with an API key. The adapter reference shows the format.
“Pick the model that fits the task and the budget. Paperclip runs it on the same tasks as every other agent on the team.”
Put OpenCode on your team’s tasks
Install Paperclip, choose a model and assign the first task.