## Keyboard shortcuts

Press `←` or `→` to navigate between chapters

Press `S` or `/` to search in the book

Press `?` to show this help

Press `Esc` to hide this help

# Configuration

The `config` command group manages CLI configuration stored at `~/.pretorin/config.json`.

## List Configuration

    $ pretorin config list
              Pretorin Configuration
    ┏━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
    ┃ Key     ┃ Value           ┃ Source      ┃
    ┡━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
    │ api_key │ 4MAS****...9v7o │ config file │
    └─────────┴─────────────────┴─────────────┘

    Config file: /home/user/.pretorin/config.json

## Get a Config Value

    pretorin config get api_key

## Set a Config Value

    pretorin config set api_base_url https://custom-api.example.com/api/v1

## Show Config File Path

    $ pretorin config path
    /home/user/.pretorin/config.json

## Config File Format

The config file is JSON:

    {
      "api_key": "pretorin_...",
      "api_base_url": "https://platform.pretorin.com/api/v1/public",
      "platform_api_base_url": "https://platform.pretorin.com/api/v1/public",
      "model_api_base_url": "https://platform.pretorin.com/api/v1/public/model",
      "active_system_id": "sys-abc123",
      "active_system_name": "My Application",
      "active_framework_id": "nist-800-53-r5",
      "disable_update_check": false
    }

## Configuration Keys

Key | Description
--- | ---
`api_key` | Pretorin API key
`api_base_url` | Platform REST API URL
`platform_api_base_url` | Platform API base URL
`model_api_base_url` | Model API URL for agent runtime
`openai_api_key` | Optional model key for agent runtime
`active_system_id` | Currently active system ID
`active_system_name` | Cached display name for the active system
`active_framework_id` | Currently active framework ID
`disable_update_check` | Disable passive update notifications

## Environment Variable Overrides

Environment variables take precedence over config file values. See Environment Variables for the full list.