open source · apache-2.0 · v0.7.6 on npm

Ship an agent.yaml, not a prototype.

Declaragent is a declarative, git-versioned runtime for AI agents. One agent.yaml in your repo describes identity, tools, skills, channels, permissions, secrets and deploy — no hidden console, no vendor dashboard. git log is the source of truth.

npm i -g @declaragent/cli

single-machine production-ready · enterprise primitives in preview · declaragent.dev →

01

Quickstart →

The 10-minute path. Install, declaragent init, run it, watch it with Prometheus + OTel.

02

Reference →

The agent.yaml + fleet.yaml schema, every CLI verb, env vars, providers, MCP, RPC, observability.

03

Cookbook →

Templates and recipes — concierge, PR-review, multi-tenant, GitOps, SIEM export, zero-trust RPC, cross-host fleets.

04

Troubleshooting →

Error-code reference, install + deploy flowcharts, and the operational runbook index.

The five pillars

Define agents — capabilities, skills, inbound + outbound channels, peers✓ single-machine◐ enterprise

Deploy + monitor fleets — up/down/ps/logs, Prometheus, OpenTelemetry✓ single-machine◐ enterprise

Independent agents — own session + secrets; optional delegation via Kafka/NATS/SQS/AMQP/MQTT RPC✓ single-machine◐ enterprise

Tools + MCP — 8 built-ins, MCP (stdio/HTTP/SSE/OAuth PKCE), npm plugins✓ single-machine◐ enterprise

Conversational builder — describe a fleet in chat, review the plan, git commit✓ single-machine◐ enterprise

Honest status. Single-machine production is shipping on npm today. Enterprise is ◐, on purpose — the primitives are built and tested, but not yet soak-proven at scale, third-party pen-tested, or running in anyone's production but the maintainer's. Every grade is backed by a test or a file:line in AGENTS.md. See the changelog for per-release deltas.