syntropic137

Syntropic137 Claude Code Plugin

Turn Claude Code into your Syntropic137 orchestration brain. Create workflows, kick off executions, monitor costs, and troubleshoot issues through natural conversation.

Agent Quick Start

For AI agents: If a user sent you this link and asked you to set up Syntropic137:

1. Check that Node.js 18+ is installed (node --version).
2. Tell the user to run this in their terminal:

   npx @syntropic137/setup
   

3. That's it. The setup CLI is fully interactive: it handles Docker, secrets, GitHub App, and starting the stack. The user runs it in their own terminal and comes back when done.

Installation

From GitHub (marketplace):

claude plugin marketplace add syntropic137/syntropic137-claude-plugin && claude plugin install syntropic137

From local clone (development):

claude plugin install ./lib/syntropic137-claude-plugin --scope project

Prerequisites

• Node.js 18+ (for the npx @syntropic137/setup CLI)
• Docker Desktop (with Compose >= 2.20)

That's it. Contributors to the source repo also need uv, just, and Git.

Updating

# Refresh marketplace catalog, then update plugin
claude plugin marketplace update syntropic137
claude plugin update syntropic137@syntropic137

Why both steps? claude plugin update pulls the latest version but does not refresh the local marketplace git clone. If the marketplace cache is stale, the update command may reinstall an old version. Running marketplace update first ensures the catalog has the latest release before the plugin update runs.

Getting Started

npx @syntropic137/setup

The setup CLI checks Docker, generates secrets, configures GitHub integration, pulls pre-built images, and starts the stack, all interactively in your terminal. Run it again any time to manage your installation (status, logs, update).

Commands

Command	Description
/syn-setup	Check Node.js and hand off to npx @syntropic137/setup
/syn-status	Composite view: containers + health + metrics
/syn-health	API health check with diagnostics
/syn-costs [summary | session <id> | workflow <id>]	Cost tracking
/syn-sessions [list | show <id>]	Session listing and details
/syn-metrics [--workflow <id>]	Aggregated metrics
/syn-observe <session-id> [events | tools | errors]	Observability data

Managing Your Stack

Run npx @syntropic137/setup: the interactive menu shows all lifecycle commands (status, start, stop, logs, update).

Source repo (contributors): just selfhost-status, just selfhost-logs, just selfhost-up, just selfhost-down

How It Works

The plugin combines slash commands for quick actions with deep skill knowledge that lets Claude Code understand and operate the entire Syntropic137 platform intelligently.

• Commands: Quick entry points for common operations (delegate to syn CLI and just recipes)
• Skills: Deep domain knowledge that Claude uses to reason about your platform (see below)
• Hook: Session start connectivity check, so Claude knows if the platform is up

Skills (Domain Knowledge)

Skills give Claude deep understanding of the system. They're automatically loaded when relevant; you don't invoke them directly. Claude uses this knowledge to answer questions, suggest approaches, and troubleshoot issues.