# payback

> payback records your coding-agent sessions on open-source repositories, turns the good ones into RL environments, and pays you for each one that is licensed.

- [Introduction](https://docs.payback.sh/index.md): What payback is, how you get paid, and what happens after you install it.
- [Install](https://docs.payback.sh/install.md): Install the payback CLI on macOS or Linux and run the one-minute setup.
- [Setup](https://docs.payback.sh/setup.md): What payback asks on each setup screen, and what each answer changes on your machine.
- [What is recorded](https://docs.payback.sh/recording.md): Exactly what payback captures for a turn, and at the end of a session, in a recorded repository.
- [What is never recorded](https://docs.payback.sh/never-recorded.md): Secrets, private repositories, anything outside a repository, and what we redact.
- [Which repositories are recorded](https://docs.payback.sh/repositories.md): The allow-list policy (public, named, every), exclusions that always win, the visibility check before upload, and the payback allow command.
- [Where a session goes](https://docs.payback.sh/pipeline.md): The states a session moves through after upload, from received to licensed.
- [Getting paid](https://docs.payback.sh/getting-paid.md): What a licensed session pays, the setup bonus, when payouts go out, and the payout methods.
- [Claude Code](https://docs.payback.sh/agents/claude-code.md): Hooks in Claude Code's settings; nothing to do after setup.
- [Codex](https://docs.payback.sh/agents/codex.md): Hooks in Codex's hooks.json; approve them once with /hooks.
- [Cursor](https://docs.payback.sh/agents/cursor.md): Hooks in ~/.cursor/hooks.json; nothing to do after setup.
- [Gemini CLI](https://docs.payback.sh/agents/gemini-cli.md): Hooks in ~/.gemini/settings.json; nothing to do after setup.
- [GitHub Copilot CLI](https://docs.payback.sh/agents/copilot-cli.md): A hook file under ~/.copilot/hooks/; restart Copilot CLI once.
- [Cline](https://docs.payback.sh/agents/cline.md): Hook scripts in ~/Documents/Cline/Hooks; switch Hooks on in Cline's settings.
- [Pi](https://docs.payback.sh/agents/pi.md): An extension in ~/.pi/agent/extensions/; nothing to do after setup.
- [OpenCode](https://docs.payback.sh/agents/opencode.md): A plugin in ~/.config/opencode/plugins/; needs opencode 2.0 or newer.
- [aider](https://docs.payback.sh/agents/aider.md): Past sessions only: aider's history files are read by setup and payback upload.
- [CLI reference](https://docs.payback.sh/cli/index.md): Every payback command, with its exact usage on the command's page.
- [payback init](https://docs.payback.sh/cli/init.md): Set up this machine; the same as running payback with no arguments.
- [payback status](https://docs.payback.sh/cli/status.md): What's on: agents, sessions, the bonus, updates.
- [payback upload](https://docs.payback.sh/cli/upload.md): Upload past coding-agent sessions on open-source repositories for review.
- [payback allow, on and off](https://docs.payback.sh/cli/allow.md): Which repositories payback records: the policy, named repositories, exclusions.
- [payback pause and resume](https://docs.payback.sh/cli/pause-resume.md): Stop capturing for a while, then start again.
- [payback payouts](https://docs.payback.sh/cli/payouts.md): Set up where we pay you (Stripe), or manage it once it's set up.
- [payback delete](https://docs.payback.sh/cli/delete.md): Delete one capture locally and tell the server to forget it.
- [payback login](https://docs.payback.sh/cli/login.md): Sign this machine in with GitHub, or with an invite or machine code.
- [payback add-machine](https://docs.payback.sh/cli/add-machine.md): Get a one-hour code that adds another machine to your account.
- [payback update](https://docs.payback.sh/cli/update.md): Update the payback CLI to the latest release.
- [payback logout](https://docs.payback.sh/cli/logout.md): Sign this machine out. Recording stops until you sign in again.
- [payback uninstall](https://docs.payback.sh/cli/uninstall.md): Remove the hooks from every agent and the background timers.
- [Files on your machine](https://docs.payback.sh/data/files.md): What lives under ~/.payback and what each file is for.
- [Product analytics](https://docs.payback.sh/data/analytics.md): What the CLI and the website report about how you use payback, what they never contain, and how to turn it off.
- [Deleting your data](https://docs.payback.sh/data/deleting.md): How to delete a capture, stop recording, uninstall, and remove everything we hold.
- [Privacy](https://docs.payback.sh/data/privacy.md): The short version of what payback collects and shares, with a link to the full policy.
- [FAQ](https://docs.payback.sh/faq.md): Answers to the questions open-source maintainers ask most.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.