> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payback.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# payback init

> Set up this machine; the same as running payback with no arguments.

## Usage

```text theme={null}
                                                                                                    
 Usage: payback init [OPTIONS]                                                                      
                                                                                                    
 Set up payback on this machine. Safe to re-run — it completes whatever isn't done yet.             
                                                                                                    
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --url                             <str>   upload endpoint (defaults to the built-in one)         │
│                                           [env var: PAYBACK_UPLOAD_URL]                          │
│                                           [default: https://upload.payback.sh]                   │
│ --settings                        <path>  Claude Code settings.json (default                     │
│                                           ~/.claude/settings.json)                               │
│ --codex-hooks                     <path>  Codex $CODEX_HOME/hooks.json (default                  │
│                                           ~/.codex/hooks.json)                                   │
│ --no-timer       --no-no-timer            skip installing the background upload timer            │
│                                           [default: no-no-timer]                                 │
│ --ref                             <str>   invite code from your install link                     │
│                                           [env var: PAYBACK_REF]                                 │
│ --email                           <str>   sign up with this email (when you have no invite)      │
│                                           [env var: PAYBACK_EMAIL]                               │
│ --no-past                                 don't offer to upload past sessions                    │
│                                           [env var: PAYBACK_NO_AGENT]                            │
│ --help                                    Show this message and exit.                            │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

```

`payback init` is the setup wizard, and `payback` with no arguments runs exactly the same thing. Re-run it any time: it offers any sessions not yet uploaded, turns on passive income where it isn't on yet, rewrites hooks that need it, and otherwise shows what's on and exits.

[Setup](https://docs.payback.sh/setup.md) describes each screen.

## Examples

```bash theme={null}
payback            # setup, or a two-line summary when nothing is new
payback init --no-past   # skip the past-sessions step
```


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