fuseraft-cli Documentation¶
fuseraft-cli is a multi-agent orchestration CLI built on Microsoft Agent Framework and Microsoft.Extensions.AI. You define teams of AI agents in a YAML config — each agent has a system prompt, a model, and a set of plugins — and the orchestrator drives them through a conversation until the task is done.
This is a personal project and a work in progress, suited for experimentation and automating well-defined tasks.
What it does¶
- Runs any number of agents in a coordinated loop driven by keyword routing, LLM-based selection, or fully autonomous Magentic orchestration
- Gives each agent access to tools: filesystem, shell, git, HTTP, JSON, search, Docker sandboxes, MCP servers
- Saves a checkpoint after every turn so sessions can always be resumed
- Tracks token usage and estimated cost; can enforce a hard spending cap
- Enforces correctness with routing validators that block handoffs unless evidence is present
- Sandboxes agent file and shell access to a configured directory tree
- Applies per-agent execution rings, prompt injection detection, and a hash-chain audit log via the Agent Governance Toolkit
- Supports mixing any combination of LLM providers per agent
Guides¶
| Doc | What it covers |
|---|---|
| Getting Started | Prerequisites, installation, first run |
| CLI Reference | All commands and flags |
| Configuration | Full config schema (YAML and JSON) |
| Models & Providers | Model configuration and auto-detection |
| Plugins | All built-in tools agents can call |
| Strategies | Selection and termination strategies |
| Routing Validators | Anti-hallucination handoff guards |
| MCP Integration | Connecting external MCP servers |
| Security & Sandbox | File and network containment |
| Governance | Execution rings, audit log, circuit breaker, SLO tracking |
| Sessions | Resumption, HITL, cost tracking, compaction |
| Context Store | Importing reference material for agents |
| Examples | Ready-to-use config examples |