Skip to main content

Documentation Index

Fetch the complete documentation index at: https://smithers.sh/llms.txt

Use this file to discover all available pages before exploring further.

Cursor extends through MCP servers, skills, rules, and the headless cursor-agent CLI. Smithers plugs into all of them. 
bunx smithers-orchestrator skills add --agent cursor
bunx smithers-orchestrator mcp add --agent cursor
That installs the skill set under ~/.cursor/skills/ and registers the MCP server. Reopen Cursor and the Smithers tools are available in the Agent.

​
Register the MCP server

mcp add writes the registration. To do it by hand, create .cursor/mcp.json in the project (or ~/.cursor/mcp.json for all projects) — note Cursor uses the mcpServers key: 
{
  "mcpServers": {
    "smithers": {
      "command": "bunx",
      "args": ["smithers-orchestrator", "--mcp"]
    }
  }
}
The server exposes the semantic tools — list_workflows, run_workflow, watch_run, resolve_approval, and the rest. See the MCP Server reference.

​
Install the skill

Cursor reads skills from ~/.cursor/skills/. Drop the onboarding skill in manually if you skip skills add: 
mkdir -p ~/.cursor/skills/smithers
curl -fsSL https://raw.githubusercontent.com/smithersai/smithers/main/skills/smithers/SKILL.md \
  -o ~/.cursor/skills/smithers/SKILL.md
curl -fsSL https://smithers.sh/llms-full.txt \
  -o ~/.cursor/skills/smithers/llms-full.txt

​
Add a project rule

A rule keeps Smithers in context whenever someone works in .smithers/. Create .cursor/rules/smithers.mdc: 
---
description: Use Smithers for durable, multi-step agent work
globs: .smithers/**/*
alwaysApply: false
---
Smithers is a durable control plane for long-running coding agents.
Run `bunx smithers-orchestrator starters` to list ready-made workflows.
Cursor also reads a plain AGENTS.md at the repo root as a simpler alternative — the same file Codex and Copilot use.

​
Headless: cursor-agent

cursor-agent runs Cursor’s agent in the terminal and honors the same .cursor/ config — so the MCP server, skill, and rule above all apply in CI: 
cursor-agent chat "use Smithers to run the implement workflow on this ticket"
Because cursor-agent is a CLI, Smithers can also spawn it as a worker inside a workflow via a compute task that shells out — there is no dedicated CursorAgent class yet.

​
See also