Quick Start

Setup each machine

# Mac Mini — always-on orchestrator
./bin/devstation.sh --node mini setup

# Mac Studio — always-on worker (pulls Ollama models)
./bin/devstation.sh --node studio setup

# MacBook Air — your dev machine (installs OpenCode)
./bin/devstation.sh --node air setup

Configure .env

Copy .env.example to .env on each machine. Required values:

• GITHUB_TOKEN — GitHub personal access token
• TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID — notifications
• STUDIO_TAILSCALE_IP + TAILSCALE_IP — Tailscale addresses
• LINEAR_API_KEY + LINEAR_TEAM_ID — ticket source
• DEEPSEEK_API_KEY + CLAUDE_API_KEY — cloud LLM fallbacks

Start services

# On Mac Mini and Mac Studio
./bin/devstation.sh up

Configure projects

Edit projects.yaml to map Linear teams to GitHub repos.

Import n8n workflow

In n8n UI (http://{TAILSCALE_IP}:5678), import linear-pipeline/linear_to_opencode.json.

Verify

./bin/devstation.sh doctor

What's next?

• Architecture Overview — understand the full system design
• Workflow — how the pipeline processes tickets
• Deployment — hardware requirements and setup order
• Operations Guide — daily operations and remote control