Documentation
Armament is a terminal-native AI orchestrator. It manages multiple LLM providers, organizes work into IRC-style channels with dedicated agents, and supports scriptable automation through .arma and .armaflow files.
Quick Links
Getting Started Install and run your first session. Configuration Providers, themes, permissions, and workspace setup. Commands All built-in slash commands. Scripting .arma scripts: aliases, triggers, keybindings, macros. Workflows .armaflow: spawn chains, parallel execution, approval gates. MCP Servers Connect external tools via stdio, SSE, or HTTP.
Architecture
Armament is built on a three-layer stack. Armament provides the terminal UI, channel system, and scripting. Iteratio is the agent execution loop with a pluggable step pipeline and plugin system. Flight Controller abstracts LLM providers with routing, rate limiting, and fallback chains.
| Layer | Responsibility |
|---|---|
armament | Terminal UI, channel system, rendering, themes, scripting (arma/armaflow), command palette, session management, budget tracking, permissions, MCP integration, workflow runtime |
iteratio | Agent execution loop (InversifyJS DI), step pipeline, 15 plugins, tool execution, event bus, hook system, context window management, state management |
flight-controller | LLM provider abstraction (Bedrock, Anthropic, OpenAI, Gemini), model routing, rate limiting, cost tracking, auth (SSO, OAuth), error handling with fallback chains |
Key Capabilities
- Multi-provider — Bedrock, Anthropic, OpenAI, Gemini, Ollama simultaneously
- IRC-style channels — #general, #control, #logs with per-channel agents
- MCP integration — stdio, SSE, HTTP transports with OAuth2
- Scripting — aliases, triggers, keybindings, timers, macros via .arma files
- Workflow orchestration — spawn, chain, wait, pipe, parallel, approval gates
- Permission system — human-in-the-loop approval with configurable risk levels
- Session persistence — restore, compaction, snapshots
- Theme system — 8 themes with per-character 24-bit gradient rendering
- Budget tracking — per-interaction and per-session cost display
- Plugin system — hooks, events, custom commands, external integrations