22
33## What This Is
44
5- An open-source (Apache 2.0) enterprise agent automation platform built in Rust. Organizations define expert agents in YAML — composing skills, tools, and MCP servers — then run them on cron, on events, or on demand. Single binary deployment, built-in cost tracking, multi-channel delivery (Slack, Teams, Telegram, Discord, WhatsApp ), and a Svelte command center for fleet management.
5+ An open-source (Apache 2.0) enterprise agent automation platform built in Rust. Organizations define expert agents in YAML — composing skills, tools, and MCP servers — then run them on cron, on events, or on demand. Single binary deployment, built-in cost tracking, multi-channel delivery (Slack, Telegram, Discord), and a Svelte command center for fleet management. Agents authenticate via API keys or existing LLM subscriptions (Claude, ChatGPT, Gemini) through OAuth .
66
77## Core Value
88
99Let any technical organization automate operational tasks with AI agents — without writing Python, without managing infrastructure, without giving up control. Define in YAML, run as a binary, track costs, keep humans in the loop.
1010
11- ## Current Milestone: v2.0 OpenAgentiX
12-
13- ** Goal:** Transform AOF into an enterprise agent automation platform with YAML-first agent composition, skills + tools + MCP, scheduled/event-driven execution, cost tracking, and a Svelte command center.
14-
15- ** Target features:**
16- - Rebrand to OpenAgentiX with new agent YAML spec
17- - Skills composition system (composable capability packs)
18- - Cron/event-driven agent triggers (not just chat)
19- - Per-agent cost tracking + budgets (inspired by ClawWork)
20- - OTel telemetry + agent traces
21- - WASM sandbox for untrusted tools (inspired by IronClaw)
22- - Approval workflows / human-in-the-loop
23- - Smart model routing (complexity scoring)
24- - Multi-channel gateway (Slack, Teams, Telegram, Discord, WhatsApp)
25- - Svelte command center (agent builder, run history, costs, scheduler)
26-
2711## Requirements
2812
2913### Validated
@@ -41,80 +25,77 @@ Let any technical organization automate operational tasks with AI agents — wit
4125- Session management with resume capability — v1.0
4226- WebSocket control plane — v1.0
4327- Production security (seccomp, capability dropping, credential audit) — v1.0
28+ - GitAgent-compatible agent directories with ReAct loop engine — v2.0
29+ - Skills composition with 8 built-in packs + WASM sandbox isolation — v2.0
30+ - Event-driven triggers (cron, webhook, GitHub, Jira, agent-to-agent) — v2.0
31+ - Multi-agent coordination with vector memory and semantic recall — v2.0
32+ - Per-call/run/agent cost tracking with budget enforcement — v2.0
33+ - OpenTelemetry traces/metrics with CLI trace viewer — v2.0
34+ - Security: SSRF protection, AES-256-GCM secrets, comprehensive audit trail — v2.0
35+ - Human-in-the-loop approval workflows (3 autonomy modes) — v2.0
36+ - Multi-channel gateway: Slack, Telegram, Discord bi-directional — v2.0
37+ - Svelte Command Center: dashboard, agent builder, cost charts, trace viewer, approval queue — v2.0
38+ - LLM subscription proxy: OAuth auth for Claude/ChatGPT/Gemini subscriptions — v2.0
39+ - kubectl-style ` agentix ` CLI with 15+ commands — v2.0
4440
4541### Active
4642
47- (Defined in REQUIREMENTS.md for v2.0 )
43+ (Defined in REQUIREMENTS.md for next milestone )
4844
4945### Out of Scope
5046
5147- Agent personas / SOUL.md / personality system — pivoted away from "fun team" model
5248- React Mission Control — replaced by Svelte command center
5349- Squad Chat UI — not enterprise-relevant
54- - Kanban / workflow builder UI — defer to v2.1+
55- - Multi-tenancy / MSP isolation — v2.5 enterprise
56- - SSO / SAML / LDAP — v2.5 enterprise
57- - Mobile native app — web + messaging channels sufficient
58- - Voice/talk mode — text-based for v2.0
50+ - Python SDK — Rust-native, no Python dependency is a differentiator
5951- Public agent marketplace — security concerns, community registry first
6052- A2A protocol — emerging standard, defer until stable
53+ - Voice/talk mode — text-based for enterprise automation
54+ - Mobile native app — web + messaging channels sufficient
6155
6256## Context
6357
64- ** Previous milestone:** v1.0 "Humanized Interfaces" shipped 2026-02-22 (12 phases, 55 plans, 164K LOC). Proved the Rust + multi-channel architecture works. The persona/personality direction is being pivoted away from.
58+ ** v1.0** shipped 2026-02-22: 12 phases, 55 plans, 164K LOC. Proved Rust + multi-channel architecture.
59+ ** v2.0** shipped 2026-03-23: 11 phases, 67 plans, 78K LOC (rewrite). Enterprise pivot — GitAgent agents, skills, triggers, cost tracking, telemetry, security, approvals, multi-channel gateway, Svelte dashboard, OAuth subscription proxy.
60+
61+ ** Total:** 23 phases, 122 plans across 2 milestones.
62+
63+ ** Tech stack:** Rust (agentix-core, agentix-llm, agentix-mcp, agentix-runtime, agentix-memory, agentix-triggers, agentix CLI), SvelteKit 5 (Command Center), SQLite (persistence).
6564
6665** Market landscape (researched 2026-03-12):**
6766- Python-dominant (LangChain, LangGraph, CrewAI, Agno, AutoGen) — no Rust-native competitor
68- - 45% of developers who try LangChain never use it in production (abstraction bloat)
67+ - 45% of developers who try LangChain never use it in production
6968- 75% of enterprise leaders cite security/compliance as top AI priority
70- - Enterprises need: cost tracking, audit trails, RBAC, event-driven triggers, deployment flexibility
71- - MCP becoming standard (97M monthly SDK downloads). A2A emerging but nascent.
7269- No framework does config-first + enterprise security + cost tracking + event-driven well
7370
74- ** Competitive inspiration:**
75- - ClawWork: per-call/task/day cost tracking, quality thresholds, ROI metrics
76- - OpenFang: "Hands" (pre-built domain-complete agents), 16-layer security, workflow orchestration
77- - IronClaw: WASM sandbox, shared agentic loop, smart model routing, routines engine, cost guard
78- - ZeroClaw: trait-driven architecture, research phase, AgentBuilder pattern
79-
80- ** Target users:**
81- - Platform engineering teams (Netflix, Dropbox, Adobe scale)
82- - SRE/DevOps teams (regulated industries — Visa, Morgan Stanley)
83- - Startup CTOs (5-person team, need automation fast)
84- - Enterprise architects (standardize agents across 15+ teams)
85- - SI/MSP/GCC (manage agents for multiple clients)
86-
87- ** Example agents enterprises want to build:**
88- - DBA optimizer (analyze RDS config, recommend/apply optimizations)
89- - Cost anomaly detector (daily AWS cost analysis, alert on spikes)
90- - Compliance scanner (CIS benchmark checks, file Jira tickets)
91- - Security scanner (vulnerability detection, remediation tickets)
92- - Self-healing infrastructure (detect + remediate common failures)
93- - Deployment agent (canary rollouts with approval gates)
71+ ** Target users:** Platform engineering teams, SRE/DevOps (regulated industries), startup CTOs, enterprise architects, SI/MSP/GCC.
72+
73+ ## Key Decisions
74+
75+ | Decision | Rationale | Outcome |
76+ | ----------| -----------| ---------|
77+ | Rust single binary | No Python, no runtime deps, 180ms cold start, 40MB idle | ✓ Good |
78+ | YAML-first agent definition | Enterprises want declarative, version-controllable config | ✓ Good |
79+ | Svelte for command center | Lighter than React, better DX, user preference | ✓ Good |
80+ | Skills composition (not monolithic agents) | Build expert agents from capability packs | ✓ Good |
81+ | WASM sandbox for tools | Lightweight isolation without Docker overhead | ✓ Good |
82+ | OTel native telemetry | Standard, exportable to Grafana/Datadog/any backend | ✓ Good |
83+ | Smart model routing | Route simple->cheap, complex->expensive | ✓ Good |
84+ | Cost tracking built-in | Not an add-on. Per-call, per-task, per-agent | ✓ Good |
85+ | Pivot from personas to enterprise | Personality-driven agents don't solve enterprise problems | ✓ Good |
86+ | AES-256-GCM for secrets | Already in workspace, proven crypto | ✓ Good |
87+ | SQLite for all stores | Simple, embedded, zero-config persistence | ✓ Good |
88+ | OAuth subscription proxy | Reduce cost for users with existing LLM subscriptions | ✓ Good |
9489
9590## Constraints
9691
9792- ** Language** : Rust for core engine. Svelte for command center.
9893- ** License** : Apache 2.0 — open source core, enterprise features later
9994- ** Architecture** : Single binary, local-first. Server mode for teams.
100- - ** CLI style** : kubectl-style (` oax run agent` , ` oax apply -f agent.yaml` )
95+ - ** CLI style** : kubectl-style (` agentix run agent` , ` agentix apply -f agent.yaml` )
10196- ** No Python dependency** : Users should never need pip/venv/conda
102- - ** Backward compatibility** : Existing AOF agent YAML configs should still work
97+ - ** Backward compatibility** : Existing AOF agent YAML configs still work
10398- ** Cross-platform** : macOS, Linux, Windows
10499
105- ## Key Decisions
106-
107- | Decision | Rationale | Outcome |
108- | ----------| -----------| ---------|
109- | Rust single binary | No Python, no runtime deps, 180ms cold start, 40MB idle | — Pending |
110- | YAML-first agent definition | Enterprises want declarative, version-controllable config | — Pending |
111- | Svelte for command center | Lighter than React, better DX, user preference | — Pending |
112- | Skills composition (not monolithic agents) | Build expert agents from capability packs, not one agent with 100 tools | — Pending |
113- | WASM sandbox for tools | Lightweight isolation without Docker overhead, capability-based | — Pending |
114- | OTel native telemetry | Standard, exportable to Grafana/Datadog/any backend | — Pending |
115- | Smart model routing | Route simple→cheap models, complex→expensive. Cost optimization. | — Pending |
116- | Cost tracking built-in | Not an add-on. Per-call, per-task, per-agent. Enterprise requirement. | — Pending |
117- | Pivot from personas to enterprise | Personality-driven agents don't solve enterprise problems | ✓ Good |
118-
119100---
120- * Last updated: 2026-03-12 after v2.0 milestone start *
101+ * Last updated: 2026-03-23 after v2.0 milestone*
0 commit comments