CLI

Flags for every command

Flag	What it does
--scope global|project	Limit to one scope. Default: both
--agent <id>	Limit to one agent. Repeatable
--dir <path>	Project directory. Default: .
--json	Stable JSON output

Declarative workflow

Command	What it does
pegboard init	Create pegboard.yaml with the detected agents
pegboard import	Add the MCPs your agents already have to pegboard.yaml
pegboard replicate <source> <target>…	Give other agents what one agent has, without a stack
pegboard plan	Show what would change. Writes nothing
pegboard apply	Apply the plan, asking for confirmation first
pegboard drift	Compare state with the real files
pegboard update [source…]	Re-resolve skills, show the diff, and update pegboard.lock

plan flags

Flag	What it does
--exit-code	Exit with 2 if there are changes
--force	Show the plan with conflicts resolved in favor of pegboard.yaml
--prune-adhoc	Include the removal of ad-hoc entries

apply flags

Flag	What it does
-y, --yes	Skip the confirmation
--force	Overwrite content edited by hand
--prune-adhoc	Also remove ad-hoc entries

drift flags

Flag	What it does
--exit-code	Exit with 2 if there is drift
--strict	Count ad-hoc entries as drift

Editing the stack

These commands edit pegboard.yaml and don’t apply anything. Run plan and apply afterward.

Command	What it does
pegboard add mcp <name>=<command|url>	Add an MCP
pegboard add skill <source>	Add a skill
pegboard remove mcp <name>	Remove an MCP
pegboard remove skill <source|name>	Remove a skill
pegboard adopt	Move everything installed ad-hoc into pegboard.yaml

add accepts --env K=V for stdio MCPs and --header K=V for HTTP MCPs. Both are repeatable. With --agent, the new MCP or skill is limited to those agents.

Ad-hoc mode

Command	What it does
pegboard install mcp <name>=<command|url>	Install an MCP now, without a stack
pegboard install skill <source>	Install a skill now, without a stack
pegboard uninstall mcp <name>	Remove an ad-hoc MCP
pegboard uninstall skill <name>	Remove an ad-hoc skill

install accepts --env, --header, --save to also add the entry to pegboard.yaml, --force to overwrite anything that exists, --dry-run to show the plan and stop, and -y. uninstall accepts --force to remove entries edited by hand, --dry-run, and -y.

replicate accepts --context before|after|replace|skip, --force, --dry-run, and -y.

Other commands

Command	What it does
pegboard agents	List detected agents, their paths, and provider version
pegboard skill install	Install the built-in skill on detected agents
pegboard skill uninstall	Remove the built-in skill from detected agents
pegboard completion <shell>	Generate a shell completion script