cli reference

pipemason agent

Manage the agents the runner uses. Out of the box pipemason ships with the full first-party agent set (analyst, architects, implementers, reviewers, auditors). This command is how you add community agents or swap one out.

Subcommands

pipemason agent list
pipemason agent install <name>
pipemason agent remove <name>

list

$ pipemason agent list

NAME                    SOURCE     VERSION   ROLE
analyst                 builtin    1.0.0     analyze
architect-mobile        builtin    1.0.0     plan
architect-api           builtin    1.0.0     plan
contract-architect      builtin    1.0.0     contracts
…
visionos-app-uitest     community  0.2.1     test-red (visionOS)

install

# From the public registry
pipemason agent install visionos-app-uitest

# From a GitHub release artifact
pipemason agent install github:crashbytes/[email protected]

# From a local file (development)
pipemason agent install ./local-agent.tgz

The runner verifies the agent's signature against the registry's public key before installing. Signed installs land under ~/.pipemason/agents/<name>.

remove

pipemason agent remove <name>

Removes a community agent. Built-in agents can't be removed (they're bundled with the runner binary).

Note

Community agents run with the same privileges as built-in agents — they call your Anthropic key and execute shell commands inside your repo. Only install agents you trust.