Get started

Add Recurse to your agent

Connect Recurse, then continue in your own coding agent. Read the skill.

SKILL.md

Create your access key

Sign up, choose your agent and select Connect. Review and send the prefilled setup request in your agent. Its Tools-only key stays private and remains valid until revoked.

Set up your agent

Shell
curl -fsSL https://recurse.run/tools/SKILL.md
CLI

Connect your coding agent

Use Recurse SDK 0.2.8 or newer. The prefilled Setup request guides your agent through secure key import with recurse tools login --key-stdin and registration of the Tools MCP bridge. Keep the key out of shell arguments, files and logs.

Shell
uv tool install --upgrade --python 3.14 "recurse-sdk>=0.2.8"
codex mcp add recurse-tools -- recurse tools mcp serve

uv selects Python 3.14 for the isolated CLI environment and can download it if needed.

CLAUDE.mdAGENTS.md

Give your agent a task

Start with an example or describe your task. Your agent discovers eligible APIs, writes private Python, and returns the result in your conversation.

Use Recurse to discover APIs and build a private Python tool for my task. Ask for the required inputs and a total spending cap before chargeable preparation or execution.

Pay for what you use.

One balance covers API calls and tool execution. Provider costs pass through at 1× and compute is charged at 4× its cost basis. Preparation has its own charge and can incur cost even if it fails. Your agent asks for a total spending cap before chargeable work.

Setup and API discovery do not run a paid task. Manage keys in Setup and review results and charges in Activity. Existing agent deployments use the separate Recurse Agents instructions.

Give your agent its next job.

Connect Recurse to your agent, and then ask it to do something for you there.