proletariat-cli

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

夺取生产资料——交付速度提升 100 倍。

面向 AI 劳动力的 Agent 编排平台。 按需启动工作 Agent，处理各种任务。

主题化 Agent，包括亿万富翁——终于，他们为我们工作了。

⚠️ Beta 软件——正在积极开发中。不同版本之间的命令和 API 可能会发生变化，我们也在积极修复漏洞。

开始交付吧 预约通话——我很乐意帮你运行 prlt，或交流反馈、想法、多 Agent 工作流，以及工作的未来／劳动力（还有经济学中的劳动力理论……）

TLDR

prlt 是一个面向 AI 劳动力的 Agent 编排平台。按需启动工作 Agent，通过一个 CLI 协调多 Agent 开发。提供隔离的工作区、安全的容器和持久状态。

brew install chrismcdermut/proletariat/prlt    # macOS (Homebrew)
# or
npm install -g @proletariat/cli        # any platform (npm)

prlt new
prlt ticket create --title "Add OAuth" --category feature
prlt work spawn   # Interactive: select tickets, environment, action

Agent 会在自己的分支中启动、编写代码并创建 PR。你负责审查并合并。

为什么选择 prlt？

• 隔离——每个 Agent 都有自己的 git 分支，不会产生冲突。
• 安全——使用 Docker 容器，与宿主机隔离。
• 持久——Tmux 会话会持续运行。关闭窗口后，Agent 仍会继续工作。
• 可追踪——一个数据库、一个 CLI，管理你的所有 Agent。
• 临时——按需启动 Agent。它们完成工作、创建 PR，然后结束。
• 结构化——工单提供结构化上下文，而非自由聊天。
• 可持续——工单会随着时间累积上下文，方便在 Agent 之间交接。
• 原生支持 Agent——--json 模式让 AI Agent 以编程方式驱动 CLI。

快速入门

brew install chrismcdermut/proletariat/prlt  # Install (Homebrew, recommended)
# or
npm install -g @proletariat/cli              # Install (npm, all platforms)

prlt new                           # Create HQ, add repos, choose theme
prlt ticket create --title "Add OAuth" --category feature
prlt work spawn                    # Interactive: select tickets, environment, action
# Agent creates PR → You review → Merge → Done

sequenceDiagram
    participant You
    participant prlt
    participant Agent
    participant GitHub

    You->>prlt: prlt ticket create
    You->>prlt: prlt work spawn
    prlt->>prlt: Create branch
    prlt->>prlt: Create workspace
    prlt->>Agent: Spawn agent
    Agent->>Agent: Read ticket
    Agent->>Agent: Write code
    Agent->>GitHub: Commit
    Agent->>GitHub: Open PR
    Agent->>prlt: Update status
    prlt->>You: PR ready
    You->>GitHub: Review & approve

启动 Agent 来实现、整理或审查任务，而不只是编写代码。

交互式菜单

prlt work 会引导你选择项目和工单：

选择操作——启动单个 Agent、批量启动，或监控某一列：

选择要启动的工单，列表按优先级分组：

深入探究

安装

Homebrew（推荐）

brew install chrismcdermut/proletariat/prlt

支持 Apple Silicon（arm64）和 Intel（x86_64）Mac，无需编译器。

升级：

brew update
brew upgrade prlt

npm / pnpm（所有平台）

npm install -g @proletariat/cli
# or
pnpm install -g @proletariat/cli

pnpm 10+ 注意： pnpm 10 默认会阻止原生插件构建脚本。如果安装后 prlt 因原生模块错误而失败，请在全局存储中运行 pnpm approve-builds 并重新安装，或改用 npm / brew。

验证：

prlt --version

MCP 服务

prlt 内置了包含 100+ 个工具的 MCP 服务。将其添加到你的 AI 客户端：

Claude Code（~/.claude.json）：

{
  "mcpServers": {
    "prlt": { "command": "prlt", "args": ["mcp-server"] }
  }
}

Cursor / 其他客户端（通过 npx）：

{
  "mcpServers": {
    "prlt": { "command": "npx", "args": ["-y", "@proletariat/cli", "mcp-server"] }
  }
}

收录于：MCP 注册表 | npm

数据模型

Workspace (HQ)
├── Projects
│   ├── Epics → Tickets
│   └── (references a Workflow)
├── Workflows → Phases → Statuses (can be shared across projects)
├── Specs (can span projects)
├── Actions (reusable templates)
├── Agents
│   ├── Staff (persistent, named)
│   └── Temp (ephemeral, per-ticket)
└── Executions (running sessions)
    ├── Docker
    │   ├── Tmux session
    │   ├── Terminal or Background display
    │   └── Safe or YOLO permissions
    └── Host
        ├── Tmux session
        ├── Terminal or Background display
        └── Safe or YOLO permissions

工作流示例

工作流定义工单如何在你的流程中流转。项目会引用一个工作流，多个项目可以共享同一个工作流。

Kanban Workflow
├── Backlog       # New tickets land here
├── In Progress   # Agent working (prlt work spawn)
├── Review        # PR ready (prlt work ready)
└── Done          # Merged (prlt work complete)

Scrum Workflow
├── Backlog
├── Sprint
│   ├── To Do
│   ├── In Progress
│   └── In Review
└── Done

随着工作推进，工单会在不同状态之间流转。Agent 会在开始工作、创建 PR 或完成任务时自动移动工单。

工作区结构

每个 Agent 都会获得所有仓库的副本（即将支持仓库范围限定）。工作在隔离的分支上进行。

my-project/
├── .proletariat/
│   └── workspace.db              # Tickets, executions, state
├── repos/
│   ├── frontend/                 # Your repos
│   ├── backend/
│   └── infra/
└── agents/
    ├── staff/
    │   └── alice/                # Named agent with persistent workspace
    │       ├── frontend/
    │       ├── backend/
    │       └── infra/
    └── temp/
        ├── agent-abc123/         # Ephemeral: Working on TKT-042 (OAuth)
        │   ├── frontend/         # All repos on branch: feat/TKT-042-oauth
        │   ├── backend/
        │   └── infra/
        └── agent-def456/         # Ephemeral: Working on TKT-043 (API)
            ├── frontend/         # All repos on branch: feat/TKT-043-api
            ├── backend/
            └── infra/

Agent 命名主题

主题控制 Agent 的命名方式。常驻 Agent 直接使用主题名称（例如，bezos、camry）。临时 Agent 会在名称前添加形容词（例如，bold-bezos、keen-camry）。目前，临时名称还会添加数字后缀（bold-bezos-1），但很快就会移除。

内置主题：

billionaires ——他们终于为我们工作了。

主题命令：

prlt agent themes list              # List available themes
prlt agent themes set billionaires  # Set active theme
prlt agent themes create mytheme    # Create custom theme
prlt agent themes add-names mytheme # Add names to custom theme

在 prlt new 期间选择主题。

使用命令的三种方式

1. 交互式（人工）

不带标志运行，即可获取引导式提示：

$ prlt ticket create

? Title: Add password reset
? Description: Email-based password reset flow
? Priority: P1
? Category: feature

✓ Created TKT-043

使用 prlt ticket 查看工单详情：

2. JSON 模式（AI Agent）

添加 --json 以获取机器可读的输出：

$ prlt work start --json

{
  "prompt": {
    "type": "list",
    "message": "Select ticket to work on:",
    "choices": [
      {
        "name": "[P1] TKT-042 - Add user authentication",
        "value": "TKT-042",
        "command": "prlt work start TKT-042 --json"
      }
    ]
  }
}

AI Agent 会解析这些内容、做出选择并调用下一条命令。

3. 标志（脚本/CI）

直接传入所有内容：

prlt ticket create \
  --title "Add OAuth" \
  --description "Google and GitHub OAuth" \
  --priority P1 \
  --category feature

执行模式

环境——Agent 的运行位置：

显示方式——查看运行情况的方式：

权限——Agent 的访问级别：

所有会话底层都在 tmux 中运行——关闭窗口后，Agent 仍会继续工作。

# Default: Docker + terminal (if devcontainer exists)
prlt work start TKT-042

# Docker + background
prlt work start TKT-042 --display background

# Host + background (fast, no container)
prlt work start TKT-042 --run-on-host --display background

# Docker + YOLO (full autonomy, safely sandboxed)
prlt work start TKT-042 --skip-permissions

并行 Agent

同时处理多个工单。

交互式（人工）：

$ prlt work spawn

? Spawn mode: Select specific tickets
? Select tickets:
  ◉ [P1] TKT-042 - Add user authentication
  ◉ [P1] TKT-043 - Add API rate limiting
  ◯ [P2] TKT-044 - Add email notifications
? Action: implement
? Environment: docker

Spawning 2 tickets...

JSON 模式（AI Agent）： (多选功能开发中)

$ prlt work spawn --json --many

{
  "prompt": {
    "type": "checkbox",
    "message": "Select tickets to spawn:",
    "choices": [
      {"name": "[P1] TKT-042 - Add user authentication", "value": "TKT-042"},
      {"name": "[P1] TKT-043 - Add API rate limiting", "value": "TKT-043"}
    ]
  }
}

标志（脚本/CI）：

prlt work spawn TKT-042 TKT-043 --action implement --mode docker

每个 Agent 都在自己的分支上工作，不会发生冲突。

扩展能力： 主要限制因素是你的机器。可以同时运行 50 个以上的 Agent，具体取决于 CPU、RAM，以及使用 Docker 模式还是主机模式。

使用 prlt execution 监控正在运行的 Agent：

flowchart LR
    subgraph You
        spawn[prlt work spawn]
    end

    subgraph Agents
        A1[Agent 1<br/>TKT-042 OAuth]
        A2[Agent 2<br/>TKT-043 Rate Limit]
        A3[Agent 3<br/>TKT-044 Notifications]
    end

    subgraph GitHub
        PR1[PR #101<br/>feat/TKT-042-oauth]
        PR2[PR #102<br/>feat/TKT-043-rate-limit]
        PR3[PR #103<br/>feat/TKT-044-notifications]
    end

    spawn --> A1
    spawn --> A2
    spawn --> A3

    A1 --> PR1
    A2 --> PR2
    A3 --> PR3

Agent 创建的 PR 已准备好供审核：

命令参考

运行 prlt <command> --help 查看标志和选项。

使用场景

并行开发功能

# Create tickets for each feature
prlt ticket create --title "Add OAuth" --category feature
prlt ticket create --title "Add API rate limiting" --category feature
prlt ticket create --title "Add email notifications" --category feature

# Spawn all three in parallel (Docker for isolation)
prlt work spawn TKT-001 TKT-002 TKT-003 --mode docker

# Watch the board as they work
prlt board watch

三个 Agent、三个分支、三个 PR。由你审核并合并。

集中排查 Bug

# Spawn all bugs at once
prlt work spawn --all --column Backlog --category bug

# Or pick specific ones
prlt work spawn TKT-010 TKT-011 TKT-012

需求梳理会议

让 Agent 完善工单需求：

prlt work groom TKT-042

Agent 会添加验收标准、子任务和估算。

环境变量

Claude Code 通过 claude login 处理自身的身份验证。

要求

• Node.js 20+（推荐使用 22 LTS）
• Git
• Claude Code（使用 claude login 进行身份验证）
• SQLite
• Tmux（会话持久化）
• Docker（可选——用于隔离执行）

安装故障排除

bun install 在 better-sqlite3 上失败

症状：在构建 better-sqlite3 原生模块时，bun install -g @proletariat/cli 因 isexe 或 node-gyp 错误而失败。

原因：Bun 对 node-gyp 的兼容性有限。node-gyp 内部的 which 依赖项使用了 isexe，而它与 Bun 的运行时垫片不兼容。

解决方法：改用 npm 或 Homebrew：

# Option 1: Homebrew (macOS, recommended)
brew install chrismcdermut/proletariat/prlt

# Option 2: npm (all platforms)
npm install -g @proletariat/cli

# Option 3: pnpm
pnpm install -g @proletariat/cli

如果必须使用 Bun，请确保也安装了 Node.js 22（LTS），并将 better-sqlite3 设置为使用其预构建二进制文件：

npm rebuild better-sqlite3

npm EACCES: permission denied

症状：npm install -g @proletariat/cli 在 /opt/homebrew/lib/node_modules 或 /usr/local/lib/node_modules 上因 EACCES: permission denied 而失败。

解决方法：将 npm 配置为使用用户可写目录：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH="$HOME/.npm-global/bin:$PATH"
# Add the export line to your ~/.zshrc or ~/.bashrc
npm install -g @proletariat/cli

或者改用 Homebrew（macOS）：

brew install chrismcdermut/proletariat/prlt

安装后出现原生模块错误

症状：prlt 可以运行，但会因 better_sqlite3.node 或 ABI 不匹配错误而崩溃。

解决方法：

# Rebuild for the current Node version
npm rebuild better-sqlite3

# Verify it works
node -e "require('better-sqlite3')"

# If still failing, reinstall
npm install -g @proletariat/cli --force

更多详情，请参阅完整故障排除指南。

支持

• Discord：discord.gg/tmZyjNNSvw
• GitHub Issues：报告错误或请求功能
• 设置帮助：预约通话 - 我会帮你运行起来

许可证

Apache 2.0

在 GitHub 上点星 | 从 NPM 安装 | 报告问题

由无产阶级使用 ⚒️ 制作。