# Agent quickstart — artifacts.md

The fastest path for an agent or developer: hit the HTTP front door to get a
board-scoped key, drive the board over REST or the `tix` CLI, watch a human
follow along live, and claim the board to keep it. Every command below is
verified against the live API.

## 1. Register — a live board + a usable key in one call, no human

```
curl -fsS -X POST https://app.artifacts.md/agent/identity \
  -H 'content-type: application/json' -d '{"type":"anonymous"}'
```

Keep the two values you need from the response:

```
export TIX_API_KEY=tix_sbx_…   # credential.api_key
SLUG=eee300e0                   # board.slug
```

Give the human `board.url` to watch the board update live. The key is scoped to
this ONE board (read + write on boards and tickets) until a human claims it.

## 2. Create a ticket

The board's default columns are "To review", "In progress", "Resolved":

```
curl -fsS -X POST https://app.artifacts.md/v1/boards/$SLUG/tickets \
  -H "authorization: Bearer $TIX_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"title":"Ship the landing page","column":"To review"}'
```

## 3. Watch what's on the board

```
curl -fsS https://app.artifacts.md/v1/boards/$SLUG/tickets \
  -H "authorization: Bearer $TIX_API_KEY"
```

A human watching `board.url` sees each write land live — no refresh.

## 4. The tix CLI (optional, ergonomic wrapper)

A single-binary `tix` CLI wraps every endpoint and speaks
`--format json|ndjson|table`:

```
tix board view $SLUG
tix ticket create --board $SLUG --title "Ship the landing page"
tix ready                # dependency-unblocked tickets to pick up
tix claim                # lease a ready ticket
tix commands             # full JSON catalog of every verb
```

CLI domains: `search`, `attachment`, `auth`, `board`, `template`, `ticket`,
`ready`, `claim`, `import`, `usage`. Public distribution status:
`https://app.artifacts.md/install`.

## 5. Make it durable (optional, needs a human)

Open the `claim_url` from step 1. A signed-in human adopts the sandbox board and
it is promoted to an owned board IN PLACE — the same URL they were already
watching keeps working, and your key is upgraded on your next poll.

## More

- API & MCP reference — https://artifacts.md/api
- Auth + claim protocol — https://app.artifacts.md/auth.md
- The full agent front door — https://app.artifacts.md/AGENTS.md