pagent

Pagent

CLI tool that orchestrates Claude Code agents to transform PRDs into specs and working code.

flowchart LR
    PRD[PRD.md] --> A[architect]
    A --> Q[qa]
    A --> S[security]
    Q & S --> I[implementer]
    I --> V[verifier]
    V --> O[outputs/]

    subgraph Specs
        A
        Q
        S
    end

    subgraph Code
        I
        V
    end

Quick Start

# Install
git clone https://github.com/tuannvm/pagent && cd pagent && make install

# Launch the interactive TUI
pagent ui

The TUI guides you through selecting a PRD, persona, and running agents:

 ██████╗  █████╗  ██████╗ ███████╗███╗   ██╗████████╗
 ██╔══██╗██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝
 ██████╔╝███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║
 ██╔═══╝ ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║
 ██║     ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║
 ╚═╝     ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝

 From idea to implementation, orchestrated.

 Input                       Persona
 > examples/sample-prd.md    > Balanced - Standard

 Output                      Action
 > ./outputs                 > ▶ Run

 ↑ up · ↓ down · / filter · enter select

Or use the CLI directly:

pagent run ./prd.md --sequential -v

Prerequisites

• Claude Code installed and authenticated
• Go 1.21+ (for building from source)

Installation

From releases: Download from GitHub Releases

From source:

git clone https://github.com/tuannvm/pagent
cd pagent
make install

Commands

Common Options

pagent run prd.md --agents architect,qa   # Run specific agents
pagent run prd.md --sequential            # Run in dependency order
pagent run prd.md --resume                # Skip up-to-date outputs
pagent run prd.md --output ./docs/        # Custom output directory
pagent run prd.md --persona minimal       # Use minimal persona

Agents

Configuration

Run pagent init to create .pagent/config.yaml. Key options:

• persona: minimal | balanced | production
• preferences: API style, testing depth, language
• stack: Cloud, database, CI/CD choices

See docs/tutorial.md for full config reference.

Documentation

Troubleshooting

"timeout waiting for agent" - Check claude --version, increase --timeout 600

"port already in use" - Run pagent stop --all

See docs/tutorial.md#troubleshooting for more.

Contributing

See CONTRIBUTING.md.

Roadmap

Currently supports Claude Code only. Coming next:

• Multi-LLM support - Gemini, Codex, AMP
• Simplified config - Fewer options, smarter defaults
• Better UX - Guided setup, clearer outputs

See full roadmap.

Acknowledgments

This project is built on AgentAPI by Coder - a brilliant HTTP wrapper for Claude Code that makes agent orchestration possible. Pagent wouldn't exist without it.

License

MIT