Generated CLI Reference
Generated from Commander command declarations inapps/agents-synapsex/shared/cli/src.
- Package:
synapsex-cli - Version:
0.1.0 - Parsed command entries:
50
Install
Commands
synapsex agent
Manage AI agents
Source: src/commands/agent.ts
synapsex agent create
Create a new AI agent
Arguments:
| Argument | Description |
|---|---|
<name> | Agent name |
| Option | Description | Default |
|---|---|---|
-p, --provider <provider> | LLM provider to use | “ |
-m, --model <model> | AI model to use | “ |
-t, --tools <tools...> | Tools to enable | “ |
-d, --description <text> | Agent description | “ |
src/commands/agent.ts
synapsex agent list
List all agents
Options:
| Option | Description | Default |
|---|---|---|
-q, --quiet | Only show IDs | “ |
src/commands/agent.ts
synapsex agent status
Check agent status
Arguments:
| Argument | Description |
|---|---|
<id> | Agent ID or name |
src/commands/agent.ts
synapsex agent logs
Stream agent logs
Arguments:
| Argument | Description |
|---|---|
<id> | Agent ID or name |
| Option | Description | Default |
|---|---|---|
-n, --lines <count> | Number of recent lines to show | 50 |
src/commands/agent.ts
synapsex agent delete
Delete an agent
Arguments:
| Argument | Description |
|---|---|
<id> | Agent ID or name |
| Option | Description | Default |
|---|---|---|
-f, --force | Skip confirmation | “ |
src/commands/agent.ts
synapsex agent invoke
Invoke an agent with input
Arguments:
| Argument | Description |
|---|---|
<id> | Agent ID or name |
<input> | Input text |
| Option | Description | Default |
|---|---|---|
-s, --stream | Stream output | “ |
src/commands/agent.ts
synapsex config
Manage SynapseX configuration
Source: src/commands/config.ts
synapsex config get
Get configuration value
Arguments:
| Argument | Description |
|---|---|
<key> | Configuration key |
src/commands/config.ts
synapsex config set
Set configuration value
Arguments:
| Argument | Description |
|---|---|
<key> | Configuration key |
<value> | Configuration value |
src/commands/config.ts
synapsex config list
List all configuration
Source: src/commands/config.ts
synapsex config clear
Clear configuration
Source: src/commands/config.ts
synapsex deploy
Deploy agents to SynapseX cloud
Source: src/commands/deploy.ts
synapsex deploy local
Run agent locally with Docker
Arguments:
| Argument | Description |
|---|---|
<agent-id> | Agent ID or name |
| Option | Description | Default |
|---|---|---|
-p, --port <port> | Port to expose | 8080 |
src/commands/deploy.ts
synapsex deploy cloud
Deploy agent to SynapseX cloud
Arguments:
| Argument | Description |
|---|---|
<agent-id> | Agent ID or name |
src/commands/deploy.ts
synapsex init
Initialize SynapseX in a repository
Options:
| Option | Description | Default |
|---|---|---|
--repo <url> | Git repository URL | “ |
src/commands/init.ts
synapsex jobs
Manage jobs
Source: src/commands/jobs.ts
synapsex jobs submit <title>
Submit a new job
Options:
| Option | Description | Default |
|---|---|---|
--agent <agent-id> | Agent ID | “ |
--tenant <tenant-id> | Tenant ID | “ |
--type <type> | Job type | general |
--priority <priority> | Priority (1-10) | 5 |
src/commands/jobs.ts
synapsex jobs list
List jobs
Options:
| Option | Description | Default |
|---|---|---|
--agent <agent-id> | Filter by agent | “ |
--status <status> | Filter by status | “ |
src/commands/jobs.ts
synapsex jobs cancel <job-id>
Cancel a job
Source: src/commands/jobs.ts
synapsex jobs status <job-id>
Get job status
Source: src/commands/jobs.ts
synapsex mcp
Manage MCP tools and registries
Source: src/commands/mcp.ts
synapsex mcp list
List available MCP tools
Options:
| Option | Description | Default |
|---|---|---|
-c, --category <name> | Filter by category | “ |
src/commands/mcp.ts
synapsex mcp info
Get tool details
Arguments:
| Argument | Description |
|---|---|
<name> | Tool name |
src/commands/mcp.ts
synapsex mcp add
Add MCP registry
Arguments:
| Argument | Description |
|---|---|
<url> | Registry URL |
| Option | Description | Default |
|---|---|---|
-n, --name <name> | Registry name | “ |
src/commands/mcp.ts
synapsex mcp route
Select the best MCP/tool for a natural-language request
Arguments:
| Argument | Description |
|---|---|
<input> | Natural-language request |
| Option | Description | Default |
|---|---|---|
--preferred <name> | Preferred MCP server name | “ |
--tenant <id> | Tenant ID | “ |
--json | Print JSON output | “ |
src/commands/mcp.ts
synapsex mcp plan
Create an explainable MCP execution plan
Arguments:
| Argument | Description |
|---|---|
<input> | Natural-language request |
| Option | Description | Default |
|---|---|---|
--preferred <name> | Preferred MCP server name | “ |
--tenant <id> | Tenant ID | “ |
--json | Print JSON output | “ |
src/commands/mcp.ts
synapsex mcp ask
Plan or execute an MCP-backed request intelligently
Arguments:
| Argument | Description |
|---|---|
<input> | Natural-language request |
| Option | Description | Default |
|---|---|---|
--preferred <name> | Preferred MCP server name | “ |
--tenant <id> | Tenant ID | “ |
--approve | Approve execution when required | “ |
--mode <mode> | auto or plan | auto |
--tool <name> | Force tool name | “ |
--tool-input <json> | Structured tool input JSON | “ |
--vm <id> | Target VM ID for VM-backed MCP tools | “ |
--timeout <seconds> | Execution timeout seconds | 30 |
--json | Print JSON output | “ |
src/commands/mcp.ts
synapsex providers
Configure LLM providers for SynapseX agents
Source: src/commands/providers.ts
synapsex providers setup
Configure an LLM provider
Options:
| Option | Description | Default |
|---|---|---|
-m, --model <model> | Default model for this provider | “ |
--api-key-env <name> | Environment variable that stores the API key | “ |
--base-url <url> | Custom provider base URL | “ |
--default | Use this provider as the default for new agents | “ |
src/commands/providers.ts
synapsex providers use
Set the default provider and model for new agents
Arguments:
| Argument | Description |
|---|---|
<provider> | Provider name |
| Option | Description | Default |
|---|---|---|
-m, --model <model> | Default model | “ |
src/commands/providers.ts
synapsex providers list
List configured LLM providers
Source: src/commands/providers.ts
synapsex merge
No description.
Arguments:
| Argument | Description |
|---|---|
<agent-id> | Agent ID |
| Option | Description | Default |
|---|---|---|
--strategy <strategy> | Merge strategy (squash, merge, rebase) | squash |
src/commands/workflow.ts
synapsex promote
Push agent branch and open PR
Arguments:
| Argument | Description |
|---|---|
<agent-id> | Agent ID |
src/commands/workflow.ts
synapsex billing
Manage billing and subscription
Source: src/commands/workflow.ts
synapsex billing status
Check billing status
Source: src/commands/workflow.ts
synapsex billing quota
Check quota and usage
Options:
| Option | Description | Default |
|---|---|---|
--agent <agent-id> | Check quota for specific agent | “ |
src/commands/workflow.ts
synapsex billing history
View credit transaction history
Options:
| Option | Description | Default |
|---|---|---|
--limit <number> | Number of transactions | 20 |
src/commands/workflow.ts
synapsex billing plans
List available plans
Source: src/commands/workflow.ts
synapsex webhooks
Manage webhooks
Source: src/commands/workflow.ts
synapsex webhooks create <url>
Create a webhook subscription
Options:
| Option | Description | Default |
|---|---|---|
--entity <entity-id> | Entity ID | “ |
--app <app-id> | App ID | “ |
--action <action> | Action filter | “ |
src/commands/workflow.ts
synapsex webhooks list
List webhooks
Options:
| Option | Description | Default |
|---|---|---|
--entity <entity-id> | Entity ID | “ |
src/commands/workflow.ts
synapsex integrations
Manage integrations
Source: src/commands/workflow.ts
synapsex integrations list
List available integrations
Source: src/commands/workflow.ts
synapsex integrations connect <provider>
Connect an integration
Options:
| Option | Description | Default |
|---|---|---|
--entity <entity-id> | Entity ID | “ |
src/commands/workflow.ts
synapsex server
Manage orchestrator server
Source: src/commands/workflow.ts
synapsex server start
Start the orchestrator server
Source: src/commands/workflow.ts
synapsex server status
Check server health
Source: src/commands/workflow.ts
synapsex workflow
Run multi-agent workflows
Arguments:
| Argument | Description |
|---|---|
<description> | Workflow description |
| Option | Description | Default |
|---|---|---|
--agents <agents> | Comma-separated agent profiles | planner,coder,reviewer,tester |
--budget <budget> | Total budget USD | 5.0 |
--model <model> | LLM model | claude-sonnet-4-6 |
src/commands/workflow.ts
synapsex run
Run an agent interactively
Arguments:
| Argument | Description |
|---|---|
<agent-id> | Agent ID or name |
| Option | Description | Default |
|---|---|---|
-i, --input <text> | Input to pass to the agent | “ |
-s, --stream | Stream output in real-time | “ |
src/index.ts