Getting Started

Syntropic137 orchestrates Claude Code sessions inside isolated Docker workspaces — giving you scalable, observable, trigger-driven AI agent execution. Each workflow phase runs in its own container with injected credentials, captured output, and full token/cost tracking. Claude Code is currently the only supported agent provider; OpenCode support is planned next.

npx @syntropic137/setup

This opens an interactive terminal with arrow-key navigation, styled prompts, and progress tracking. Choose from available commands or jump straight to a full install with init.

Available Commands

npx @syntropic137/setup init        # Full interactive install wizard
npx @syntropic137/setup status      # Show running services
npx @syntropic137/setup start       # Start the stack
npx @syntropic137/setup stop        # Stop the stack
npx @syntropic137/setup logs        # Tail service logs
npx @syntropic137/setup update      # Pull latest images and restart
npx @syntropic137/setup github-app  # Configure GitHub App integration
npx @syntropic137/setup plugin      # Install Claude Code plugin

Prerequisites

You need three things installed on your machine:

• Node.js 18+ — for running the setup CLI
• Docker — for isolated agent workspaces
• Docker Compose v2.20+ — for orchestrating the service stack

Install

npx @syntropic137/setup init

The init wizard walks you through the full setup step-by-step:

1. Docker check — verifies Docker and Compose are available
2. Directory setup — creates ~/.syntropic137/ with config, secrets, and workspace directories
3. Secret generation — creates cryptographically random passwords for Postgres, Redis, and MinIO (stored as chmod 600 files)
4. API key — prompts for your ANTHROPIC_API_KEY
5. GitHub App — opens your browser to create a GitHub App via manifest flow for webhook-triggered workflows
6. Claude Code plugin (optional) — installs the Syntropic137 plugin for Claude Code if the claude CLI is detected
7. Pull & start — downloads container images and starts the full stack

Once complete, the dashboard is live at http://localhost:8137.

Run Your First Workflow

Install the example research workflow package and run it:

# Install the starter research workflow from GitHub
syn workflow install syntropic137/syntropic137 --ref main --path workflows/examples/research-package

# Run it with a task
syn workflow run research-package-v1 \
  --task "Investigate event sourcing patterns for building reliable agent systems"

The workflow executes in an isolated Docker workspace. Watch it in real time on the dashboard or via SSE:

# Stream execution events
curl -N http://localhost:8137/api/executions/{execution-id}/stream

What's Running

After setup, your ~/.syntropic137/ directory contains a Docker Compose stack with these services:

Next Steps

• Core Concepts — understand the mental model: events, workspaces, workflows
• Workflows — create and distribute workflow packages
• Claude Code Plugin — manage Syntropic137 from inside Claude Code
• GitHub Integration — trigger workflows from GitHub events
• Setup CLI Reference — all npx @syntropic137/setup commands