Quickstart

Six steps from zero to governed shipping.

Deep references live on piii.mintlify.app. This page is the shortest viable path to production.

Install Pi CLI
The ladder

Install → Auth → Learn → Architect → Ship → Govern

  1. Step 01 · 壱

    Install

    Hokage Edition wizard or direct npm.

    Terminal
    $ npm i -g pi-hokage|
    → installs @pi-api/cli + wizard
    ✓ pi is on your PATH

  2. Step 02 · 弐

    Authenticate

    Save your Pi API key (from the dashboard).

    Terminal
    $ pi auth-login|
    → paste key, saved to ~/.config/pi
    ✓ authenticated

  3. Step 03 · 参

    Learn the repo

    Capture your codebase DNA (imports, style, secrets redacted).

    Terminal
    $ pi learn --with-graph|
    ✓ .pi/system-style.json written

  4. Step 04 · 肆

    Architect first

    Run a Staff-Engineer session before you type code.

    Terminal
    $ pi resonate "add Stripe checkout" --plan|
    ✓ .pi-plan.md (6 steps)

  5. Step 05 · 伍

    Import a routine

    Pick a template from /templates and import it.

    Terminal
    $ pi routine import stripe-checkout-flow|
    ✓ routine landed in .pi/routines/

  6. Step 06 · 六

    Govern

    Validate, fix, watch, and wire CI — one flag each.

    Terminal
    $ pi flow full-check|
    ✓ learn · validate · fix · doctor
Deep references

Everything else lives on Mintlify

Long-form, versioned, searchable. We link directly to the pages that matter.

Commands reference

All pi-cli commands with flags and examples.

Architecture

Inside the Sharingan, Rasengan, and Omni-router.

Capabilities

The 15 ninjutsu pi-cli ships today.

Conversational UX

How the NL omni-router and session-learning work.

Mastra architecture

Workflows, feature flags, polling.

Task tracking

Task trees, pi resume vs pi trace.

VCS support

Adapters: Git, Perforce, host-labeled Git.

File-management

Cloud vs CLI writes, .pi/ layout, IDE handoff.

CI templates

GitHub / GitLab / Circle workflow generators.