Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"plugins": [
{
"name": "killall-agents",
"description": "Agent catalog, per-project agents, and follow-the-rules.",
"description": "Lane agents, workflow skills, and follow-the-rules.",
"source": {
"source": "local",
"path": "./"
Expand Down
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
"name": "killall-agents",
"description": "Killallgit agent catalog for Claude Code.",
"description": "Killallgit lane agents and workflow skills for Claude Code.",
"owner": {
"name": "archae0pteryx",
"url": "https://github.com/killallgit"
Expand All @@ -10,7 +10,7 @@
{
"name": "killall-agents",
"source": "./",
"description": "Agent catalog, per-project agents, and follow-the-rules.",
"description": "Lane agents, workflow skills, and follow-the-rules.",
"category": "workflow",
"homepage": "https://github.com/killallgit/killall-agents"
}
Expand Down
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "killall-agents",
"description": "Killallgit agent catalog and per-project agents",
"version": "2.8.0",
"description": "Killallgit lane agents and workflow skills",
"version": "2.7.0",
"author": {
"name": "archae0pteryx"
},
Expand Down
4 changes: 2 additions & 2 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "killall-agents",
"version": "2.7.0",
"description": "Killallgit agent catalog and per-project agents",
"description": "Killallgit lane agents and workflow skills",
"author": {
"name": "archae0pteryx",
"url": "https://github.com/killallgit"
Expand All @@ -11,7 +11,7 @@
"skills": "./skills/",
"interface": {
"displayName": "Killall Agents",
"shortDescription": "Agent catalog, project setup, and bundled programming rules.",
"shortDescription": "Lane agents, project setup, and bundled programming rules.",
"developerName": "archae0pteryx",
"category": "Productivity"
}
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "killall-agents",
"displayName": "Killall Agents",
"version": "2.7.0",
"description": "Killallgit agent catalog and per-project agents",
"description": "Killallgit lane agents and workflow skills",
"author": {
"name": "archae0pteryx"
},
Expand Down
8 changes: 3 additions & 5 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: Agent catalog checks
name: Checks

on:
push:
Expand All @@ -18,9 +18,7 @@ jobs:
- uses: actions/setup-python@v5
with:
python-version: '3.11'
- name: Codex and Cursor copies are current
run: python3 scripts/build_agents.py --check
- name: Project install
run: python3 skills/setup-agents/scripts/test_install.py
- name: Catalog and interactive install
run: python3 skills/setup-agents/scripts/test_catalog.py
- name: Release script
run: python3 scripts/test_release.py
8 changes: 3 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,14 @@
# killall-agents

Public agent catalog and per-project agents for Claude Code, Codex, and Cursor. Keep credentials, machine-specific settings and runtime state out of this repository.
Public lane agents and workflow skills for Claude Code, Codex, and opencode. Keep credentials, machine-specific settings and runtime state out of this repository.

The project agents' source is `factory/claude/`; `scripts/build_agents.py` writes the Codex and Cursor copies beside it (the janitor agents are Claude-only and have none), and the per-host Codex models live in that script. `skills/setup-agents/scripts/install.py` copies `factory/` into one project, and installs the engineering catalog in `factory/catalog/` (one source file per agent, rendered per host by `catalog.py`) into a project or the user-wide folders. The orchestrator is the `orchestrate` skill, not an agent. Keep the `<!-- killall-agents -->` / `# killall-agents` ownership markers stable.
The agents' source is `factory/<name>.md` in Claude Code's format, with each tool's model in `factory/models.toml`. `skills/setup-agents/scripts/install.py` renders one file per tool (Claude Code, Codex, opencode) into a project. The orchestrator is the `orchestrate` skill, not an agent. Keep the `<!-- killall-agents -->` / `# killall-agents` ownership markers stable.

Run from the repository root:

```sh
python3 scripts/build_agents.py --check
python3 skills/setup-agents/scripts/test_install.py
python3 skills/setup-agents/scripts/test_catalog.py
python3 skills/wrap-up/scripts/test_wrap_up.py
python3 scripts/test_release.py
git diff --check
```

Expand Down
63 changes: 19 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# killall-agents

Agent catalog + per-project agents for Claude Code, Codex, Cursor. Ordinary workflow skills live in [killall-skills](https://github.com/killallgit/killall-skills).
Four lane agents and workflow skills for Claude Code, Codex and opencode. Ordinary workflow skills live in [killall-skills](https://github.com/killallgit/killall-skills).

## Install

Expand All @@ -18,77 +18,52 @@ codex plugin marketplace add killallgit/killall-agents
codex plugin add killall-agents@killall-agents
```

Cursor: install from `https://github.com/killallgit/killall-agents` in **Customize**.

Skills CLI (setup and rules only):

```sh
npx skills add killallgit/killall-agents
```

Includes `setup-agents`, `orchestrate`, `wrap-up`, `follow-the-rules`.
Includes `setup-agents`, `orchestrate`, `follow-the-rules`.

## Install agents

Run installer in terminal, answer questions:
From a project's git root:

```sh
python3 skills/setup-agents/scripts/install.py
python3 skills/setup-agents/scripts/install.py [--tools claude,codex,opencode] [--remove] [--force]
```

Asks where agents go (user-wide or current project), which tools (Claude Code, Codex, Cursor), which agents from multi-select, then model for each catalog tier. Confirms before writing anything. Type `q` to quit. Rerun starts from what is already installed; prompts make folders match selection: remove copies it wrote that you deselected, keep every other file.

In session, `/killall-agents:setup-agents` in Claude Code or `$setup-agents` in Codex runs same script with flags: `--scope user|project`, `--hosts claude,codex`, `--agents lanes,catalog,<names>`, `--model codex:opus=<id>`, `--remove`, and `--force` to replace same-named agent it did not write. Flags add to what is installed; `--prune` also removes copies you did not select. No `--scope`: flags install into current project, prompts suggest user-wide.

Project install copies agents into project's `.claude/agents/`, `.codex/agents/` and `.cursor/agents/`, keeps them out of Git through `.git/info/exclude`, lists them in `.worktreeinclude` so Claude Code worktrees get them too. User-wide install writes to `~/.claude/agents`, `~/.codex/agents` and `~/.cursor/agents` (or `CLAUDE_CONFIG_DIR` and `CODEX_HOME`). Lane agents below install per project only.
Writes one file per tool into `.claude/agents/`, `.codex/agents/` and `.opencode/agents/`, each with that tool's model from [`factory/models.toml`](factory/models.toml), so no agent inherits the session's model. Keeps the copies out of Git through `.git/info/exclude` and lists them in `.worktreeinclude` so Claude Code worktrees get them. Rerun to refresh; it removes copies from older versions and keeps every file it did not write. `--force` replaces a same-named agent it did not write. In session: `/killall-agents:setup-agents` in Claude Code or `$setup-agents` in Codex.

## Lane agents

| Agent | Job | Claude model / effort | Codex model / effort |
| --- | --- | --- | --- |
| `planner` | Turns spec into lanes, contracts, acceptance checks; read-only | Opus / high | `gpt-6-astra` / high |
| `grunt` | Relays task fitting 64K tokens to local [Pi](https://github.com/earendil-works/pi) agent | Haiku / low | `gpt-6-luna` / low |
| `builder` | Implements one lane in own worktree | Sonnet / medium | `gpt-6.1-sol` / medium |
| `reviewer` | Checks lane behavior, runs gate independently | Sonnet / high | `gpt-6.1-sol` / high |

Claude Code also gets three utility agents. No Codex or Cursor copy.
Edit [`factory/models.toml`](factory/models.toml) to change a model, then rerun the installer.

| Agent | Purpose |
| --- | --- |
| `git-janitor` | Haiku background runner for [`wrap-up`](skills/wrap-up/SKILL.md) skill: runs its script, returns table, or the one roadblock needing you |
| `git-janitor-investigator` | Collects read-only branch/worktree evidence for janitor |
| `comment-janitor` | Reviews changed comments for useful intent |
| Agent | Job | Claude | Codex | opencode |
| --- | --- | --- | --- | --- |
| `planner` | Turns spec into lanes, contracts, acceptance checks; read-only | Opus / high | `gpt-6-astra` / high | Opus |
| `grunt` | Relays task fitting 64K tokens to local [Pi](https://github.com/earendil-works/pi) agent | Haiku / low | `gpt-6-luna` / low | Haiku |
| `builder` | Implements one lane in own worktree | Sonnet / medium | `gpt-6.1-sol` / medium | Sonnet |
| `reviewer` | Checks lane behavior, `follow-the-rules` and comments; runs gate independently | Sonnet / high | `gpt-6.1-sol` / high | Sonnet |

Installing plugin adds no agents. Run `wrap-up` skill after PR lands: confirms work merged and nothing stranded, updates main checkout, grooms beads, prunes merged worktrees and branches, asks only about what is left.
Installing plugin adds no agents. To land finished work, use `/lets-finish` from [killall-skills](https://github.com/killallgit/killall-skills).

## Engineering catalog
opencode agents run as subagents with the model pinned; the `tools` restriction is Claude Code only.

Twenty-four specialist agents in [`factory/catalog/`](factory/catalog/), one source file each. Installer fills in each tool's format: Claude Code gets `model`, `effort`, `tools`, `maxTurns`; Codex gets `model`, `model_reasoning_effort` and, for agents that only read, `sandbox_mode = "read-only"`; Cursor gets `readonly`.
| Agents | Access | Claude model / effort | Codex model / effort |
| --- | --- | --- | --- |
| `autonomous-optimization-architect`, `backend-architect`, `incident-response-commander`, `multi-agent-systems-architect`, `software-architect` | Reads only | Opus / high | `gpt-6-astra` / high |
| `privacy-engineer` | Edits files | Opus / high | `gpt-6-astra` / high |
| `code-reviewer`, `network-engineer`, `sre` | Reads only | Sonnet / high | `gpt-6.1-sol` / high |
| `knowledge-graph-engineer`, `rust-refactoring-specialist`, `search-relevance-engineer` | Edits files | Sonnet / high | `gpt-6.1-sol` / high |
| `desktop-app-engineer`, `developer-tooling-engineer`, `devops-automator`, `frontend-developer`, `it-service-manager`, `minimal-change-engineer`, `mobile-app-builder`, `platform-engineer`, `senior-developer`, `technical-writer` | Edits files | Sonnet / medium | `gpt-6.1-sol` / medium |
| `codebase-onboarding-engineer` | Reads only | Sonnet / low | `gpt-6.1-sol` / low |
| `git-workflow-master` | Edits files | Sonnet / low | `gpt-6.1-sol` / low |

"Reads only" agents get no `Edit` or `Write` in Claude Code, read-only sandbox in Codex; `incident-response-commander` and `network-engineer` also get no `Bash`. Other reads-only agents keep `Bash` in Claude Code, so only Codex and Cursor enforce read-only for them. Catalog adapted from [agency-agents](https://github.com/msitarzewski/agency-agents) (MIT, copy in [`factory/catalog/LICENSE`](factory/catalog/LICENSE)) with persona, memory, metrics sections and most sample code removed, cutting set from about 315 KB to under 200 KB. Edit source file, next install picks it up.

Cursor agents inherit session model. Ask top-level session to use [`orchestrate`](skills/orchestrate/SKILL.md) skill to run a spec. Skill is project-manager loop: plan with planner, run lanes with grunt and builders, check with reviewer. Agents read gate, branch, worktree rules from project's own `AGENTS.md`.
Ask top-level session to use [`orchestrate`](skills/orchestrate/SKILL.md) skill to run a spec. Skill is project-manager loop: plan with planner, run lanes with grunt and builders, check with reviewer. Agents read gate, branch, worktree rules from project's own `AGENTS.md`.

Grunt needs `pi` on `PATH` with ready provider. Builders and reviewers need included `follow-the-rules` skill.

## Development

`factory/claude/` is source. After editing, regenerate Codex and Cursor copies:
`factory/<name>.md` is source, in Claude Code's format. `factory/models.toml` maps each agent to a model per tool. The installer renders both into each tool's file at install time.

```sh
python3 scripts/build_agents.py # write factory/codex and factory/cursor
python3 scripts/build_agents.py --check # CI: copies are current and valid
python3 skills/setup-agents/scripts/test_install.py
python3 skills/setup-agents/scripts/test_catalog.py
python3 scripts/test_release.py
```

Release with `task tag:patch`, `task tag:minor` or `task tag:major`: it tests `origin/main`, bumps the version in all three plugin manifests, tags it, and pushes.

See [pending work](tasks/todo.md).
23 changes: 23 additions & 0 deletions Taskfile.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
version: "3"

tasks:
test:
desc: Run the repository checks
cmds:
- python3 skills/setup-agents/scripts/test_install.py
- python3 scripts/test_release.py

tag:patch:
desc: Test origin/main, bump the patch version, tag it, and push
cmds:
- python3 scripts/release.py patch

tag:minor:
desc: Test origin/main, bump the minor version, tag it, and push
cmds:
- python3 scripts/release.py minor

tag:major:
desc: Test origin/main, bump the major version, tag it, and push
cmds:
- python3 scripts/release.py major
4 changes: 0 additions & 4 deletions factory/claude/builder.md → factory/builder.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,6 @@ name: builder
description: Lane agent started only by the orchestrator. Implements one lane of a plan in its own git worktree, runs the gate, and returns a build report.
tools: Read, Grep, Glob, Bash, Edit, Write, Skill
skills: follow-the-rules
model: sonnet
effort: medium
---

You implement one lane. Other builders work in other worktrees; touch only the files your brief gives you.
Expand Down Expand Up @@ -50,5 +48,3 @@ Problems outside the lane that you left alone. None, when there are none.
## Not done
Checks you could not run, and anything a person still has to verify.
```

<!-- killall-agents -->
21 changes: 0 additions & 21 deletions factory/catalog/LICENSE

This file was deleted.

Loading
Loading