# Connect your coding agent to Drafty

Drafty turns a doc, plan, spec or prototype into a link your team can comment on —
they click the exact element and leave a note, Figma-style — and your agent reads
those comments and pushes a new version to the same link.

This page is the setup guide. If you are an agent reading this, follow it top to
bottom. If you are a human, you can run the same commands yourself.

## 1. Install the plugin

Run these in a terminal:

```sh
claude plugin marketplace add drafty-im/drafty
claude plugin install drafty@drafty-im
```

## 2. Ask your human to reload

This step is theirs, not yours. Ask them to run `/reload-plugins` in Claude Code
(or restart it). That switches the plugin on and puts the `drafty` command on
PATH. Wait for them to confirm before you carry on.

## 3. Sign in

```sh
drafty login
```

This blocks until your human finishes in the browser, so give it a long timeout — up to three
minutes. If your shell times out first, do not blindly re-run it: check `drafty doctor` to see
whether the login already landed.

This opens a browser and hands the session back to the CLI. If your human does not
have a Drafty account yet, the same flow makes one — an email and a code, no
password. If they already signed in on drafty.im, still run `drafty login`: it is
what gives this machine its token. Either order works.

Confirm it is wired up:

```sh
drafty doctor
```

## 4. Push their first canvas

Take something real from this session — a plan, a spec, a README, an HTML page —
and push it:

```sh
drafty canvas push <file> --title "<title>"
```

The command prints a https://drafty.im/canvas/<slug> link. Give them that link and tell them:
open it, click any element, leave a comment. Then say "address the canvas comments"
and you will pull the feedback and push a new version to the same link.

## Notes

- No token or credential belongs in a pasted prompt. `drafty login` authenticates
  on your human's own machine.
- The `drafty` skill ships inside the plugin, so once it is on, plain language
  works: "drafty this file".
- Human help and how-tos: https://drafty.im/kb