declaragent d9t

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

Stop shipping agent
prototypes.
Ship an agent.yaml.

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

single-machine production-ready  ·  enterprise primitives in preview  ·  seeking first adopters

declaragent — zsh 
▋

// the declarative loop

Describe what you need. Review the plan. git commit.

  1. 01

    Describe

    Talk to the builder in plain language, or hand-write the YAML. It scaffolds skills, sources, channels, MCP servers and peers.

    $ declaragent build
› a Slack bot that triages
  GitHub issues every morning…
  2. 02

    Review the plan

    Every change is a reviewable diff against your repo before anything runs. No magic, no hidden state — what you read is what deploys.

    + agents/triager/agent.yaml
+ agents/triager/skills/triage.md
  fleet.yaml (+1 agent)
  3. 03

    Apply & operate

    One CLI for the whole lifecycle — bring it up, watch it, ship it. Prometheus, OTel, audit and circuit breakers are on by default.

    $ declaragent up -d
$ declaragent logs -f
$ declaragent deploy gcp-cloud-run
one binary, every step init→auth→up→ps / logs→events / audit→fleet→deploy

// what's in the box

Everything an agent needs — declared, not wired by hand.

Four groups, no duplication. Each capability ships in @declaragent/[email protected] and is graded in the status ledger below.

⌥ Define

  • agent.yaml — identity, model, temperature, deploy
  • Markdown skills — routed by event & intent
  • npm plugins — drop-in capability packages
  • MCP servers — stdio / HTTP / SSE / OAuth PKCE
  • 8 built-in tools — read, write, bash, grep…

⇄ Connect

  • Event sources — webhook, cron, file-watch
  • Brokers — Kafka, NATS, JetStream, SQS, AMQP, MQTT
  • Chat channels — Slack, Telegram, Discord, WhatsApp
  • Agent-to-agent RPC — independent agents, optional delegation

◎ Run & observe

  • Prometheus /metrics on by default
  • OpenTelemetry traces per turn
  • Circuit breakers + per-tool & provider rate limits
  • Dispatch DLQ — list, requeue, drop

⛨ Govern

  • Hash-chained audit — tamper-evident, GDPR-erase-safe
  • Multi-tenant isolation + per-tenant quotas
  • Secrets — Vault, AWS SM, GCP SM resolvers
  • Permission gate — every tool call, every turn

// receipts, not promises

The honest status ledger

Five pillars, graded twice: where it runs on one machine, and where it stands for multi-host enterprise scale. ✓ shipped ◐ partial ○ tracked

Pillar single-machine enterprise
Define agentscapabilities, skills, channels, peers ✓ shipped ◐ SSO-bridged channel perms in progress
Deploy + monitor fleetup/down/ps/logs · Prometheus · OTel ✓ shipped ◐ cross-host fan-out live · traffic-split canary tracked
Independent agentsmemory · Kafka/NATS/SQS/AMQP/MQTT RPC ✓ shipped ◐ 24h Kafka soak still accruing green runs
Tools + MCP8 built-ins · MCP · plugins · auto-recovery ✓ shipped ◐ approval workflows on the roadmap
Conversational builderchat → deployable fleet ✓ shipped ◐ fixture polish open, non-blocking

§ The honesty clause

Single-machine production is real and shipping on npm today. Enterprise is ◐, on purpose: the primitives are built and tested, but they aren't yet soak-proven at scale, third-party pen-tested, or running in anyone's production but the maintainer's. We grade against AGENTS.md — every ✓ links to a test or a file:line. When a soak run goes red, the grade is supposed to move with it, not the marketing.

// try it — runs entirely in your browser

Paste a fleet.yaml. Validate it here.

The same manifest checks the CLI runs, ported to the page. Nothing leaves your tab.

fleet.yaml
findings

    // $ npm i -g @declaragent/cli

    Built primarily by an agent, for people who run agents.

    An unusually thoughtful declarative runtime with serious primitives — open source, 0.x, looking for its first production users. If that's you, we'd love to hear it.

    ★ Star on GitHub Read the quickstart @declaragent/cli