Quick Start¶

Get Perspt running in 5 minutes.

Prerequisites¶

Rust 1.82+	rustup.rs for building from source
API Key	From any provider (OpenAI, Anthropic, Google, etc.) OR Ollama for local models

Installation¶

From Source (Recommended)

git clone https://github.com/eonseed/perspt.git
cd perspt
cargo build --release

Cargo Install

cargo install perspt

With Ollama (No API Key)

# Install Ollama
brew install ollama  # macOS

# Start and pull a model
ollama serve
ollama pull llama3.2

Set Your API Key¶

# Choose your provider
export OPENAI_API_KEY="sk-..."        # OpenAI
export ANTHROPIC_API_KEY="sk-ant-..." # Anthropic
export GEMINI_API_KEY="..."           # Google

Run Your First Chat¶

# Start the TUI
./target/release/perspt

# Or with a specific model
perspt chat --model gpt-5.2

Type your message and press Enter. Press Esc to exit.

Try Agent Mode¶

Added in version 0.5.0.

Let Perspt autonomously write code:

# Basic task
perspt agent "Create a Python calculator with add, subtract, multiply, divide"

# With workspace directory
perspt agent -w ./my-project "Add unit tests for the API"

# Auto-approve all changes
perspt agent -y "Refactor the parser for better error handling"

The SRBN engine will:

Sheafify — Decompose task into sub-tasks
Speculate — Generate code for each sub-task
Verify — Check with LSP and tests
Converge — Retry until V(x) < ε
Commit — Record in Merkle ledger

Choose Your Mode¶

Mode	Command	Best For
Chat TUI	`perspt` or `perspt chat`	Interactive conversations with markdown rendering
Agent	`perspt agent "<task>"`	Autonomous code generation and modification
Status	`perspt status`	Check current agent session status

Essential Commands¶

# Configuration
perspt config --show           # View current config
perspt config --edit           # Edit in $EDITOR
perspt init --memory --rules   # Initialize project

# Agent management
perspt status                  # Current session status
perspt abort                   # Cancel current session
perspt resume                  # Resume interrupted session

# Change tracking
perspt ledger --recent         # View recent changes
perspt ledger --rollback abc   # Rollback to commit