Proletariat

by chrismcdermut (community) · Claude Desktop, Claude Code, OpenCode, macOS, Linux, npm

MCP MCP Servers Open Source v0.3.134 · 06.05.2026 активный

Оркестрация агентов как рабочей силы для любого проекта — ускорение доставки в 100 раз.

v0.3.134
06.05.2026 current

Установка
# 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
показать оригинал переведено ИИ

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

Захвати средства производства — шипи в 100 раз быстрее.

npm MCP Registry Лицензия

Платформа оркестрации агентов для ИИ-труда. Запускайте воркеров под любую работу — по требованию.

Тематические агенты, включая миллиардеров — наконец-то они работают на нас.

⚠️ Бета-версия — Проект находится в активной разработке. Команды и API могут меняться между версиями, баги активно исправляются.

Поможем вам начать шипить [Записаться на звонок][cal-link] — С радостью помогу запустить prlt или обсудить фидбек, идеи, мультиагентные воркфлоу и будущее работы/труда (и экономическую теорию труда..)


Кратко

prlt — платформа оркестрации агентов для ИИ-труда. Запускайте воркеров по требованию, координируйте мультиагентную разработку из одного CLI. Изолированные рабочие пространства, безопасные контейнеры, персистентное состояние.

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

Агент создаётся в собственной ветке, пишет код, открывает PR. Вы ревьюите и мержите.

Почему prlt?

  • Изолированность — Каждый агент получает собственную git-ветку. Никаких конфликтов.
  • Безопасность — Docker-контейнеры, изолированные от вашей хост-машины.
  • Надёжность — Tmux-сессии сохраняются. Закройте окно — агент продолжает работать.
  • Отслеживаемость — Одна база данных, один CLI, все ваши агенты.
  • Эфемерность — Запускайте агентов по требованию. Они работают, открывают PR, и всё готово.
  • Структурированность — Тикеты дают структурированный контекст, а не свободный чат.
  • Персистентность — Тикеты накапливают контекст со временем. Передавайте работу между агентами.
  • Агентоориентированность — Режим --json позволяет ИИ-агентам управлять 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

Запускайте агентов для реализации, груминга или ревью — не только для написания кода.

Интерактивные меню

prlt work проведёт вас через выбор проекта и тикетов:

Выбор проекта

Выберите операцию — запустить одного агента, пакетный запуск или наблюдать за колонкой:

Меню операций

Выберите тикеты для запуска, сгруппированные по приоритету:

Выбор тикетов


Подробный разбор

Проблема Решение
Агенты конфликтуют из-за изменений друг друга Изолированность — Каждый агент получает свою git-ветку и worktree
Агенты работают без песочницы на вашей машине Безопасность — Docker-контейнеры, изолированные от вашей хост-машины (изучаем варианты песочницы на уровне хоста)
Вы теряете представление о том, кто чем занят Отслеживаемость — Всё состояние в одной базе SQLite, один CLI
Сессии умирают при закрытии окна Надёжность — Tmux-сессии сохраняются, отключайтесь/переподключайтесь в любое время
Контекст разбросан по окнам чатов Структурированность — Тикеты с требованиями и критериями приёмки
Запуск агентов слишком тяжеловесный Эфемерность — Запуск по требованию: работают, открывают PR, и всё готово
Контекст теряется между запусками агентов Персистентность — Тикеты накапливают контекст, передавайте работу между агентами

Установка

Homebrew (рекомендуется)

brew install chrismcdermut/proletariat/prlt

Работает как на Mac с Apple Silicon (arm64), так и на Intel (x86_64). Компилятор не нужен.

Обновление:

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 включает встроенный MCP-сервер со 100+ инструментами. Добавьте его в свой 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 Registry | 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

Тикеты проходят через статусы по мере выполнения работы. Агенты автоматически перемещают тикеты, когда начинают работу, открывают PR или завершают задачи.

Структура рабочего пространства

Каждый агент получает копию всех репозиториев (ограничение по репозиториям появится позже). Работа ведётся в изолированных ветках.

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/

Темы именования агентов

Темы управляют тем, как называются агенты. Штатные агенты используют имена из темы напрямую (например, bezos, camry). Временные агенты добавляют префикс-прилагательное (например, bold-bezos, keen-camry). Сейчас временные имена также включают числовой суффикс (bold-bezos-1), но вскоре он будет удалён.

Встроенные темы:

Тема Описание Примеры имён
billionaires Основатели и руководители техкомпаний (по умолчанию) musk, gates, bezos
toyotas Модели автомобилей Toyota camry, supra, tacoma
companies Крупные технологические компании stripe, vercel, linear

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-агентов)

Добавьте --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-агенты разбирают этот вывод, делают выбор и вызывают следующую команду.

3. Флаги (скрипты/CI)

Передавайте всё напрямую:

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

Режимы выполнения

Окружение — где запускается агент:

Окружение Флаг Лучше всего подходит для
🐳 Docker (по умолчанию, если есть devcontainer) Безопасность — полностью изолированный контейнер
🏃 Хост --run-on-host Скорость — без накладных расходов контейнера

Отображение — как вы это видите:

Отображение Флаг Лучше всего подходит для
📺 Терминал --display terminal Наблюдение в новой вкладке терминала
🔇 Фон --display background Работает отдельно, можно подключиться позже

Разрешения — уровень доступа агента:

Режим Флаг Описание
🔒 Безопасный (по умолчанию) Агент запрашивает разрешения
🕺 YOLO --skip-permissions Без запросов, полный доступ. Используйте с Docker для безопасной автономности.

Все сессии под капотом работают в tmux — закройте окно, агент продолжит работу.

# 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

Параллельные агенты

Работа над несколькими тикетами одновременно.

Интерактивный режим (для людей):

$ 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-режим (для ИИ-агентов): (мультивыбор — в разработке)

$ 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

Каждый агент работает в своей собственной ветке. Никаких конфликтов.

Масштабирование: Главное ограничение — ваша машина. 50+ одновременных агентов вполне достижимо — зависит от CPU, RAM и того, работаете ли вы в Docker или в режиме хоста.

Отслеживайте запущенных агентов с помощью prlt execution:

Список выполнений

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

Созданные агентами PR, готовые к ревью:

Пулл-реквесты GitHub

Справочник команд

Полный справочник команд (нажмите, чтобы развернуть)

```html
Пространство имёнКомандаОписание
ticketprlt ticket createСоздать новый тикет
prlt ticket listПоказать все тикеты
prlt ticket view Просмотреть детали тикета
prlt ticket edit Редактировать тикет
prlt ticket move Изменить статус
prlt ticket delete Удалить тикет
prlt ticket complete Отметить тикет завершённым
prlt ticket bulkМассовые операции с тикетами
prlt ticket link block Связать блокирующий тикет
prlt ticket link relates Связать связанный тикет
workprlt work start Запустить агента на тикете
prlt work spawnПакетный запуск тикетов
prlt work complete Отметить работу выполненной
prlt work ready Отметить как готовое к ревью
prlt work revise Запросить доработку
prlt work watchНаблюдать за прогрессом работы
executionprlt execution listСписок запущенных агентов
prlt execution logs Просмотреть вывод агента
prlt execution stop Остановить агента
agentprlt agent listСписок всех агентов
prlt agent status Проверить статус агента
prlt agent shell Зайти в shell рабочего пространства агента
prlt agent visit Перейти в рабочее пространство
prlt agent login Авторизовать Claude в контейнере
prlt agent rebuild Пересобрать рабочее пространство агента
prlt agent restart Перезапустить агента
prlt agent staff add Добавить именованных агентов
prlt agent staff listСписок штатных агентов
prlt agent temp listСписок временных агентов
prlt agent temp cleanupУдалить временных агентов
темы агентаprlt agent themes listСписок доступных тем
prlt agent themes set Установить активную тему
prlt agent themes create Создать пользовательскую тему
prlt agent themes add-namesДобавить имена в тему
доскаprlt boardПросмотр канбан-доски
prlt board watchОбновления в реальном времени
проектprlt project createСоздать проект
prlt project listСписок проектов
prlt project view Просмотр деталей проекта
prlt project archive Архивировать проект
prlt project unarchive Разархивировать проект
prlt project delete Удалить проект
действиеprlt action createСоздать шаблон действия
prlt action listСписок действий
prlt action show Показать детали действия
prlt action run Запустить действие
prlt action update Обновить действие
prlt action delete Удалить действие
веткаprlt branch createСоздать ветку
prlt branch listСписок веток
prlt branch validateПроверить имя ветки
PRprlt pr createСоздать pull request
prlt pr status Проверить статус PR
prlt pr link Привязать PR к тикету
GitHubprlt gh loginВойти в GitHub
prlt gh statusПроверить статус аутентификации
prlt gh tokenПолучить токен GitHub
репозиторийprlt repo add Добавить репозиторий
prlt repo listСписок репозиториев
prlt repo view Просмотр деталей репозитория
prlt repo remove Удалить репозиторий
Dockerprlt docker listСписок контейнеров
prlt docker statusПроверить статус Docker
prlt docker start Запустить контейнер
prlt docker stop Остановить контейнер
prlt docker restart Перезапустить контейнер
prlt docker logs Просмотр логов контейнера
prlt docker shell Открыть shell в контейнере
prlt docker sync Синхронизировать файлы контейнера
prlt docker cleanУдалить остановленные контейнеры
prlt docker pruneУдалить неиспользуемые ресурсы
сессияprlt session listСписок активных сессий tmux
prlt session attach Подключиться к сессии tmux
рабочее пространствоprlt initИнициализировать конфигурацию машины
prlt newСоздать новое рабочее пространство HQ
prlt workspace listСписок рабочих пространств
prlt workspace addДобавить рабочее пространство
prlt workspace use Переключить рабочее пространство
Войдите, чтобы оставить комментарий