The command-line tool
What the CLI does, why agents run on your computer, and what you need installed.
Fragua comes in two halves. The web app — where you're reading this — is where you plan, review, and watch. The command-line tool is what actually runs the agents, and it runs them on your own computer. This page explains how the two fit together and what you need set up.
Two halves, one workflow
Where you direct the work
Writing briefs and specs, reviewing and accepting them, watching runs and their cost — that all lives here. The web app decides what should happen next; it doesn't run the agents itself.
Where the work runs
A small program you install on your computer. It picks up the work the web app hands it, runs the agent right there on your machine, and streams the results back so you can follow along in the web app.
Directs the work and shows you each run and its cost.
Runs the agent through the CLI, with your Claude, git, and GitHub.
Billed straight to your account. Fragua is never in the path.
The web app hands off the work; your computer runs it and streams back only the activity and cost. Your code and credentials stay put.
Why it runs on your computer
Running the agents on your machine keeps the things that matter to you in your hands. Fragua never holds your AI key, never sits between you and your AI provider, and never copies your code to its servers — only the run's activity and cost come back so you can watch and review.
-
Your Claude sign-in — the agent uses the Claude already signed in on your computer, billed straight to your own account.
-
Your code — the working copy stays on your machine; Fragua doesn't store it.
-
Your GitHub access — branches and pull requests are pushed with your own GitHub sign-in, as you.
What you need on your computer
Before the tool can run anything, a few things need to be in place. As a developer you may already have most of them:
-
Claude Code — installed and signed in — this is what the agents actually run through.
-
git — for working with your repository.
-
The GitHub CLI — installed and signed in, so agents can push branches and open pull requests as you.
-
An agent token — generated in Settings — it connects the tool to your Fragua account.
You don't have to check these by hand — running fragua doctor confirms each one for you. Every command is covered in CLI commands.
Once a machine is connected, it shows up on your Agents page — where you can see it come online and manage it. See The Agents page.
See everything the tool can do, grouped by task.