Skip to main content

​
AI-Assisted Development

  • AGENTS.md - Full SDK context for AI coding assistants
  • llms.txt - Lightweight site index for LLMs
  • llms-full.txt - Complete documentation in a single file
  • MCP Server - Connect your assistant to Circuit docs via MCP
Circuit agents are programs that run on Circuit’s infrastructure, read wallet balances, and request transactions on behalf of users. You write a run function, Circuit calls it on a recurring interval, and any transactions your code requests are routed through a secure signing layer - your agent never touches private keys. You can go from zero to an uploaded agent in about 10 minutes.

​
What you’ll need

  • Bun (required for the CLI and TypeScript agents)
  • Python 3.14 and uv (for Python agents)
  • A Circuit account with a wallet for hosted testing and uploading
  • The Circuit CLI: bun install -g @circuitorg/agent-cli

​
Contents

  1. Installation: Install the tools, create your first agent, and configure circuit.toml.
  2. Core Concepts: Understand sessions, the run loop, wallets, and execution modes.
  3. Examples: Working example agents.
  4. SDK Reference: Complete method reference for the Agent SDK.
  5. CLI Reference: Documentation for the CLI tool.
  6. Advanced: Multi-agent monorepos and troubleshooting.
  • CLI: npm package - the only install; the SDK is provided by the CLI locally and by the hosted runtime when deployed