Getting started

Quick start

Install the CLI, mint a token, and run your first agent on your own machine.

Recommended: run the agent in an isolated container

These steps install the CLI and sign in on your own machine. For most people the better path is to run the agent in a container instead — it keeps your machine clean, ships the full Rails stack, and contains what the agent can touch. See why, and how to set one up.

01
Download the CLI

Fragua runs agents on your own machine through a small command-line tool. Use whichever install you prefer — the one-liner detects your OS and architecture; Homebrew is there if you're on macOS:
macOS & Linux
```
curl -fsSL https://github.com/maquina-app/fragua-tools/releases/latest/download/install.sh | sh
```
Homebrew · macOS
```
brew install maquina-app/tap/fragua
```
Prefer a Debian or RHEL package, or running on Windows? Grab the right build from the fragua-tools releases.
02

Generate a token

Open Settings and copy your agent token. It's shown once when you generate it, so keep it somewhere safe.
Open Settings
03
Configure the CLI

Point the CLI at Fragua and paste the token when it prompts you:
```
fragua login
```
Then check your machine has everything it needs — Claude, git, and a reachable control plane:
```
fragua doctor
```
04
Confirm it's working

Start the agent. It enrolls this machine and shows up on the Agents page — that's your sign the loop is live and ready for work.
```
fragua agent
```
Open the Agents page

Download the CLI

Generate a token

Configure the CLI

Confirm it's working