umadev

UmaDev: A coding agent that works like a real dev team, commanding one of five AI coding CLIs you already use.

English | 简体中文 | 繁體中文

---

umadev is a coding agent that works like a real dev team. It drives one of five first-class AI coding CLIs you already have — Claude Code, Codex, OpenCode, Grok Build, or Kimi Code — and owns no model endpoint of its own: the model your selected base is connected to is the brain.

What you get is role-based team orchestration over that borrowed brain. For work whose depth warrants it, bounded sessions take product, architecture, UI/UX, frontend, backend, QA, security, and DevOps assignments; a small edit stays a small edit. These roles are not independent people and their verdicts are advisory. UmaDev owns the plan and deterministic acceptance floor, produces depth-appropriate artifacts/evidence, and reports failed or incomplete work honestly rather than promising that every request becomes shippable software.

A ninth seat, the coordinator, routes the request, owns a visible plan for deliberate work, schedules the selected roles, evaluates gates, and leaves the audit trail. It doesn't generate code; the base CLI does. Roles exchange bounded blackboard artifacts and structured verdicts rather than free-form cross-talk.

It's a single Rust binary. npm is just the delivery shell.

---

Table of Contents

• Install
• Quickstart
• Project Origin
• What Problem It Solves
• Features
• How It Works
• The Team
• Why You Can Trust the Output
• Runtime Modes
• The Full Delivery Flow
• Quality Gate
• Governance
• Knowledge Base
• Deliverables
• Commands
• Configuration
• Rust Architecture
• Development
• License

---

Install

npm i -g @umatech/umadev

Moving from the old umadev package? UmaDev now ships only as @umatech/umadev. The unscoped umadev package is retired and was the target of a malicious 1.0.74 publish, so run npm uninstall -g umadev first and use npx @umatech/umadev, never npx umadev. Details: SECURITY.md.

Then run umadev. Hit a permission or PATH error (a sudo-owned prefix is the usual cause)? Run umadev doctor — it prints the exact fix.

Or skip npm entirely — the native installer needs no Node, no npm, and never sudo. It downloads the official release binary for your platform, verifies its published SHA-256, and installs to a directory you own (~/.local/bin, or %LOCALAPPDATA%\Programs\umadev on Windows):

# macOS / Linux
curl -fsSL https://umadev.goder.ai/install.sh | bash

# Windows (PowerShell)
irm https://umadev.goder.ai/install.ps1 | iex