Setup

Setup runs at the end of the install script, and again whenever you run payback with no arguments. It only asks about what is new or undecided: after the first run, a machine with nothing new to upload and hooks already on shows two lines and exits.

​

1. Sign in with GitHub

Setup opens your browser; you authorise payback on GitHub and come back. payback asks for your profile and email only (the read:user and user:email scopes), never for repository access. The machine gets its own token, kept in ~/.payback/config.toml.

​

2. Open-source sessions

Setup reads the sessions your agents already saved, works out which repository each ran in, asks our server which of those repositories are public on GitHub, and lists the sessions on public ones, newest first. Sessions on private repositories, or outside a repository, are not listed and never leave your machine.

• Upload for review queues every listed session; they upload in the background.
• Skip uploads nothing. payback upload offers the same list any time, with a picker.

Sessions already uploaded are not offered again; a later run says so and moves on.

​

3. Passive income

• Turn on for all public repos writes the public policy to ~/.payback/allow: every public GitHub repository you work in, now and later, is recorded. This is the default, and what the setup bonus asks for.
• Choose repos lets you tick repositories; only those are written, by name.
• Not now installs nothing.

Turning it on installs a hook in each supported agent found on the machine, starts the background uploader, and tells the server which agents sync. Agents lists what each hook is; Codex and Cline need one step from you, which the close points out.

​

The close

The last screen lists only what is left to do (for example, approving Codex’s hooks once with /hooks) and, while the setup bonus is open, its three conditions. Then it opens your account page.