Commands

Barry’s commands split in two. System commands run under barry and act on the machine: the bags installed on it, its identities, its services and stores. Identity commands run as one identity, through that identity’s own command (an identity named bonanza gets a bonanza command), and act for it: its sessions, packed bags, secrets, actions, and schedules. A bag can add commands of its own; those depend on what you have installed, so they are not listed here. Run any command with --help to see the same information in the terminal.

A script builds these pages from the command definitions in Barry itself, so they list every command and option that Barry accepts.

System commands

Command	Description
barry workers	Machines that run this Barry’s workflow activities, and the owners this machine works for.
barry device	Review pairing requests and manage scoped device credentials.
barry owner	Show or bind the local installation’s user owner.
barry identity	Create and configure identities.
barry doctor	Report installation health, adapters and identity configuration drift.
barry ls	List all identities (alias for identity list)
barry trait	Manage traits.
barry bound	Manage bounds.
barry config	Barry configuration (show, export, import)
barry trash	Soft-delete files by moving them to this instance’s trash.
barry archive	Move files to this instance’s archive.
barry cursor	Cursor agent integration.
barry bag	Manage capability bags.
barry schedule	See, run and pause schedules (actions on a trigger)
barry use	Use an identity (interactive picker if no name given)
barry alias	Give an identity another command name (e.g. bgo for bgoode)
barry new	Scaffold a bag, action, instruction, or trait (bare name = bag)
barry install	Install a bag on this machine and register it (local dir, npm package, git repo, or MCP URL). Repos are cloned to ~/repos/bags. Pack it onto an identity with <identity> pack <bag>.
barry adapter	Agent adapters — which are usable on this machine.
barry completion	Output shell completion script (eval “$(barry completion)”)
barry status	Show operational status of services, stores, and schedules.
barry store	Inspect and verify Barry stores (SQLite databases)
barry up	Start registered enabled services through launchd.
barry down	Stop registered services without changing automatic startup.
barry setup	Install this instance: its CLI, apps, configuration, and declared service registrations.
barry upgrade	Move this instance onto the release this barry belongs to: snapshot, migrate a copy of the stores when their schemas change, switch, restart and verify.
barry uninstall	Uninstall Barry: stop services, remove launchd agents, and delete shims.
barry service	See and control this instance’s services.
barry app	See and open this instance’s registered GUI apps.
barry hosting	What this instance exposes, where, and whether it is applied.
barry env	This instance’s secrets file.
barry db	Back up, restore, roll back, recover or prune the stores this instance runs on.

Options that apply to every barry command:

Option	Description
-V, --version	Output the version number.
-i, --identity <identity>	The identity to act as.

Identity commands

Command	Description
<identity> session	Manage sessions.
<identity> identity	Create and configure identities.
<identity> notify	Send a notification through the configured channel (Slack, SMS)
<identity> mcp	MCP server management.
<identity> vault	Manage secrets in the encrypted vault.
<identity> bag	Manage capability bags.
<identity> action	Run actions and read their recorded runs.
<identity> schedule	See, run and pause schedules (actions on a trigger)
<identity> events	Manage barry events.
<identity> acp	Serve Barry as an ACP agent on stdin/stdout, for an editor to run.
<identity> install	Install a bag on this machine, then offer to pack it onto this identity. Repos are cloned to ~/repos/bags.
<identity> pack	Add an installed bag to this identity’s identity.yaml and create its stores (syncs its traits so sessions get its tools)
<identity> unpack	Remove a bag from this identity’s identity.yaml (files on disk are untouched)
<identity> track	Track sessions Barry did not launch (Cursor, IDE Claude) via your own hooks.
<identity> completion	Output shell completion script (eval “$(barry completion)”)
<identity> tool	Run a bag tool directly (bypasses static command groups)
<identity> status	Show operational status of services, stores, and schedules.
<identity> store	Inspect and verify Barry stores (SQLite databases)

Options that apply to every <identity> command:

Option	Description
-V, --version	Output the version number.