Quick Start - Pretorin CLI Documentation
Description: Documentation for the Pretorin CLI - compliance tools for developers and AI agents.

## 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

# Quick Start

After installing and authenticating, here are some common first steps.

## Browse Frameworks

List all available compliance frameworks:

    pretorin frameworks list

Get details on a specific control:

    pretorin frameworks control nist-800-53-r5 ac-02 --references

## Set Up Context

Set your active system and framework for platform operations:

    # Interactive selection
    pretorin context set

    # Or explicit
    pretorin context set --system "My Application" --framework fedramp-moderate

## Create Evidence

Create a local evidence file:

    pretorin evidence create ac-02 fedramp-moderate \
      --name "RBAC Configuration" \
      --description "Role-based access control in Azure AD"

Push evidence to the platform:

    pretorin evidence push

## Run an Agent Task

Use the Codex agent for compliance analysis:

    pretorin agent run "Assess AC-02 implementation gaps for my system"

Or use a predefined skill:

    pretorin agent run --skill gap-analysis "Analyze my system compliance gaps"

## Connect Your AI Tool via MCP

If you use Claude Code, Codex CLI, Cursor, or another MCP-compatible AI tool:

    # Claude Code
    claude mcp add --transport stdio pretorin -- pretorin mcp-serve

    # Then ask your AI agent about compliance
    # "What controls are in the Access Control family for FedRAMP Moderate?"

See the MCP Setup Guides for other tools.

## Run the Demo Walkthrough

An interactive demo script is included in the repository:

    bash scripts/demo-walkthrough.sh