<p align="center" <img src="assets/brand/armadai-wordmark.svg" alt="ArmadAI" width="300" </p
<p align="center" AI agent orchestrator — define, manage and run specialized agents from Markdown files. </p
<p align="center" <a href="https://github.com/Dr0drigues/armadai/actions/workflows/ci.yml"<img src="https://github.com/Dr0drigues/armadai/actions/workflows/ci.yml/badge.svg" alt="CI"</a <a href="https://github.com/Dr0drigues/armadai/actions/workflows/audit.yml"<img src="https://github.com/Dr0drigues/armadai/actions/workflows/audit.yml/badge.svg" alt="Security Audit"</a </p
Overview
ArmadAI lets you build a team of specialized AI agents, each configured with a simple Markdown file. It works with any LLM provider (Claude, GPT, Gemini) and any CLI tool (Claude Code, aider, etc.) through a unified interface.
armadai run code-reviewer "Review this PR for security issues"
armadai run --pipe code-reviewer test-writer "src/main.rs"
armadai tuiKey Features
- Markdown-based agents — one .md file = one agent. Human-readable, git-friendly.
- Multi-provider — unified tool names (claude, gemini, gpt, aider) auto-detect CLI vs API; explicit API/CLI/proxy modes also supported
- Multi-pattern orchestration — Direct (single-shot), Blackboard (parallel shared-state), Ring (sequential consensus), Hierarchical (coordinator → leads → agents)
- Pipeline mode — chain agents sequentially (output A becomes input B)
- TUI & Web dashboards — agent library management with browser, detail view, history, costs, and command palette
- Shell completion — auto-complete for bash, zsh, fish, powershell, elvish
- Cost tracking — per-agent, per-run cost monitoring stored in SQLite
Quick Start
Prerequisites
- Rust (1.86+) — only needed to build from source
Install
# One-liner (downloads the latest release binary)
curl -fsSL https://raw.githubusercontent.com/Dr0drigues/armadai/master/install.sh | bashOptions: INSTALLDIR=~/.local/bin (default), VERSION=v0.1.0 (default: latest).
armadai new --template basic my-assistant # create your first agent
armadai run my-assistant "Explain how async/await works in Rust"See Getting Started for building from source, configuring providers, and starter packs.