Arcie

The electronic line — build agents at the speed of light.

Site: cencori.com/arcie · Docs: cencori.com/arcie/docs

npx arcie@latest init my-agent

my-agent/
├── agent/
│   ├── agent.ts           # model + config
│   ├── instructions.md    # system prompt
│   ├── tools/             # what it can do
│   ├── knowledge/         # what it knows
│   ├── subagents/         # who it delegates to
│   ├── channels/          # HTTP, Slack, WhatsApp
│   ├── schedules/         # recurring jobs
│   ├── sessions/          # memory + session config
│   └── policies/          # guardrails, budgets, security
├── web/                   # chat UI (Next.js)
├── package.json
└── tsconfig.json

Quick Start

npx arcie@latest init my-agent
cd my-agent
npm run dev

Opens a web chat UI at http://localhost:5173.

Authoring

// agent/agent.ts
import { defineAgent } from "arcie";

export default defineAgent({
  model: "claude-sonnet-4-5",
  cencori: {
    project: "proj_abc",
    billing: { budget: "50.00/month" },
  },
});

// agent/tools/get_weather.ts
import { defineTool } from "arcie/tools";
import { z } from "zod";

export default defineTool({
  description: "Get the current weather for a city.",
  inputSchema: z.object({ city: z.string() }),
  async execute({ city }) {
    return { city, condition: "Sunny", temperatureF: 72 };
  },
});

Programmatic API

import { createAgent } from "arcie";

const agent = createAgent({
  model: "gpt-4o",
  tools: {
    greet: {
      description: "Greet someone",
      execute: ({ name }) => `Hello, ${name}!`,
    },
  },
});

const reply = await agent.generate("Say hi to Alice");

Subagents

Drop a specialist under agent/subagents/<id>/:

agent/subagents/researcher/
├── agent.ts          # defineAgent({ model, description })
├── instructions.md   # optional
└── tools/            # optional

Each subagent runs in a fresh, isolated session — the parent never sees the child's history. See docs/subagents.md.

Memory & Policies

// agent/sessions/config.ts
export default {
  maxTurns: 50,
  memory: { strategy: "lastN", limit: 20, workingMemory: true },
};

// agent/policies/index.ts
export default {
  inputGuards: ["no-email", "no-phone"],
  blockedTools: ["dangerous_tool"],
  allowedModels: ["claude-*", "gpt-4*"],
};

Docs

• Getting Started
• API Reference
• Project Layout
• Subagents

License

MIT