CLI Commands

Workspace Commands

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

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)

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.

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]