Skip to main content

Command Overview

Station CLI (stn) provides commands for managing agents, MCP servers, and deployments.
stn [command] [subcommand] [flags]

Core Commands

stn init

Initialize Station configuration.
stn init [flags]
FlagDescription
--providerAI provider (openai, gemini, custom)
--modelAI model name
--api-keyAPI key for provider
--base-urlCustom API endpoint
--yes, -yUse defaults without prompts
--shipEnable Ship CLI integration
--cloudship-keyCloudShip registration key

stn serve

Start the Station server.
stn serve [flags]
FlagDescription
--api-portAPI server port (default: 8585)
--mcp-portMCP server port (default: 8586)
--ssh-portSSH server port (default: 2222)
--databaseDatabase file path
--localForce local mode
--enable-telemetryEnable OpenTelemetry

stn up

Start Station in a Docker container.
stn up [flags]
FlagDescription
--workspace, -wWorkspace directory to mount
--providerAI provider for initialization
--bundleCloudShip bundle ID to install
--upgradeRebuild container image
--env, -eAdditional environment variables
--developEnable Genkit Developer UI

stn down

Stop the Station container.
stn down [flags]
FlagDescription
--remove-volumeDelete all data
--remove-imageRemove Docker image
--clean-mcpRemove from .mcp.json

Agent Commands

stn agent create

Create a new agent.
stn agent create --name "my-agent" --description "My agent description"
FlagDescription
--nameAgent name (required)
--descriptionAgent description
--envEnvironment name
--modelAI model override

stn agent run

Execute an agent.
stn agent run <agent-name> "<task>"
FlagDescription
--envEnvironment name
--variablesJSON input variables
--streamStream output

stn agent list

List all agents.
stn agent list [--env <environment>]

MCP Commands

stn mcp list

List MCP configurations.
stn mcp list [--env <environment>]

stn mcp tools

List available MCP tools.
stn mcp tools [--filter <pattern>]

stn mcp status

Show MCP configuration status.
stn mcp status [environment]

stn sync

Sync file-based configurations.
stn sync [environment]
FlagDescription
--dry-runPreview changes
--verboseShow detailed output

Bundle Commands

stn bundle create

Create a bundle from an environment.
stn bundle create <environment> [--output <path>]

stn bundle install

Install a bundle.
stn bundle install <source> <environment> [--force]
Sources can be:
  • CloudShip bundle UUID
  • URL to bundle file
  • Local file path

stn bundle share

Upload a bundle to CloudShip.
stn bundle share <environment-or-file>

Utility Commands

stn status

Show Station server status.
stn status

stn logs

Show container logs.
stn logs [--follow]

stn jaeger

Manage Jaeger telemetry.
stn jaeger up      # Start Jaeger
stn jaeger down    # Stop Jaeger
stn jaeger status  # Check status
stn jaeger clean   # Remove data

stn config

Manage configuration.
stn config show              # Show all config
stn config get <key>         # Get a value
stn config set <key> <value> # Set a value

Global Flags

These flags work with any command:
FlagDescription
--configConfig file path
--enable-telemetryEnable OpenTelemetry
--otel-endpointOTLP endpoint URL
-h, --helpShow help
-v, --versionShow version

Examples

export OPENAI_API_KEY="sk-..."
stn init --provider openai --yes
stn serve
stn up --bundle e26b414a-f076-4135-927f-810bc1dc892a --provider openai
stn agent run code-reviewer --variables '{"code": "print(1)", "language": "python"}'
stn jaeger up
stn serve --enable-telemetry --otel-endpoint http://localhost:4318
# View traces at http://localhost:16686