CLI Commands
Complete reference for all SynapSync CLI commands.
Command Categories
Project Setup
| Command | Description |
|---|---|
init | Initialize a new project |
config | Manage configuration |
status | Show project status |
Provider Management
| Command | Description |
|---|---|
providers | Manage AI providers |
Cognitive Management
| Command | Description |
|---|---|
add | Add cognitives from registry, local path, or GitHub |
list | List installed cognitives |
list --remote | Browse the registry |
uninstall | Remove cognitives |
update | Update cognitives |
Synchronization
| Command | Description |
|---|---|
sync | Sync to providers |
Maintenance
| Command | Description |
|---|---|
doctor | Diagnose issues |
clean | Clean cache and orphans |
purge | Completely remove SynapSync from the project |
Information
| Command | Description |
|---|---|
help | Show help |
version | Show version |
info | Show concepts |
Global Options
Available on all commands:
-v, --version Show CLI version
--verbose Enable verbose output
--no-color Disable colored output
-h, --help Show help for command
Common Patterns
JSON Output
Most commands support --json for scripting:
synapsync list --json | jq '.[] | .name'
Dry Run
Preview changes without applying:
synapsync sync --dry-run
synapsync clean --dry-run
synapsync update --dry-run
Filtering
Filter by type or category:
synapsync list --type skill
synapsync list --remote --category frontend
synapsync sync --type agent --provider claude