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
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,6 @@ jobs:
- name: Codex and Cursor copies are current
run: python3 scripts/build_agents.py --check
- name: Project install
run: python3 skills/agent-setup/scripts/test_install.py
run: python3 skills/setup-agents/scripts/test_install.py
- name: Catalog and interactive install
run: python3 skills/agent-setup/scripts/test_catalog.py
run: python3 skills/setup-agents/scripts/test_catalog.py
8 changes: 4 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@

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.

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/agent-setup/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 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.

Run from the repository root:

```sh
python3 scripts/build_agents.py --check
python3 skills/agent-setup/scripts/test_install.py
python3 skills/agent-setup/scripts/test_catalog.py
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
git diff --check
```

`skills/follow-the-rules/` is an independent copy from [killall-skills](https://github.com/killallgit/killall-skills/tree/a016d77ff5f86821f0292a5a00dbf4600b0d8a15/skills/follow-the-rules); preserve its relative reference links. Keep agents out of a root `agents/` folder, which Claude Code loads on plugin install; they belong in `factory/` so only `agent-setup` installs them.
`skills/follow-the-rules/` is an independent copy from [killall-skills](https://github.com/killallgit/killall-skills/tree/a016d77ff5f86821f0292a5a00dbf4600b0d8a15/skills/follow-the-rules); preserve its relative reference links. Keep agents out of a root `agents/` folder, which Claude Code loads on plugin install; they belong in `factory/` so only `setup-agents` installs them.

Pending grunt and setup TUI work is tracked in `tasks/todo.md`.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,19 +26,19 @@ Skills CLI (setup and rules only):
npx skills add killallgit/killall-agents
```

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

## Install agents

Run installer in terminal, answer questions:

```sh
python3 skills/agent-setup/scripts/install.py
python3 skills/setup-agents/scripts/install.py
```

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:agent-setup` in Claude Code or `$agent-setup` 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.
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.

Expand Down Expand Up @@ -88,8 +88,8 @@ Grunt needs `pi` on `PATH` with ready provider. Builders and hall-monitor need i
```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/agent-setup/scripts/test_install.py
python3 skills/agent-setup/scripts/test_catalog.py
python3 skills/setup-agents/scripts/test_install.py
python3 skills/setup-agents/scripts/test_catalog.py
```

See [pending work](tasks/todo.md) and [factory research](docs/research/agent-factory-patterns.md) for design background.
2 changes: 1 addition & 1 deletion scripts/build_agents.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
ROOT = Path(__file__).resolve().parent.parent
FACTORY = ROOT / "factory"
# Codex model, Codex reasoning effort, Cursor readonly; Cursor agents inherit the session model.
# The model ids repeat the tiers in skills/agent-setup/scripts/catalog.py; test_catalog.py checks that they agree.
# The model ids repeat the tiers in skills/setup-agents/scripts/catalog.py; test_catalog.py checks that they agree.
HOSTS = {
"planner": ("gpt-6-astra", "high", True),
"grunt": ("gpt-6-luna", "low", False),
Expand Down
4 changes: 2 additions & 2 deletions skills/agent-setup/SKILL.md → skills/setup-agents/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
name: agent-setup
name: setup-agents
description: Install, refresh, or remove the packaged agents for Claude Code, Codex, and Cursor. The planner, grunt, builder, reviewer, hall-monitor, git-janitor, and comment-janitor lane agents go in one project; the engineering catalog of specialist agents goes in one project or user-wide.
disable-model-invocation: true
argument-hint: "[remove] [path]"
---

# Agent setup
# Set up agents

Copy the packaged agents into a project, or the catalog into the user-wide folders. A person at a terminal can run `python3 scripts/install.py` from this skill's directory with no flags and answer its questions: where, which tools, a multi-select of agents, and the catalog models. The steps below drive the same script with flags, because a session cannot answer those prompts.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
interface:
display_name: "Agent setup"
display_name: "Set up agents"
short_description: "Install or remove the packaged lane agents in a project and the engineering agent catalog in a project or user-wide."
policy:
allow_implicit_invocation: false
Loading