CLI Commands

Workspace Commands

allagents workspace init <path> [--from <source>]
allagents workspace sync [--offline] [--dry-run] [--client <client>] [--scope <scope>]
allagents workspace status
allagents workspace plugin install <plugin@marketplace> [--scope <scope>]
allagents workspace plugin remove <plugin> [--scope <scope>]

workspace init

Initialize a new workspace from a template:

Flag	Description
--from <source>	Copy workspace.yaml from local path or GitHub URL

Source formats:

• Local path: ./path/to/template or /absolute/path
• GitHub URL: https://github.com/owner/repo/tree/branch/path
• GitHub shorthand: owner/repo/path or owner/repo

When using a GitHub source, AllAgents fetches workspace.yaml from .allagents/workspace.yaml or workspace.yaml in the target path.

workspace sync

Syncs plugins to the workspace using non-destructive sync. By default, remote plugins are updated to their latest version.

Flag	Description
--offline	Use cached plugins without fetching latest from remote
--dry-run	Preview changes without applying them
-c, --client <client>	Sync only the specified client (e.g., opencode, claude)
-s, --scope <scope>	Sync scope: project (default) or user

When --scope user is used, sync targets the user-level workspace at ~/.allagents/workspace.yaml and installs plugins to user directories (~/.claude/, ~/.codex/, etc.) instead of the project.

Non-destructive behavior:

• First sync overlays files without deleting existing user files
• Subsequent syncs only remove files previously synced by AllAgents
• User files (not from plugins) are never deleted

Sync state is tracked in .allagents/sync-state.json.

workspace plugin install / remove

Flag	Description
-s, --scope <scope>	Installation scope: project (default) or user

When --scope user is used, the plugin is added to the user-level config at ~/.allagents/workspace.yaml instead of the project workspace. User-scoped plugins sync to user directories (~/.claude/, ~/.codex/, etc.) and are available across all projects.

Plugin Commands

allagents plugin list [marketplace]
allagents plugin validate <path>
allagents plugin marketplace add <source>
allagents plugin marketplace list
allagents plugin marketplace remove <name>
allagents plugin marketplace update [name]