Connecting AI Agents
Choose and connect your AI coding agent backend — OpenCode or Claude Code.
Fabriq works by communicating with an AI coding agent through ACP (Agent Communication Protocol) — a stdio JSON-RPC bridge. You install an agent on your machine, configure it in Fabriq, and the bridge handles the rest.
One agent process, multiple Fabriq UI surfaces. The agent writes files in the worktree, Fabriq surfaces every action for your approval.
Which agent should I use?
| OpenCode | Claude Code | |
|---|---|---|
| Cost | Free (open source) | Paid (Anthropic API) |
| Setup | npm/pnpm install | Install CLI + API key |
| Capabilities | Full feature set | Full feature set |
| Best for | Teams that want open-source control | Teams already using Claude ecosystem |
| Languages | Any (language-agnostic) | Any (language-agnostic) |
Both agents work identically from Fabriq's perspective — the ACP protocol abstracts the backend. Choose whichever fits your workflow and budget.
How to connect
The connection flow is the same for both agents:
- Install the agent on your machine (see setup guides below)
- Verify the agent CLI works (run
opencode --versionorclaude --version) - Configure in Fabriq: Settings → Agent → Select your agent
- Connect: Fabriq starts the agent as a subprocess via ACP
When connected, you'll see:
Agent: OpenCode v2.1.0 ● ConnectedWhat the connection enables
Once connected, the agent can:
- Read and write files in the feature worktree
- Run terminal commands
- Use git operations
- Access project context you've injected
- Respond to your questions and direction
All actions are validated, displayed for your review, and require your confirmation before execution.
Quick troubleshooting
| Problem | Check |
|---|---|
| Agent not appearing in dropdown | Is it installed? Run <agent> --version in terminal |
| Connection refused after selecting | Does the CLI work outside Fabriq? Try running <agent> manually |
| Agent connects but then disconnects | Check for version incompatibility. Update both Fabriq and the agent |
| Actions seem slow | Agent processing time varies. Check the activity log for progress |
Next steps
- OpenCode Setup — install and configure OpenCode
- Claude Code Setup — install and configure Claude Code
- Injecting Context — give your agent the project knowledge it needs
- Working with the Agent — guide the agent during a feature
Last updated on