Integrations

Proletariat integrates with your existing tools so agents can pull issues, create PRs, and sync status without leaving the CLI.

GitHub

GitHub integration powers PR creation, code review, and repository management. Proletariat uses the gh CLI under the hood.

Setup

# Login to GitHub CLI
$ prlt gh login

# Check status
$ prlt gh status

Features

  • Automatic PR creation when agents finish work
  • PR templates with ticket context and acceptance criteria
  • Repository creation and management

Note

For Docker agents, use prlt gh token to set up GH_TOKEN inside the container.

Linear

Import issues from Linear directly into your Proletariat board and start agents on them.

Setup

# Authenticate with Linear
$ prlt linear auth

# Connect to your Linear workspace
$ prlt linear connect

# Check connection status
$ prlt linear status

Usage

# Sync Linear issues into Proletariat tickets
$ prlt linear sync

# Import specific issues
$ prlt linear import ENG-123

# Start work directly from a Linear issue
$ prlt work linear ENG-123

Jira

Pull Jira issues and spawn agents on them:

# Start work from a Jira issue
$ prlt work jira PROJ-456

Work Sources

Configure default work sources to streamline spawning:

# Set Linear as the default work source
$ prlt work source set --provider linear --team ENG

# Now prlt work spawn pulls from Linear automatically
$ prlt work spawn --from-linear --count 5
SourceDescription
linearLinear issues synced into Proletariat tickets
jiraJira issues imported on demand
asanaAsana tasks imported on demand
shortcutShortcut stories imported on demand

MCP Server

Proletariat exposes a Model Context Protocol (MCP) server so external AI tools can interact with your workspace:

# Start the MCP server
$ prlt mcp-server

The MCP server allows any MCP-compatible client to read tickets, move cards on the board, check agent status, and more — enabling deeper integrations with AI assistants and custom tooling.