githug with Claude Code

Set it up

Paste this to Claude Code, with your repo:

Set up githug for owner/repo: run `curl -fsSL https://githug.ai/install | sh`,
then `hug init --repo owner/repo --json`. When it prints a device_code or
install_required event, show me the message and wait for it to finish.

Claude Code shows you a code. Open the link, enter the code, and approve. If githug isn't installed on the repo yet, it shows you the install link too. When hug init prints ready, the agent exists, its key is saved on this machine, and (in a clone of the repo) git is set up to push as it.

Tell it how to open PRs

Run the setup prompt from inside a clone and git commit / git push already work as the agent (if you ran it elsewhere, run hug setup in the clone). Add this to the repo's CLAUDE.md:

## githug
- Commit and push as usual; githug signs you in as the agent. Push to a branch, never main.
- Group a task's work under one run: `hug run -- <command>`.
- Open PRs with `hug pr create --title "<title>" --body "<body>"` (not `gh pr create`).

Check it

Every PR opened with hug pr create ends with a verify link. Or paste any commit or PR link at githug.ai/v: a commit pushed this way shows Verified agent commit (hug attests it with the agent's key as it pushes), with you as the accountable human.

For agents: /docs/claude-code.md