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

# Quickstart

> Get YesPaPa running in under 5 minutes

Get YesPaPa running in under 5 minutes. No remote server required — the Inner Ring (TOTP gate) works completely offline.

## Prerequisites

* Node.js 18+
* macOS or Linux (zsh or bash)
* A TOTP authenticator app (Google Authenticator, Authy, 1Password, etc.)

## Install

Choose your preferred method:

<Tabs>
  <Tab title="npm">
    ```bash theme={null}
    npm install -g yespapa
    ```

    Or run without installing:

    ```bash theme={null}
    npx yespapa init
    ```
  </Tab>

  <Tab title="Homebrew (macOS)">
    ```bash theme={null}
    brew tap yespapa-cli/yespapa
    brew install yespapa
    ```
  </Tab>

  <Tab title="apt-get (Debian/Ubuntu)">
    ```bash theme={null}
    # Add the YesPaPa repository (one-time setup)
    curl -fsSL https://yespapa-cli.github.io/homebrew-yespapa/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/yespapa.gpg
    echo "deb [signed-by=/usr/share/keyrings/yespapa.gpg arch=amd64] https://yespapa-cli.github.io/homebrew-yespapa/apt stable main" | sudo tee /etc/apt/sources.list.d/yespapa.list

    # Install
    sudo apt-get update
    sudo apt-get install yespapa
    ```
  </Tab>

  <Tab title="From source">
    ```bash theme={null}
    git clone https://github.com/yespapa-cli/yespapa.git
    cd yespapa
    npm install
    npm run build
    ```
  </Tab>
</Tabs>

## Initialize

```bash theme={null}
yespapa init
```

This will:

1. Generate a TOTP seed
2. Ask you to set a master key (for recovery)
3. Display a QR code — scan it with your authenticator app
4. Verify the TOTP code
5. Inject shell interceptors into your `.zshrc` / `.bashrc`
6. Start the daemon in the background

## Try It

Open a new terminal (or `source ~/.zshrc`) and try a dangerous command:

```bash theme={null}
rm -rf ./some-directory
```

YesPaPa intercepts it and prompts for your TOTP code:

```
🔒 YesPaPa — Command requires approval
   rm -rf ./some-directory
   Rule: destructive/rm-rf

Enter TOTP code: ______
```

Enter the 6-digit code from your authenticator. Approved commands execute normally. Denied commands are blocked.

## Check Status

```bash theme={null}
yespapa status
```

Shows daemon status, interceptor status, pending commands, and remote server connection.

## Optional: Mobile App Pairing

During `yespapa init`, say **Yes** when asked to pair with the mobile app. This enables:

* Push notifications on your phone when commands are intercepted
* One-tap approve/deny from the YesPaPa app
* Approve-with-message to send feedback to AI agents

The mobile app is always free — [download it at get.yespapa.app](https://get.yespapa.app). You can use the default hosted server or [self-host your own](/self-hosting).

## Add the AI Agent Skill

If you use Claude Code (or any tool that supports skills), add YesPaPa as a skill so your agent automatically knows how to work with intercepted commands:

```bash theme={null}
npx skills add https://docs.yespapa.io
```

This teaches the agent to include `--justification` on dangerous commands, parse approval/denial events, and follow approver feedback — no manual system prompt editing needed.

## Next Steps

* [Agent Integration](/agent-integration) — full agent integration guide
* [CLI Reference](/cli-reference) — all available commands
* [Architecture](/architecture) — how the daemon, interceptor, and remote server work
* [Self-Hosting](/self-hosting) — run your own remote server
* [Features](/features) — full feature overview