Claude Code

Claude Code extends through skills, MCP servers, and plugins; Smithers ships into all three. Fastest path:

bunx smthrs skills add
bunx smthrs mcp add --agent claude-code

Syncs generated Smithers CLI skill files to Claude’s skill location and registers the MCP server in ~/.claude.json. Restart Claude Code (or run /mcp) to list, run, watch, and approve workflows.

Curated onboarding skill

Teaches Claude the Smithers mental model and ships the full docs bundle next to it. init installs it automatically when Claude Code is detected:

bunx smthrs init

Claude loads a skill when its description matches the request. Once installed, ask for the outcome, “orchestrate an agent to add rate limiting and keep iterating until the tests pass”, and Claude reaches for Smithers itself.

Generated CLI skills

skills add syncs generated skill files for Smithers CLI command groups:

bunx smthrs skills add

Pass --no-global to scope skill files to the project.

Register the MCP server

mcp add writes this for you. By hand, register a server with the Claude CLI:

claude mcp add --transport stdio --scope user smithers \
  -- bunx smthrs --mcp

Or commit a project-scoped .mcp.json so the whole team gets it:

{
  "mcpServers": {
    "smithers": {
      "command": "bunx",
      "args": ["smthrs", "--mcp"]
    }
  }
}

The server exposes list_workflows, run_workflow, watch_run, list_pending_approvals, resolve_approval, explain_run, and more. Full reference: MCP Server. Claude Code CLI and MCP launches automatically persist Claude harness/session attribution when its native session environment is present. Supply an explicit --started-by-prompt (or MCP startedBy.prompt) only for deliberate launch context; it is never inferred from workflow input.

Claude Code plugin

A plugin bundles skill and MCP server into one install, namespaced smithers:. Manifest lives at .claude-plugin/plugin.json:

{
  "name": "smithers",
  "version": "0.2.0",
  "description": "Durable control plane for long-running coding agents"
}

A sibling .claude-plugin/.mcp.json wires the MCP server; the skill auto-discovers from the plugin’s skills/ directory. Neither is declared in plugin.json itself. Install from a marketplace and reload without restarting:

/plugin marketplace add smithersai/smithers
/plugin install smithers@smithersai
/reload-plugins

Worked examples: plugin (skill) and plugin (orchestrator).

Standing instructions

Add a line to CLAUDE.md noting Smithers handles durable, multi-step work:

## Orchestration
For multi-step, long-running, or human-in-the-loop agent work, use Smithers:
`bunx smthrs starters` lists ready-made workflows.

Smithers runs Claude Code too

Smithers also spawns Claude Code as a worker inside a workflow via ClaudeCodeAgent, with native session hijack:

import { ClaudeCodeAgent } from "smthrs";

const claude = new ClaudeCodeAgent({ model: "claude-fable-5" });

This bills your Claude Pro/Max subscription by default: ClaudeCodeAgent clears ANTHROPIC_API_KEY from the spawned process, so the CLI uses subscription auth with no API key. For side-by-side subscriptions, set one up with CLAUDE_CONFIG_DIR=<dir> claude plus /login, then pass configDir: "<dir>"; apiKey switches to Anthropic API billing instead. Call it once for a typed completion with no graph:

const { output } = await claude.generate({
  prompt: 'Reply with JSON: {"ok": true}',
  outputSchema: z.object({ ok: z.boolean() }),
  timeout: { totalMs: 60_000, idleMs: 30_000 },
});

See CLI Agents → Claude Code and Subscription-mode structured completion.

Start

Articles

Learn

Capabilities

Build Workflows

Run and Operate

Workflow Pack

Components

Integrations

Agent Support

Examples

Contributing

Curated onboarding skill

Generated CLI skills

Register the MCP server

Claude Code plugin

Standing instructions

Smithers runs Claude Code too

​Curated onboarding skill

​Generated CLI skills

​Register the MCP server

​Claude Code plugin

​Standing instructions

​Smithers runs Claude Code too

Curated onboarding skill

Generated CLI skills

Register the MCP server

Claude Code plugin

Standing instructions

Smithers runs Claude Code too