agent-stdlib AGENTS.md

Using agent-stdlib in any harness

This pack ships as a Claude Code plugin, but most of it is not Claude-specific. This file maps each part to its portable form for harnesses like OpenCode, Cursor, Cline, or a custom agent, on any tool-using model.

What ports cleanly

• MCP servers (mcp-servers/think, tool-gateway, code-execution): MCP is an open protocol, so any MCP client can mount them. See "Mount the MCP servers".
• Scripts (skills/*/scripts/*.py, scripts/locks.py): plain Python, run anywhere.
• scripts/autonomy_loop.sh: set AGENT_RUNNER to your headless agent CLI (it defaults to claude -p), e.g. AGENT_RUNNER="opencode run".

What needs re-wrapping

• Skills (skills/<name>/SKILL.md): the content is harness-neutral; the auto-loading and triggering is a Claude Code feature. Load the file as a rule or paste its body into your system prompt. See "Use the skills as plain content".
• hooks (hooks/): the classification logic in both the action gate and the injection screen is reusable; the hooks.json wiring and the input JSON shapes are Claude Code's. See "Port the hooks".
• Commands and agent (commands/, agents/): Claude Code formats that also rely on its subagent dispatch. Reuse the recipe inside them, not the files.

Use the skills as plain content

Every skill is a self-contained markdown procedure. Point your agent at skills/<name>/SKILL.md, or copy the body into your rules file (AGENTS.md, .cursorrules, a system prompt). The frontmatter description says when each skill applies, which is enough for a router to pick one. On a smaller model, load the one you need explicitly rather than expecting it to self-select.

Mount the MCP servers

The servers speak MCP over stdio and need uv, which installs each one's single dependency on first run. A vendor-neutral config most clients accept:

{
  "mcpServers": {
    "think": {
      "command": "uv",
      "args": ["run", "/abs/path/agent-stdlib/mcp-servers/think/server.py"]
    },
    "tool-gateway": {
      "command": "uv",
      "args": ["run", "/abs/path/agent-stdlib/mcp-servers/tool-gateway/server.py"]
    }
  }
}