Using Coding Agents

Hatchet is designed to work well with AI coding agents. This page covers how to give your agent access to Hatchet documentation and step-by-step skills for common CLI operations.

Prerequisite: The hatchet skills install and hatchet docs install commands require the Hatchet CLI. See the CLI reference for installation instructions.

Agent Skills

Agent skills are reference documents that teach AI coding agents how to use the Hatchet CLI — triggering workflows, starting workers, debugging runs, and more.

Run the following command in your project root to install the skill package:

hatchet skills install

This creates a skills/hatchet-cli/ directory with step-by-step reference files and appends a section to your project’s AGENTS.md (and CLAUDE.md) pointing agents to the right file for each task.

Install to a custom directory:

hatchet skills install --dir ./my-project

After installation, commit the skills/ directory and AGENTS.md to version control so all agents working in the repo benefit automatically.

Available references

Reference	When to use
`references/setup-cli.md`	Installing the CLI, creating or listing profiles
`references/start-worker.md`	Starting a dev worker for local development
`references/trigger-and-watch.md`	Triggering a workflow and polling for completion
`references/debug-run.md`	Diagnosing a failed, stuck, or unexpected run
`references/replay-run.md`	Re-running a previous workflow with same or new input

MCP Server

Hatchet documentation is available as an MCP (Model Context Protocol) server, so AI coding assistants like Cursor and Claude Code can search and reference Hatchet docs directly.

MCP endpoint: https://docs.hatchet.run/api/mcp

hatchet docs install cursor

This creates a .cursor/rules/hatchet-docs.mdc file and prints the one-click deeplink.

Open Cursor Settings

Go to Cursor Settings → MCP → Add new MCP server.

Add the server configuration

{
  "hatchet-docs": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://docs.hatchet.run/api/mcp"
    ]
  }
}

Use in chat

Reference Hatchet docs in any Cursor chat with @hatchet-docs or ask questions and the agent will automatically search the docs.

hatchet docs install claude-code

If claude is on your PATH, this runs the command automatically. Otherwise it prints it for you to copy.

For any AI tool that supports llms.txt, Hatchet docs are available at:

Resource	URL
llms.txt (index)	docs.hatchet.run/llms.txt
llms-full.txt (all docs)	docs.hatchet.run/llms-full.txt
Per-page markdown	`docs.hatchet.run/llms/{section}/{page}.md`
MCP endpoint	`https://docs.hatchet.run/api/mcp`

Every documentation page also includes a <link rel="alternate" type="text/markdown"> header pointing to its markdown version, and a “View as Markdown” link at the top of the page.

llms.txt