ENVIRONMENTS

Environment Management

Station's environment system provides secure isolation for agents and tools across development, staging, and production environments. Each environment maintains its own MCP server pool, agent definitions, and configuration variables.

Environment Structure

Directory Layout

~/.config/station/environments/
├── default/
│   ├── agents/              # Agent .prompt files
│   │   ├── File Analyzer.prompt
│   │   ├── Security Scanner.prompt
│   │   └── Code Reviewer.prompt
│   ├── template.json        # MCP server configurations
│   └── variables.yml        # Environment-specific variables
├── staging/
│   ├── agents/
│   ├── template.json
│   └── variables.yml
└── production/
    ├── agents/
    ├── template.json
    └── variables.yml

File-Based Configuration

Template Configuration (template.json):

{
  "name": "development-environment",
  "description": "Development environment with filesystem and security tools",
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", 
        "@modelcontextprotocol/server-filesystem@latest",
        "{{ .PROJECT_ROOT }}"
      ]
    },
    "ship-security": {
      "command": "ship",
      "args": ["mcp", "security", "--stdio"]
    },
    "database": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres@latest"
      ],
      "env": {
        "POSTGRES_URL": "{{ .DATABASE_URL }}"
      }
    }
  }
}

Environment Variables (variables.yml):

PROJECT_ROOT: "/home/user/projects"
DATABASE_URL: "postgresql://user:pass@localhost:5432/dev_db"
AWS_REGION: "us-east-1"
SLACK_WEBHOOK_URL: "https://hooks.slack.com/services/..."
LOG_LEVEL: "debug"

Environment Operations

Creating Environments

# Create new environment
stn env create production

# Create from template
stn env create staging --from-template development

# Create with custom configuration
stn env create testing --config ./custom-template.json