spwnr

Spwnr is an open-source toolkit for packaging, injecting, and orchestrating multi-agent workers across coding hosts. Currently supporting Claude Code.

Claude Code Quick Start

# Claude Code plugin install
/plugin marketplace add Cheong43/spwnr
/plugin install spwnr@spwnr
/reload-plugins
# spwnr cli install
npm i @spwnr/cli

# Edit Claude Code config on .Claude/setting.json
"env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": 1
}
# Or Edit the env
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

then activate the following skill commands in your agent

/using-spwnr # Main router: /spwnr-plan -> /spwnr-task -> implement
/spwnr-do # Directly handle a bounded small task with optional 1-3 workers
/spwnr-plan # Write plan
/spwnr-task # Route and execute the approved plan in pipeline/team mode
/spwnr-worker-audit # Check subagent template availability and recovery steps

A usage walkthrough lives in docs/guide/getting-started.md.

Community Registry

Spwnr now treats vendor/spwnr-registry as the community template registry source. The nested repository is the canonical place for:

• template source packages under templates/<name>/<version>/
• pull-request based contribution review
• registry index generation via registry-index.json
• GitHub Pages publishing for the official template marketplace

This repository keeps a lightweight portal that mirrors the submodule snapshot and links users to the official registry site.

Initialize the nested repository after cloning:

git submodule update --init --recursive

What Spwnr Includes

• agent-first subagent manifest types and validation
• local registry with publish, resolve, install, list, and info flows
• host adapters that compile a shared package manifest into host-native assets
• an injector layer for static file materialization and session descriptor composition
• a CLI for validate, publish, install, list, info, inject, and session

Deprecated internal runtime packages still exist in the repo for future experiments, but they are not part of the current product surface.

Workspace Layout

apps/
  spwnr-cli/            CLI entry point and command handlers
packages/
  adapters/             host adapters for Claude Code, Codex, Copilot, OpenCode
  broker/               deprecated internal runtime seed
  core-types/           shared manifest, host, and error types
  injector/             static injection and session composition
  manifest-schema/      manifest parsing and package validation
  memory/               deprecated internal runtime seed
  policy/               dormant policy extension interfaces
  registry/             local registry, tarballs, package metadata
examples/
  code-reviewer/        example agent package
  general-*/            workflow worker subagent examples
docs/
  guide/                usage walkthroughs
  archive/              archived design notes

Requirements

• Node.js 22+
• pnpm 9+

Install And Verify

pnpm install
pnpm build
pnpm test

Run pnpm test after changes to verify the workspace and repo-level workflow smoke tests.

If you plan to use the repo-root Claude Code workflow plugin with multi-agent team mode, enable Claude Code agent teams before installation or use:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Without this setting, /spwnr-task can still run pipeline, but it must report team as unavailable.

Repo Claude Plugin

This repository now also carries a repo-root Claude Code plugin for dogfooding a plan-first Claude-native orchestration workflow:

• plugin root: .claude-plugin/plugin.json
• hooks: hooks/
• skills: skills/