PAI Quick Reference Card

Last Updated: 2026-06-30
Version: 5.1.0
Print this page for desk reference


🚨 Emergency Commands

# System health
systemctl --user status pai-primary
systemctl --user status ollama
 
# Restart services
systemctl --user restart pai-primary
systemctl --user restart ollama
 
# Check logs
journalctl --user -u pai-primary -f
journalctl --user -u ollama -f
 
# Troubleshooting
bun ~/.claude/PAI/Tools/HealthCheck.ts

πŸ“Š Agent Loop Monitoring

# Start monitoring
bun ~/.claude/PAI/Tools/AgentLoopMonitor.ts start \
  --orchestrator "main" --pattern "research"
 
# Log iteration
bun ~/.claude/PAI/Tools/AgentLoopMonitor.ts iteration <loop-id> \
  --status success --tokens 1200
 
# End loop
bun ~/.claude/PAI/Tools/AgentLoopMonitor.ts end <loop-id>
 
# Dashboard
bun ~/.claude/PAI/Tools/AgentLoopDashboard/server.ts
# β†’ http://localhost:3000

πŸ’° Cost Tracking

# Record cost
bun ~/.claude/PAI/Tools/Cost.ts record \
  <session> <model> <in-tokens> <out-tokens>
 
# Daily report
bun ~/.claude/PAI/Tools/Cost.ts report --period daily
 
# Weekly report
bun ~/.claude/PAI/Tools/Cost.ts report --period weekly
 
# Session cost
bun ~/.claude/PAI/Tools/Cost.ts report --session <id>

πŸ“ Project Management

# Switch project
bun ~/.claude/PAI/Tools/ProjectManager.ts switch <project>
 
# Park project (save for later)
bun ~/.claude/PAI/Tools/ProjectManager.ts park <project>
 
# Resume project (restore context)
bun ~/.claude/PAI/Tools/ProjectManager.ts resume <project>
 
# List all projects
bun ~/.claude/PAI/Tools/ProjectManager.ts list
 
# Show active
bun ~/.claude/PAI/Tools/ProjectManager.ts active

🎯 Focus Management (ADHD)

# Start focus session
bun ~/.claude/PAI/Tools/FocusManager.ts start <task> \
  --energy high|medium|low
 
# Capture distraction (without breaking flow)
bun ~/.claude/PAI/Tools/FocusManager.ts capture "<thought>"
 
# Complete session
bun ~/.claude/PAI/Tools/FocusManager.ts complete
 
# View stats
bun ~/.claude/PAI/Tools/FocusManager.ts stats
 
# Resume interrupted session
bun ~/.claude/PAI/Tools/FocusManager.ts resume

βœ… Approval Gates

# One-time TOTP setup
bun ~/.claude/PAI/Tools/ApprovalGate.ts --setup
# β†’ Scan QR code with Google Authenticator
 
# Request approval (dual-factor)
bun ~/.claude/PAI/Tools/ApprovalGate.ts --request <slug> <action>
 
# Verify TOTP only
bun ~/.claude/PAI/Tools/ApprovalGate.ts --verify-totp <code>
 
# Check audit log integrity
bun ~/.claude/PAI/Tools/ApprovalGate.ts --verify-log

πŸ”— Cross-Domain Linking

# Detect patterns across files
bun ~/.claude/PAI/Tools/CrossDomainLinker.ts detect <file1> <file2> [...]
 
# Synthesize domains
bun ~/.claude/PAI/Tools/CrossDomainLinker.ts synthesize <domain1> <domain2>
 
# Run demo
bun ~/.claude/PAI/Tools/CrossDomainLinker.demo.ts

🧠 Memory & Knowledge

# Query memory
bun ~/.claude/PAI/Tools/MemoryQuery.ts "<query>"
 
# Harvest session
bun ~/.claude/PAI/Tools/SessionHarvester.ts
 
# Knowledge graph
bun ~/.claude/PAI/Tools/WikilinkGraph.ts generate
 
# Bulk index
bun ~/.claude/PAI/Tools/BulkIndexPAIUser.ts

🎬 Media & Content

# Monitor feeds
bun ~/.claude/PAI/Tools/FeedMonitor.ts check
 
# Process inbox
bun ~/.claude/PAI/Tools/InboxAutoProcessor.ts
 
# Media workflow
bun ~/.claude/PAI/Tools/MediaWorkflow.ts process <file>

πŸ” Troubleshooting Checklist

Service not running?

systemctl --user status <service>
systemctl --user start <service>
journalctl --user -u <service> -n 50

High cost?

bun ~/.claude/PAI/Tools/Cost.ts report --period daily
# Check for runaway loops

Lost context?

bun ~/.claude/PAI/Tools/ProjectManager.ts resume <project>
cat ~/.claude/PAI/MEMORY/STATE/projects-registry.json

Focus session interrupted?

bun ~/.claude/PAI/Tools/FocusManager.ts resume

Agent loop stuck?

# Check dashboard
bun ~/.claude/PAI/Tools/AgentLoopDashboard/server.ts
# β†’ http://localhost:3000

πŸ“‚ Key File Locations

# Configuration
~/.claude/settings.json                     # Main config
~/.claude/PAI/config/                       # PAI config
 
# State
~/MEMORY/STATE.claude/                      # State files
~/MEMORY/db/                                # Databases
 
# Logs
~/MEMORY/STATE.claude/agent-loops.jsonl     # Loop logs
~/MEMORY/STATE.claude/destructive-promotions.jsonl  # Approvals
 
# Projects
~/.claude/PAI/MEMORY/STATE/projects-registry.json   # Registry
<project-root>/.project/                    # Per-project state
 
# Documentation
~/.claude/PAI/DOCUMENTATION/INDEX.md        # Master index
~/.claude/PAI/DOCUMENTATION/                # All docs

πŸŽ›οΈ Service Status

# All services
systemctl --user list-units 'pai-*' 'ollama*'
 
# Individual status
systemctl --user status pai-primary
systemctl --user status ollama
systemctl --user status llamacpp-native
 
# Enable auto-start
systemctl --user enable pai-primary
systemctl --user enable ollama

πŸ“Š Performance Monitoring

# System health
bun ~/.claude/PAI/Tools/HealthCheck.ts
 
# GPU status
nvidia-smi
 
# Ollama models
ollama list
 
# Memory usage
free -h
 
# Disk space
df -h ~/MEMORY

πŸ”‘ Common Patterns

Start new project:

cd /path/to/project
bun ~/.claude/PAI/Tools/ProjectManager.ts switch "$(basename $PWD)"

Switch between projects:

bun ~/.claude/PAI/Tools/ProjectManager.ts list
bun ~/.claude/PAI/Tools/ProjectManager.ts switch <name>

Monitor long-running task:

LOOP_ID=$(bun ~/.claude/PAI/Tools/AgentLoopMonitor.ts start \
  --orchestrator "main" --pattern "research")
# ... do work ...
bun ~/.claude/PAI/Tools/AgentLoopMonitor.ts end $LOOP_ID

Focus session workflow:

# Morning
bun ~/.claude/PAI/Tools/FocusManager.ts start "Deep work" --energy high
 
# Distraction appears
bun ~/.claude/PAI/Tools/FocusManager.ts capture "Check email about X"
 
# After work
bun ~/.claude/PAI/Tools/FocusManager.ts complete
bun ~/.claude/PAI/Tools/FocusManager.ts stats

πŸ“ž Quick Help

Full documentation:

less ~/.claude/PAI/DOCUMENTATION/INDEX.md

Tool help:

bun ~/.claude/PAI/Tools/<Tool>.ts --help

Skills:

ls -1 ~/.claude/skills/*/SKILL.md

Current session:

echo $CLAUDE_SESSION_ID

🎯 Philosophy Reminders

Projects:

Unfinished projects are exploration, not failure.
Context-switching is a feature, not a bug.

Focus (ADHD):

ADHD isn’t a bug β€” it’s a different operating system.
Work WITH attention patterns, not against them.

Costs:

Route to cheapest capable resource.
Claude tokens are the scarcest resource.

Approval:

Dual-factor for all destructive operations.
Audit trails are tamper-evident by design.


Print Date: $(date +β€œ%Y-%m-%d”)
Version: PAI 5.1.0
Engine: PNK (OpenCode)