Skip to main content
Peter Parker is the agent orchestrator. It manages the nightly improvement loop, runs individual agents, creates PRs, and handles strategic reasoning.

Commands

Daily Loop

jfl peter daily
Full nightly orchestration: mine tuples → synthesize context → strategic reasoning → run agents → pick up issues. Typically run via cron at 2 AM.

Agent Management

# List all configured agents
jfl peter agent list

# Run a specific agent
jfl peter agent <name> --rounds <N>

# Run all agents (swarm mode)
jfl peter agent swarm --rounds <N>

# Create a new agent interactively
jfl peter agent create

PR Mode

# Create a branch, make changes, open a PR
jfl peter pr --task "Fix the auth token refresh bug"

Other Commands

jfl peter status                # Show status + recent events
jfl peter dashboard             # Live event stream
jfl peter telemetry             # Run telemetry agent
jfl peter synthesize            # Regenerate product context
jfl peter sentinel              # Run sentinel nightly review
jfl peter metrics               # Show current platform metrics

Options

FlagDescription
--costCost-optimized model routing (haiku-heavy)
--balancedBalanced model routing (default)
--qualityQuality-first model routing (opus-heavy)
--budget <amount>Cost budget in USD (auto-downgrades when exceeded)
--piForce Pi runtime
--rounds <N>Number of rounds (for agent/autoresearch)

Examples

# Run test-coverage for 10 rounds with cost optimization
jfl peter agent test-coverage --rounds 10 --cost

# Run the full nightly loop with $20 budget cap
jfl peter daily --budget 20

# Create a PR to fix a specific issue
jfl peter pr --task "GitHub #42: Fix login redirect loop"

# Run all agents in quality mode
jfl peter agent swarm --rounds 5 --quality