Setup CLI
npx @syntropic137/setup — interactive CLI for installing and managing the Syntropic137 platform.
The setup CLI is a zero-dependency Node.js tool for bootstrapping and managing your Syntropic137 installation. It wraps Docker Compose operations with an interactive TUI.
Usage
npx @syntropic137/setup [command]Running without a command shows an interactive menu.
Commands
| Command | Purpose |
|---|---|
init | Full setup wizard — Docker check, secrets, API key, GitHub App, plugin, pull images, start stack |
status | Show running services (docker compose ps) |
start | Start the stack |
stop | Stop the stack |
logs | Tail service logs (docker compose logs -f) |
update | Pull latest container images and restart |
plugin | Install or update the Claude Code plugin |
github-app | Create or reconfigure the GitHub App |
init Options
npx @syntropic137/setup init [options]
--org <name> Create GitHub App under an organization (default: personal account)
--name <app-name> GitHub App name (default: syntropic137)
--dir <path> Install directory (default: ~/.syntropic137)
--skip-github Skip GitHub App creation
--skip-docker Generate config files only — don't pull images or start services
--webhook-url <url> Set webhook URL for the GitHub AppWhat init Creates
~/.syntropic137/
├── docker-compose.syntropic137.yaml # Service definitions
├── selfhost-entrypoint.sh # Secret injection script
├── selfhost.env.example # Configuration reference
├── .env # Your configuration (chmod 600)
├── init-db/
│ └── 01-create-databases.sql # Database initialization
├── secrets/ # All chmod 600
│ ├── db-password.secret
│ ├── redis-password.secret
│ ├── minio-password.secret
│ └── github-app-private-key.pem # If GitHub App configured
└── workspaces/ # Agent workspace mountReconfiguring
Run init again to reconfigure. The wizard detects an existing installation and asks whether to reconfigure from scratch or update specific settings. Existing secrets are backed up to .bak files.
Planned: Tunnel management and secrets reconfiguration directly from the interactive TUI. Tracked in syntropic137/syntropic137#422.
Syntropic137 Docs v0.18.0 · Last updated March 2026