Introduction

Zett lets you define agents as files. There's no SDK to wire up and no DSL to learn — every part of an agent is a file in a predictable place, and Zett turns that directory into a running agent backed by Cencori.

npx arcie@latest init my-agent

The idea

An agent is a folder. What it is, what it can do, what it knows, and how it behaves are all expressed as files inside an agent/ directory:

my-agent/
└── agent/
    ├── agent.ts         # the model + Cencori config
    ├── instructions.md  # the system prompt
    ├── tools/           # what it can do
    ├── skills/          # what it knows
    ├── subagents/       # who it delegates to
    ├── channels/        # where it lives (HTTP, Slack…)
    ├── schedules/       # when it acts on its own
    ├── sessions/        # durable-execution config
    └── policies/        # security, budgets, guardrails

Zett discovers these slots, validates them, and assembles an agent manifest — the single object the runtime executes. Add a file, get a capability. Delete a file, remove it. Your agent is always exactly what's on disk.

Why filesystem-first

• No boilerplate. A defineTool in tools/get_weather.ts is a tool. There's nothing to register.
• Reviewable. Every capability is a file in version control. A diff shows precisely how an agent changed.
• Composable. Subagents are just nested agent folders. Knowledge is just markdown. Scaling up is adding directories, not rewriting code.
• Production-backed. Execution runs through Cencori's gateway and Sessions API, so you get billing, security policies, observability, and durable sessions without building any of it.

How it fits with Cencori

Zett is the authoring layer; Cencori is the runtime. When your agent takes a turn, Zett loads the manifest and calls the Cencori Sessions API, which routes the model request, applies your security and budget policies, and streams events back. You bring the agent definition; Cencori brings the infrastructure.

Next steps

• Installation — create your first project.
• Quickstart — from zero to a running agent in a few minutes.
• Project Layout — the full agent/ directory reference.