Open-source CLI · Workers are AI agents

Install an AI team into any repository.

wrkrs is a CLI that adds a small development team to your existing codebase. Each worker is an AI agent with a clear role, the right expertise, and approval rules you control.

$npx wrkrs initSee what the CLI installs

colin@MacBook-Pro zerro % npx wrkrs init

┌

wrkrs v0.1.0

│

◇

Git worktree resolved

│

SmartScaleAI/Zerro

│

◇

Project detected

│

Swift · GitHub Actions

│

◇

Claude Code configuration detected

│

CLAUDE.md · .claude/settings.json · 3 existing agents

│

◇

Worker roster proposed

│

Product Manager · Product Designer · Software Engineer · QA Engineer

│

Software Engineer specialization: macOS / Swift

│

◇

Installation plan (no files changed)

│PRESERVECLAUDE.md

│PRESERVEexisting .claude configuration

│ADD.wrkrs/config.yaml

│ADD.wrkrs/schema.json

│ADD.wrkrs/manifest.json

│ADD.wrkrs/roles/*.md

│ADD.claude/agents/wrkrs-*.md

│ADD.claude/skills/wrkrs/SKILL.md

│

Apply these changes? (y/N) y

◇

Preconditions rechecked

◇

Configuration written

◇

Claude Code adapter installed

◇

Ownership manifest recorded

└

Installation complete

colin@MacBook-Pro zerro % npx wrkrs check

✓

Configuration valid

✓

Worker roles valid

✓

Claude Code adapter valid

✓

Ownership manifest valid

└

Ready. Open Claude Code and start with the Product Manager worker.

colin@MacBook-Pro zerro %

Command-line installerWorkers = AI agentsOne engineer roleMany specialized instances

How the CLI works

From existing repo to a team of workers.

Workers are simply AI agents configured with a role, expertise, tools, and guardrails. wrkrs sets them up and gets out of the way.

colin@MacBook-Pro your-repository % npx wrkrs init

┌wrkrs v0.1.0

◇ Repository detected

│ Next.js · TypeScript · GitHub

◇ Claude Code detected

│ 2 existing agents found

└ Preparing team configuration…

Run it inside your repo.

The CLI detects your stack, current Claude setup, and available project tools.

colin@MacBook-Pro your-repository % npx wrkrs init --dry-run

INSTALL PLAN

KEEPCLAUDE.md

REUSE.claude/agents/swift-engineer.md

MERGE.claude/settings.json

ADD.wrkrs/

? Apply these changes? (y/N)

Review every change.

wrkrs shows exactly what it will add, merge, preserve, or reuse before touching files.

✻Claude Code~/code/your-repository

›

/wrkrs:feature Add search to history

✦

Product Manager worker

I’ll inspect the repository and prepare a plan before implementation.

Loaded from repository.wrkrs/team.yaml

Keep using Claude Code.

Start features inside your existing coding agent. Claude runs the workers defined in your repo.

Not another platform

No dashboard. No new workspace. No proprietary runtime.

wrkrs configures workers; it does not host or replace your coding agent. Your code stays in Git, your work stays in Claude Code, and your project data stays in the tools you already chose.

01Install

Add the team safely.

The CLI inspects your repository, explains every change, and preserves the Claude agents and configuration you already have.

02Configure

Workers are plain text.

Worker roles, specializations, tools, workflows, and approval rules live in readable files versioned with Git.

03Run

Stay in your coding agent.

Keep using Claude Code locally or in the cloud. Claude runs each worker as an AI agent; wrkrs supplies the team structure.

The worker model

Workers are AI agents, organized like a small development team.

Roles define responsibility. Specializations add expertise. Worker instances perform the work. Claude Code runs the agents underneath.

wrkrs termWorker

Under the hoodAI agent

Project contextRole + expertise

Example task crew4 active workers · 4 AI agents

Worker · AI agentProduct ManagerPlans, delegates, and coordinates handoffs

Coordinating

starts only the engineer workers this task needs

worker-01AI agent

Software EngineermacOS · Swift

Owns the native app changes.

worker-02AI agent

Software EngineerWeb · TypeScript

Owns the web experience.

worker-03AI agent

Software EngineerBackend · Supabase

Owns the service changes.

One Software Engineer role. As many workers as the task needs.Each instance shares the same responsibility, receives only the context relevant to its assignment, and can run in parallel when the work is independent.

Product Manager worker

Plan

Clarifies the outcome, chooses the workers needed, and sets a clear approval gate.

Product Designer worker

Design

Researches the market, maps the flow, and prepares the design for your review.

Software Engineer workers

Build

Starts one or more engineer workers, specialized by stack and isolated by task.

QA Engineer worker

Verify

Tests the result against the approved criteria, not just whether it compiles.

You

Release

Keeps merge, deployment, and release decisions explicitly in your hands.

Portable by default

The workers live with the project.

A worker is just an agent configured from plain files in your repository—not a character or setting trapped inside one platform.

01 Review every file before installation
02 Preserve existing Claude configuration
03 Update or uninstall only what wrkrs owns

.wrkrs/team.yamlCommitted

team:
  lead: product-manager
  worker_roles:
    - product-designer
    - software-engineer
    - qa-engineer

software_engineer:
  instances: dynamic
  specializations:
    - macos-swift
    - web-frontend
    - backend

approval: [plan, merge, release]

INSTALL PREVIEWNo files changed

KEEPCLAUDE.mdExisting instructions preserved

MERGE.claude/settings.json2 namespaced entries

REUSEswift-engineer.mdSoftware Engineer + macOS/Swift

ADD.wrkrs/Portable team configuration

Adds without taking over

Your repository stays yours.

wrkrs inspects first, explains every change, and stops when it cannot merge safely. Existing Claude agents can be reused as workers instead of replaced.

Open, not locked in

Claude Code today. Your runtime tomorrow.

Claude CodeFirst runtime

CursorAdapter planned

CodexAdapter planned

Your runtimeOpen adapter spec

Workers, not another workspace

Give your AI agents a real team structure.

Install reusable roles. Start only the workers each task needs.

$npx wrkrs initPrivate alpha