# Claude Code Integration
> Monitor and manage Syntropic137 from inside Claude Code with slash commands and domain skills.

The [Syntropic137 Claude Code plugin](https://github.com/syntropic137/syntropic137-claude-plugin)
adds slash commands and domain knowledge to Claude Code, turning it into a Syntropic137
orchestrator — create workflows, kick off executions, monitor costs, and troubleshoot
issues without leaving your editor.

<Callout type="info">
This is a **Claude Code plugin** — it teaches Claude Code how to operate Syntropic137.
It is not a [Syntropic137 plugin](/docs/guide/plugins) (workflow package). See
[Plugin Ecosystem](/docs/guide/plugins#two-plugin-boundaries) for how these two concepts
differ.
</Callout>

## Installation

The recommended way to install the plugin is through the setup system, which handles
everything automatically:

```bash
npx @syntropic137/setup
```

The setup wizard detects the `claude` CLI and offers to install the plugin for you. You
can also install the plugin step specifically:

```bash
npx @syntropic137/setup plugin
```

### Manual Installation

If you prefer to install directly from the Claude Code marketplace:

```bash
claude plugin marketplace add syntropic137/syntropic137-claude-plugin
claude plugin install syntropic137
```

Or from a local clone (for development):

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

## Slash Commands

The plugin provides 7 commands for quick platform interaction:

| Command | Purpose | Example |
|---------|---------|---------|
| `/syn-setup` | Open the setup wizard | `/syn-setup` |
| `/syn-status` | Platform health — containers, API, recent activity | `/syn-status` |
| `/syn-health` | Deep API diagnostics | `/syn-health` |
| `/syn-costs` | Cost tracking and breakdown | `/syn-costs summary` |
| `/syn-sessions` | Session listing and details | `/syn-sessions list` |
| `/syn-metrics` | Aggregated metrics across executions | `/syn-metrics --workflow <id>` |
| `/syn-observe` | Debug a specific agent session | `/syn-observe <session-id> tools` |

Commands resolve the API URL automatically — from `SYN_API_URL` env var, your `~/.syntropic137/.env` config, or the default `http://localhost:8137`.

## Domain Skills

The plugin includes 7 domain skills that Claude loads contextually based on your questions:

| Skill | Activates When You Ask About |
|-------|------------------------------|
| **workflow-management** | Creating workflows, YAML schema, prompt files, `$ARGUMENTS` substitution |
| **execution-control** | Running workflows, monitoring progress, pause/resume/cancel, debugging failures |
| **observability** | Sessions, tool timelines, token metrics, cost breakdowns, two-lane architecture |
| **organization** | Org/System/Repo hierarchy, cost rollup, contribution tracking |
| **github-automation** | GitHub App setup, webhook triggers, safety limits, input mapping |
| **setup** | `npx @syntropic137/setup`, Docker stack, secrets, troubleshooting |
| **platform-ops** | Service map, workspace lifecycle, token injection, QA commands |

Skills are not invoked directly — Claude uses them automatically when your question matches their domain. For example, asking "create a workflow that reviews PRs" activates both **workflow-management** and **github-automation** skills.

## Session Start Hook

The plugin runs a health check every time Claude Code starts a new session. It pings your Syntropic137 API and silently confirms it's reachable. If the platform is down, you'll see a notification suggesting `/syn-setup` or `/syn-status`.

## Updating

```bash
claude plugin update syntropic137
```

## Source

The plugin source is in the [`syntropic137-claude-plugin`](https://github.com/syntropic137/syntropic137-claude-plugin)
repository, also available as a submodule at `lib/syntropic137-claude-plugin` in the
monorepo.