FAQ

General

What is Fabriq?

Fabriq is a desktop app that sits between you and an AI coding agent (OpenCode or Claude Code). It gives you full visibility and control over the agent's work — every change requires your confirmation, and everything is logged.

Is Fabriq an IDE?

No. Fabriq is not an IDE. It's a desktop shell that orchestrates AI agents. You still use your regular editor (VS Code, Neovim, etc.) to browse and edit code.

What AI agents does Fabriq support?

Currently OpenCode and Claude Code. Both connect via the Agent Client Protocol (ACP).

Is Fabriq free?

Fabriq is open source under the MIT license. You can use it, modify it, and distribute it freely.

Setup

Can I use Fabriq without an AI agent?

Yes. You can connect a workspace and browse your project without setting up an agent. You just won't be able to create AI-assisted features.

Do I need an API key?

Only if you're using a cloud AI agent that requires one. Local agents may not need API keys.

Can I use Fabriq with any project?

Any project with a git repository works. Fabriq doesn't require a specific framework or language.

Workflow

Can I run multiple features at once?

Yes. Each feature gets its own isolated worktree. You can switch between them freely.

What happens if the agent breaks my code?

The agent works in an isolated git worktree. Your main branch is never touched until you review and approve the changes. If something goes wrong, you can undo any action.

Can I stop a feature mid-way?

Yes. Close the workbench and the agent stops automatically. You can resume later or cancel the feature entirely.

Security

Does Fabriq send my code anywhere?

No. All files stay on your local machine. Fabriq communicates with the AI agent via a local process. The agent's API calls go to the LLM provider you've configured (if using a cloud service).

Is my conversation with the agent private?

Agent conversations are local to your machine. In the future, Fabriq may offer conversation sharing (opt-in), but it will never send your code or conversations anywhere without your explicit consent.

Troubleshooting

Why won't my agent connect?

Make sure the agent is installed and on your PATH
Try running the agent directly in your terminal
Restart Fabriq
Check Settings → Agent to verify the correct agent is selected

For more help, see Troubleshooting.