Multi-Agent Monorepo

Building one agent? The standalone project created by circuit new is all you need.

The CLI detects standalone projects and Bun workspaces. Each shared package owns its dependencies; agents import packages by name. Upload sends the workspace source and lockfile. Circuit installs the agent’s production dependencies into one code artifact.

Layout

my-agents/
├── package.json
├── bun.lock
├── agents/
│   └── trading-bot/
│       ├── index.ts
│       ├── circuit.toml
│       ├── DESCRIPTION.md
│       ├── package.json
│       └── tsconfig.json
└── packages/
    └── polymarket/
        ├── package.json
        └── src/index.ts

Declare the workspace at the repository root:

{ "private": true, "workspaces": ["agents/*", "packages/*"] }

Give each shared package its own manifest and dependencies:

{
  "name": "@lib/polymarket",
  "main": "src/index.ts",
  "dependencies": { "viem": "2.48.4" }
}

Depend on it from the agent:

{
  "name": "@circuit/agent-trading-bot",
  "main": "index.ts",
  "dependencies": {
    "@lib/polymarket": "workspace:*",
    "viem": "2.48.4"
  }
}

Import the package by name, without TypeScript path aliases:

import { getPositions } from "@lib/polymarket";

Run bun install at the root and commit bun.lock.

Forking a workspace agent

Forking or editing a published workspace agent copies its uploaded workspace config, lockfile, agent directory and shared packages into the builder. Bun links the packages as in the source monorepo. The fork is a snapshot, not a live link to the original repository.

Getting Started

Core Concepts

Examples

CLI Reference

SDK Reference

Advanced

Multi-Agent Monorepo

Layout

Forking a workspace agent

Next steps

​Layout

​Forking a workspace agent

​Next steps

Layout

Forking a workspace agent

Next steps