roughdraftlisted
Install: claude install-skill moiri-gamboni/roost
# Roughdraft
A local Markdown review app. You open one `.md` file, the user reads it in a browser and leaves comments and suggested changes, clicks **Done Reviewing**, and you read their feedback back out of the same file and reply in it. The Markdown file on disk is the only state — there is no separate review database.
The user may call it `rd`. That is shorthand in conversation only: never create a shell alias, executable, symlink, or command named `rd`.
When the user asks for a plan, write the plan to disk as Markdown first, then open it. Do not paste a plan into chat and ask for comments.
## Open a document and wait
```bash
roughdraft open "/absolute/path/to/file.md"
```
Run this with `run_in_background: true`. The command blocks until the user clicks Done Reviewing, and that exit is your signal to resume — backgrounding it keeps the process alive across turns and re-invokes you when it exits, instead of dying on a tool timeout. **Never interrupt, kill, or "tidy up" the waiting process.**
`roughdraft open` starts the server if it is not already running. The server is global and long-lived on port 7373; it does not need starting per document, and there is no systemd unit. What *is* per document is the waiter: each `open` registers one, and if it dies the page stays live and the user's click still queues server-side, but nothing is listening. Re-attach by opening the file again.
One file at a time — opening a second document replaces the first in the UI.
## Give t