{"id":51311086,"url":"https://github.com/launchapp-dev/animus-cli","last_synced_at":"2026-07-01T04:00:53.832Z","repository":{"id":347227135,"uuid":"1165909592","full_name":"launchapp-dev/animus-cli","owner":"launchapp-dev","description":"Autonomous AI agent orchestrator — run multi-model dev teams (Claude, Gemini, GPT) with YAML workflows, daemon scheduling, and MCP integration. 100% Rust.","archived":false,"fork":false,"pushed_at":"2026-06-25T20:09:12.000Z","size":51906,"stargazers_count":39,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-25T20:11:34.779Z","etag":null,"topics":["agent-orchestrator","agentic","ai-agent","ai-coding","ai-tools","autonomous-agents","claude","cli","developer-tools","devtools","gemini","llm","mcp","multi-agent","open-claw","openai","rust","workflow-engine"],"latest_commit_sha":null,"homepage":"https://animus-docs.vercel.app/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/launchapp-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG-v0.0.18.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-24T17:14:48.000Z","updated_at":"2026-06-25T20:09:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/launchapp-dev/animus-cli","commit_stats":null,"previous_names":["launchapp-dev/ao-cli","launchapp-dev/animus-cli"],"tags_count":112,"template":false,"template_full_name":null,"purl":"pkg:github/launchapp-dev/animus-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/launchapp-dev%2Fanimus-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/launchapp-dev%2Fanimus-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/launchapp-dev%2Fanimus-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/launchapp-dev%2Fanimus-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/launchapp-dev","download_url":"https://codeload.github.com/launchapp-dev/animus-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/launchapp-dev%2Fanimus-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34992071,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-orchestrator","agentic","ai-agent","ai-coding","ai-tools","autonomous-agents","claude","cli","developer-tools","devtools","gemini","llm","mcp","multi-agent","open-claw","openai","rust","workflow-engine"],"created_at":"2026-07-01T04:00:38.068Z","updated_at":"2026-07-01T04:00:53.815Z","avatar_url":"https://github.com/launchapp-dev.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![header](https://capsule-render.vercel.app/api?type=waving\u0026color=0:0d1117,50:161b22,100:1f6feb\u0026height=200\u0026section=header\u0026text=Animus\u0026fontSize=90\u0026fontColor=f0f6fc\u0026animation=fadeIn\u0026fontAlignY=35\u0026desc=Ship%20every%20idea%20you%20have\u0026descAlignY=55\u0026descSize=22\u0026descColor=8b949e)\n\n\u003cbr/\u003e\n\n### One founder. Sixteen projects. Eighty agents in parallel.\n\n\u003csub\u003eAnimus runs the AI engineering team behind a portfolio of products.\u003c/sub\u003e\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u003ca href=\"https://github.com/launchapp-dev/animus-cli/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/launchapp-dev/animus-cli?style=for-the-badge\u0026color=1f6feb\u0026labelColor=0d1117\u0026logo=github\u0026logoColor=f0f6fc\" alt=\"Latest release\" /\u003e\u003c/a\u003e\n\u0026nbsp;\n\u003cimg src=\"https://img.shields.io/badge/rust-100%25-f0f6fc?style=for-the-badge\u0026labelColor=0d1117\u0026logo=rust\u0026logoColor=f0f6fc\" alt=\"Rust\" /\u003e\n\u0026nbsp;\n\u003cimg src=\"https://img.shields.io/badge/macOS%20%7C%20Linux%20%7C%20Windows-f0f6fc?style=for-the-badge\u0026labelColor=0d1117\u0026logo=apple\u0026logoColor=f0f6fc\" alt=\"Platforms\" /\u003e\n\u0026nbsp;\n\u003ca href=\"https://github.com/launchapp-dev/awesome-ai-coding-tools\"\u003e\u003cimg src=\"https://awesome.re/mentioned-badge-flat.svg\" alt=\"Mentioned in Awesome AI Coding Tools\" /\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n\u003c!-- TODO: add hero screenshot of the daemon queue at peak (80 agents across 16 projects) --\u003e\n\u003c!-- ![hero](docs/images/hero-queue-80-agents.png) --\u003e\n\n\u003e \"I was spending so many hours chasing ideas — I wanted to build SaaS templates,\n\u003e an auth platform, an ecommerce CRM, every direction I could think of. Animus\n\u003e is what made that possible. At one point I had 16 projects with 80 agents\n\u003e running in parallel doing real work. This is what I always wished existed.\"\n\u003e\n\u003e — Sami, building [LaunchApp](https://launchapp.dev)\n\n\u003cbr/\u003e\n\n## Install — 30 seconds\n\n### One paste, any agent\n\nOpen a fresh **Claude Code** (or **Codex** / **OpenCode** / **Cursor**) session and paste this. The agent installs the Animus CLI, clones `animus-skills`, runs the setup script, and adds the project section to `CLAUDE.md` / `AGENTS.md`. You'll be running workflows in about a minute.\n\n\u003e Install Animus + Animus Skills: run **`curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash`** to install the `animus` CLI (currently `v0.6.15` in this repo), then **`animus plugin install-defaults`** to pull in the provider + subject + workflow_runner + queue plugins the daemon needs (one-time setup, idempotent; add `--include-recommended` for the web UI and extra providers). Then **`git clone --single-branch --depth 1 https://github.com/launchapp-dev/animus-skills.git ~/.claude/skills/animus-skills \u0026\u0026 cd ~/.claude/skills/animus-skills \u0026\u0026 ./setup`** to link the skills and write `.mcp.json`. Add an \"Animus\" section to CLAUDE.md (or AGENTS.md for Codex) listing the slash commands: `/animus-setup`, `/animus-getting-started`, `/animus-mcp-setup`, `/animus-workflow-authoring`, `/animus-pack-authoring`, `/animus-skill-authoring`, `/animus-troubleshooting`. Restart the agent so the new `animus` MCP server is picked up. From a project root, run `animus init --walkthrough` to scaffold `.animus/`, install packs, and optionally start the daemon.\n\nFor Codex CLI, swap the clone path to `~/.codex/skills/animus-skills` and edit `AGENTS.md` instead of `CLAUDE.md`.\n\n### Manual install (no agent)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash\nanimus plugin install-defaults\n```\n\nThe upstream installer currently targets macOS. On Linux and Windows, use a release archive or build from source.\n\nThe second command is **required in v0.4.12 and later** (and expanded in **v0.5** to include `workflow_runner` and `queue` plugins) — the daemon no longer ships with bundled providers, subject backends, workflow runners, or queue implementations. It will refuse to start until at least one of each required role is installed. The command is idempotent and skips anything already installed. Pass `--include-recommended` to also get the web UI, GraphQL transport, and additional providers.\n\n### Install via avm (version manager, recommended for multi-project machines)\n\n[`avm`](https://github.com/launchapp-dev/avm) pins each project to a specific `animus` kernel version (à la `nvm`/`rustup`) and dispatches transparently: a project's `.animus-version` selects the kernel, with a global default fallback. Running `animus` in any project then uses the right version automatically.\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/launchapp-dev/avm/main/install.sh | sh\navm install v0.6.15            # download a kernel version\navm use --global v0.6.15       # machine default; per-project: `avm use v0.6.15` writes .animus-version\n```\n\n### Project setup: `animus.toml` (v0.6.15+)\n\nAnimus uses an npm/cargo-style manifest. A committed `animus.toml` declares the project's kernel, plugins, and packs; `animus install` resolves it into `.animus/plugins.lock` and installs the set, so onboarding a checked-out project is two commands:\n\n```bash\ngit clone \u003crepo\u003e \u0026\u0026 cd \u003crepo\u003e\ncp .env.example .env \u0026\u0026 $EDITOR .env   # fill in the project's declared secrets\nanimus install                          # plugins + packs from animus.lock, then load .env into the secret store\n# CI / containers: reproduce the lock exactly\nanimus install --locked\n```\n\n`animus init` scaffolds `animus.toml`, `.env.example`, and a merge-safe `.gitignore`; `animus add \u003cspec\u003e` / `animus remove \u003cname\u003e` manage dependencies. See [`docs/reference/cli/index.md`](docs/reference/cli/index.md#project-manifest-animustoml-install--add--remove).\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ckbd\u003eoptions\u003c/kbd\u003e\u003c/summary\u003e\n\n```bash\n# Specific version\nANIMUS_VERSION=v0.6.15 curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash\n\n# Custom directory\nANIMUS_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash\n\n# Run install-defaults automatically as the last step\nANIMUS_INSTALL_PLUGINS=1 curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash\n\n# Skip the post-install plugin step (CI / Docker)\nANIMUS_SKIP_PLUGIN_INSTALL=1 curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ckbd\u003eupgrading from v0.4.11 or earlier\u003c/kbd\u003e\u003c/summary\u003e\n\nStop the running daemon first, then upgrade. See [`docs/migration/v0.4.11-to-v0.4.12.md`](docs/migration/v0.4.11-to-v0.4.12.md) for the full rationale and rollback procedure.\n\n```bash\nanimus daemon stop\ncurl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash\nanimus plugin install-defaults --include-subjects --include-transports\nanimus daemon preflight                 # verify all required plugins present\nanimus daemon start\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ckbd\u003eprerequisites\u003c/kbd\u003e\u003c/summary\u003e\n\nYou need at least one AI coding CLI:\n\n```bash\nnpm install -g @anthropic-ai/claude-code    # Claude (recommended)\nnpm install -g @openai/codex                # Codex\nnpm install -g @google/gemini-cli           # Gemini\n```\n\n\u003c/details\u003e\n\n---\n\n## What is Animus?\n\n**Animus is how one founder ships a portfolio of products.**\n\nDefine your agent team in YAML. Animus runs them in parallel git worktrees,\ngates their work through quality checks, and opens reviewed PRs — while you\nfocus on the next idea.\n\nUse Claude, Codex, Gemini, OpenCode, Ollama, or any coding agent you already use.\nAnimus orchestrates — it doesn't replace your tools.\n\n- **Local-first.** Your code never leaves your machine.\n- **Plugin-first.** Works with Linear, GitHub Issues, Asana, Jira, or whatever tracker you already use.\n\nThe core daemon is the orchestration runtime; providers, subject backends, triggers, transports, web UI, and log storage ship as independent `animus-*` plugins under [launchapp-dev](https://github.com/launchapp-dev). `animus plugin install \u003cowner/repo\u003e` pulls them in with optional cosign signature verification. The daemon discovers installed plugins at startup, exposes a Unix-socket control protocol, and the CLI, MCP server, and web transports route through that control surface.\n\n```\n                ┌──────────────────────────────────────────────────┐\n                │            Animus Daemon (Rust)                  │\n                │                                                  │\n  ┌────────┐    │    ┌───────────┐    ┌───────────┐    ┌────────┐ │    ┌────────┐\n  │ Tasks  │───▶│───▶│  Dispatch │───▶│  Agents   │───▶│ Phases │─│──▶│  PRs   │\n  │        │    │    │  Queue    │    │           │    │        │ │    │        │\n  │ TASK-1 │    │    │ priority  │    │ Claude    │    │ impl   │ │    │ PR #42 │\n  │ TASK-2 │    │    │ routing   │    │ Codex     │    │ review │ │    │ PR #43 │\n  │ TASK-3 │    │    │ capacity  │    │ Gemini    │    │ test   │ │    │ PR #44 │\n  └────────┘    │    └───────────┘    └───────────┘    └────────┘ │    └────────┘\n                │                                                  │\n                │    Schedules: work-planner (5m), pr-reviewer     │\n                │    (5m), reconciler (5m), PO scans (2-8h)        │\n                └──────────────────────────────────────────────────┘\n```\n\n---\n\n## Who is this for?\n\n**Today: portfolio builders.**\n- **Solo founders** running 3+ projects in parallel\n- **Indie hackers** shipping every idea they have\n- **Two-founder studios** trying to ship like a 20-person team\n\n**Increasingly: teams drowning in code maintenance.**\n- Codebases with stale deps, missing tests, and doc drift\n- Microservices nobody has time to maintain\n- Legacy systems waiting for \"the modernization project\"\n\n**Not for:**\n- Anyone looking for AI to \"replace\" their engineers\n- Enterprise looking for a managed coding agent (the Devin / Codespaces use case)\n- Teams already happy doing everything inside Cursor or Claude Code\n\nThe same capabilities — parallel worktrees, supervised agents, quality gates, automated PRs — serve both audiences. We started with portfolio builders because that's the user we know best: we are one.\n\n---\n\n## Quick Start\n\n```bash\ncd your-project                                  # any git repo\nanimus init --walkthrough                        # guided setup: plugins, packs, starter workflow, daemon\n```\n\nThe walkthrough installs required plugins, installs recommended workflow packs,\ncopies a starter workflow into `.animus/workflows/`, and optionally starts the\ndaemon. It is the fastest path from zero to running workflows. Scripted / CI\nalternative:\n\n```bash\nanimus doctor                                    # check prerequisites and auto-remediate\nanimus plugin install-defaults                   # one command: provider + subjects + workflow_runner + queue\nanimus init --template task-queue --non-interactive --install-packs\nanimus daemon preflight                          # verify all required plugins are present\n\n# Option 1: run a workflow on demand\nanimus subject create --kind task --title \"Add rate limiting\" --priority p1\nanimus workflow run --task-id TASK-001\n\n# Option 2: go fully autonomous\nanimus daemon start                              # daemon executes ready subjects continuously\nanimus daemon health                             # verify it's up\nanimus logs tail --limit 100                     # inspect recent daemon events\nanimus daemon stream                             # live structured event stream\n\n# Scaffold a brand-new subject backend (Jira, Notion, anything with an API):\nanimus plugin new --kind subject --name jira\n```\n\n\u003e **v0.5 note:** the daemon will refuse to start unless plugins for all\n\u003e required roles are installed — provider, subject backend, `workflow_runner`,\n\u003e and `queue`. Run `animus daemon preflight` for the exact remediation\n\u003e command if startup fails. See\n\u003e [docs/migration/v0.4.11-to-v0.4.12.md](docs/migration/v0.4.11-to-v0.4.12.md)\n\u003e for the upgrade story from v0.4.11; v0.5 follows the same install-defaults\n\u003e remediation pattern.\n\nBundled `init` templates: **`task-queue`**, **`conductor`**, **`direct-workflow`**.\n\n\u003e **v0.4.4 note:** `animus task ...` and `animus requirements ...` were removed\n\u003e in favor of `animus subject --kind \u003ckind\u003e`. Install the task and requirement\n\u003e subject plugins, then route through `subject --kind task` or\n\u003e `subject --kind requirement`.\n\n---\n\n## Everything in One YAML\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Agents\n\nBind models, tools, MCP servers, and system prompts to named profiles. Route by task complexity.\n\n```yaml\nagents:\n  default:\n    model: claude-sonnet-4-6\n    tool: claude\n    mcp_servers: [\"animus\", \"context7\"]\n\n  work-planner:\n    system_prompt: |\n      Scan tasks, check dependencies,\n      enqueue ready work for the daemon.\n    model: claude-sonnet-4-6\n    tool: claude\n```\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Phases\n\nReusable execution units. Three modes: **agent** (AI with decision contracts), **command** (shell), **manual** (human gate).\n\n```yaml\nphases:\n  implementation:\n    mode: agent\n    agent: default\n    directive: \"Implement production code.\"\n    decision_contract:\n      min_confidence: 0.7\n      max_risk: medium\n\n  push-branch:\n    mode: command\n    command:\n      program: git\n      args: [\"push\", \"-u\", \"origin\", \"HEAD\"]\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Workflows\n\nCompose phases into pipelines with skip conditions and post-success hooks.\n\n```yaml\nworkflows:\n  - id: standard\n    phases:\n      - requirements\n      - implementation\n      - push-branch\n      - create-pr\n    post_success:\n      merge:\n        strategy: squash\n        auto_merge: true\n        cleanup_worktree: true\n```\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Schedules \u0026 Triggers\n\nCron-based autonomous execution and event-driven triggers. Trigger types: `file_watcher`, `webhook` (generic HTTP), `github_webhook` (with event filtering).\n\n```yaml\nschedules:\n  - id: work-planner\n    cron: \"*/5 * * * *\"\n    workflow_ref: work-planner\n    enabled: true\n\ntriggers:\n  - id: pr-opened\n    type: github_webhook\n    workflow_ref: pr-reviewer\n    enabled: true\n    config:\n      events: [\"pull_request\"]\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## The Full Agent Team\n\nAnimus doesn't run one agent. It runs an **entire product organization**:\n\n```\n  ┌─────────────────────────────────────────────────────────────────┐\n  │                                                                 │\n  │   Planners               Builders              Reviewers        │\n  │   ╭──────────────╮       ╭──────────────╮       ╭──────────────╮│\n  │   │ Work Planner │       │ Claude Eng   │       │ PR Reviewer  ││\n  │   │ Reconciler   │       │ Codex Eng    │       │ PO Reviewer  ││\n  │   │ Triager      │       │ Gemini Eng   │       │ Code Review  ││\n  │   │ Req Refiner  │       │ GLM Eng      │       │              ││\n  │   ╰──────────────╯       ╰──────────────╯       ╰──────────────╯│\n  │                                                                 │\n  │   Product Owners         Architects             Operations      │\n  │   ╭──────────────╮       ╭──────────────╮       ╭──────────────╮│\n  │   │ PO: Web      │       │ Rust Arch    │       │ Sys Monitor  ││\n  │   │ PO: MCP      │       │ Infra Arch   │       │ Release Mgr  ││\n  │   │ PO: Workflow │       │              │       │ Branch Sync  ││\n  │   │ PO: CLI      │       │              │       │ Doc Drift    ││\n  │   │ PO: Runner   │       │              │       │ Wf Optimizer ││\n  │   ╰──────────────╯       ╰──────────────╯       ╰──────────────╯│\n  │                                                                 │\n  └─────────────────────────────────────────────────────────────────┘\n```\n\n## Key Concepts\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"33%\"\u003e\n\n**Decision Contracts**\n\nEvery agent phase returns a typed verdict: `advance`, `rework`, `skip`, or `fail`. Rework loops pass the reviewer's feedback back to the implementer. Configurable `max_rework_attempts` prevents infinite loops.\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n**Model Routing**\n\nRoute tasks to different models by type and complexity. Low-priority bugfixes go to cheap models. Critical architecture tasks go to Opus. The work-planner agent manages this automatically.\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n**Worktree Isolation**\n\nEvery task gets its own git worktree. Agents work in parallel on separate branches without conflicts. Post-success hooks handle merge, cleanup, and PR creation.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n| Complexity | Type | Model | Why |\n|:---|:---|:---|:---|\n| `low` | bugfix/chore | GLM-5-Turbo | Cheapest option |\n| `medium` | feature | Claude Sonnet | Reliable, fast |\n| `medium` | UI/UX | Gemini 3.1 Pro | Vision + design expertise |\n| `high` | refactor | Codex GPT-5.3 | Strong code understanding |\n| `high` | architecture | Claude Opus | Maximum quality |\n| `critical` | any | Claude Opus | No compromises |\n\n---\n\n## Plugin Ecosystem\n\nThe plugin ecosystem lives in standalone GitHub repositories under\n[launchapp-dev](https://github.com/launchapp-dev). The exact `(repo, tag)` set\ninstalled by `animus plugin install-defaults` lives in a single source of truth at\n[`crates/orchestrator-core/src/plugin_registry.rs`](crates/orchestrator-core/src/plugin_registry.rs)\nso the CLI installer and the daemon preflight always agree on which tag is\n\"the default\":\n\n| Kind | Repos |\n|---|---|\n| **Protocol + tooling** | [`animus-protocol`](https://github.com/launchapp-dev/animus-protocol), [`animus-plugin-template`](https://github.com/launchapp-dev/animus-plugin-template), [`animus-plugin-registry`](https://github.com/launchapp-dev/animus-plugin-registry) |\n| **Subject backends** | `animus-subject-default`, [`animus-subject-requirements`](https://github.com/launchapp-dev/animus-subject-requirements), [`animus-subject-linear`](https://github.com/launchapp-dev/animus-subject-linear), [`animus-subject-sqlite`](https://github.com/launchapp-dev/animus-subject-sqlite), [`animus-subject-markdown`](https://github.com/launchapp-dev/animus-subject-markdown) |\n| **Providers** | [`animus-provider-claude`](https://github.com/launchapp-dev/animus-provider-claude), [`animus-provider-codex`](https://github.com/launchapp-dev/animus-provider-codex), [`animus-provider-gemini`](https://github.com/launchapp-dev/animus-provider-gemini), [`animus-provider-opencode`](https://github.com/launchapp-dev/animus-provider-opencode), [`animus-provider-oai`](https://github.com/launchapp-dev/animus-provider-oai) |\n| **Triggers** | [`animus-trigger-webhook`](https://github.com/launchapp-dev/animus-trigger-webhook), [`animus-trigger-slack`](https://github.com/launchapp-dev/animus-trigger-slack) |\n| **Transports + web UI** | `animus-transport-http`, `animus-transport-graphql`, `animus-web-ui` |\n| **Log storage** | [`animus-log-storage-file`](https://github.com/launchapp-dev/animus-log-storage-file) |\n\n```bash\nanimus plugin install launchapp-dev/animus-provider-claude\nanimus plugin list                     # see what's installed with SIG column\nanimus plugin install-defaults --include-subjects --include-transports\nanimus plugin new my-thing --kind subject   # scaffold from the template\n```\n\nInstalls verify a sigstore cosign signature when one is published. Use\n`--require-signature` to enforce. See\n[docs/architecture/plugin-signing.md](docs/architecture/plugin-signing.md).\n\n---\n\n## Claude Code Integration\n\n[**Animus Skills**](https://github.com/launchapp-dev/animus-skills) is the companion skill bundle. Install with the one-paste prompt above, or directly:\n\n```bash\ngit clone https://github.com/launchapp-dev/animus-skills.git ~/animus-skills\ncd ~/animus-skills \u0026\u0026 ./setup           # auto-detects installed agent hosts\n```\n\nThe `./setup` script supports `--host claude|codex|opencode|cursor|slate|kiro|all`, `--no-cli` (skip animus install), and `--no-mcp` (skip writing project `.mcp.json`).\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n**Slash Commands**\n\n| Command | What it does |\n|:---|:---|\n| `/animus-setup` | Initialize Animus in your project |\n| `/animus-getting-started` | Install, concepts, first task |\n| `/animus-mcp-setup` | Connect AI tools via MCP |\n| `/animus-workflow-authoring` | Write custom YAML workflows |\n| `/animus-pack-authoring` | Build workflow packs |\n| `/animus-skill-authoring` | Author Animus skills |\n| `/animus-troubleshooting` | Debug common issues |\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n**Auto-Loaded References**\n\n| Skill | Coverage |\n|:---|:---|\n| `animus-configuration` | Config files, state layout, model routing |\n| `animus-task-management` | Full task lifecycle via CLI and MCP |\n| `animus-daemon-operations` | Daemon monitoring and troubleshooting |\n| `animus-queue-management` | Dispatch queue operations |\n| `animus-workflow-patterns` | Patterns from 150+ autonomous PRs |\n| `animus-agent-personas` | PO, architect, auditor agents |\n| `animus-mcp-tools` | Complete `animus.*` tool reference |\n| `animus-mcp-servers-for-agents` | Context7, GitHub, memory MCP wiring |\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## CLI\n\n```\nanimus subject       Unified subject surface: list/get/create/update/next/status --kind \u003ckind\u003e\n                     (kind=task and kind=requirement are served by installed subject_backend plugins)\nanimus workflow      Run and manage multi-phase workflows\nanimus daemon        Start/stop the autonomous scheduler (start, stop, health, stream)\nanimus queue         Inspect and manage the dispatch queue\nanimus agent         Control agent runner processes\nanimus output        Stream and inspect agent output\nanimus logs          Tail daemon events.jsonl or whichever log-storage plugin is active\nanimus trigger       Manage event triggers (file_watcher, webhook, github_webhook, slack)\nanimus pack          Install, list, and update workflow packs\nanimus plugin        Install, list, inspect, and scaffold stdio plugins\nanimus skill         Install and inspect Animus skills\nanimus git           Worktree and branch helpers\nanimus history       Inspect run history (includes phase + runtime error reports)\nanimus init          Initialize a project from a template registry or local template\nanimus mcp           Start Animus as an MCP server\nanimus web           Launch installed web dashboard/transport plugins\nanimus status        Project overview at a glance\nanimus approval      Manage approvals for destructive operations\nanimus auth          Inspect identity and permissions\nanimus events        Stream workflow lifecycle events\nanimus state         Export and import scoped runtime state\nanimus secret        Manage project-scoped secrets in the OS keychain\nanimus doctor        Health checks, auto-remediation, and troubleshooting\n```\n\nRun `animus --help` for the full surface.\n\n**Removed in v0.4.4:** `animus task` (→ `animus subject --kind task`),\n`animus requirements` (→ `animus subject --kind requirement`),\n`animus setup` (→ `animus init`), `animus now` (→ `animus status`),\n`animus errors` (→ `animus history`).\n\n---\n\n## Architecture\n\nAnimus v0.5 is a **kernel + flavors** architecture: a Rust workspace daemon\nkernel plus a curated bundle of out-of-tree plugins for providers, subject\nbackends, workflow execution, queues, transports, and web UI. The current\nworkspace members from `Cargo.toml` are:\n\n- `animus-plugin-protocol` — in-tree stdio plugin protocol types\n- `animus-plugin-runtime` — runtime helpers for plugin implementations\n- `orchestrator-daemon-runtime` — daemon queue, scheduling, subject dispatch, and runtime supervision\n- `orchestrator-logging` — shared tracing and log-file utilities\n- `orchestrator-plugin-host` — plugin discovery, install state, stdio host, and provider session bridge\n- `orchestrator-config` — workflow YAML loading, pack loading, scaffolding, and phase plan resolution\n- `orchestrator-core` — domain services, bootstrap, plugin registry, and state mutation APIs\n- `orchestrator-cli` — main `animus` binary, clap surface, MCP server, and CLI operations\n- `animus-runtime-shared` — shared workflow execution and runtime-contract helpers used by the daemon and external `workflow_runner` plugins\n- `animus-mcp-oauth` — OAuth authorization-code + PKCE helpers and the `animus-mcp-proxy` bridge for protected MCP servers\n\nShared `protocol::*`, config-source, provider/session, and subject wire types\nnow come from the external `launchapp-dev/animus-protocol` dependencies pinned\nin the workspace `Cargo.toml` files rather than an in-tree crate.\n\nProvider execution and the web stack are no longer in-tree crates. The\nOpenAI-compatible runner ships as the external\n[`launchapp-dev/animus-provider-oai-agent`](https://github.com/launchapp-dev/animus-provider-oai-agent)\nplugin, and `animus web` resolves external transport/UI plugins rather than an\nembedded web server.\n\n**v0.5 reference plugins** (install via `animus plugin install-defaults`):\n\n- [`animus-workflow-runner-default`](https://github.com/launchapp-dev/animus-workflow-runner-default) `v0.4.1` — Rust workflow_runner plugin\n- [`animus-queue-default`](https://github.com/launchapp-dev/animus-queue-default) `v0.2.0` — Rust queue plugin with atomic `queue/lease` + `queue/release_pending`\n- [`animus-step-durable-dbos`](https://github.com/launchapp-dev/animus-step-durable-dbos) `v0.2.0` — Postgres + DBOS-backed durable_store\n- [`animus-memory-zep`](https://github.com/launchapp-dev/animus-memory-zep) `v0.1.0` — Zep Cloud memory_store\n\nSee [`docs/architecture/full-system-architecture.md`](docs/architecture/full-system-architecture.md),\n[`docs/architecture/runtime-architecture.md`](docs/architecture/runtime-architecture.md),\nand [`docs/architecture/plugin-system.md`](docs/architecture/plugin-system.md)\nfor the current source-backed architecture docs.\n\nThe web dashboard is no longer bundled in-tree. Install it as plugins via\n`animus plugin install-defaults --include-transports`\n(`animus-transport-http` + `animus-transport-graphql` + `animus-web-ui`).\n\n```mermaid\ngraph LR\n    A[CLI] --\u003e B[Core Services]\n    A --\u003e C[Daemon Runtime]\n    B --\u003e D[Workflow Runner]\n    D --\u003e E[Agent Runner]\n    E --\u003e F[Session Host]\n    F --\u003e G[Provider Plugins]\n    B --\u003e H[Config Compiler]\n    A --\u003e I[Plugin Host]\n    C --\u003e I\n    I --\u003e J[Subject / Trigger / Transport Plugins]\n    C --\u003e D\n    style A fill:#1f6feb,stroke:#1f6feb,color:#fff\n    style C fill:#1f6feb,stroke:#1f6feb,color:#fff\n    style I fill:#1f6feb,stroke:#1f6feb,color:#fff\n```\n\n---\n\n## Platforms\n\n| Platform | Architecture | |\n|:---|:---|:---|\n| macOS | Apple Silicon (M1+) | `aarch64-apple-darwin` |\n| macOS | Intel | `x86_64-apple-darwin` |\n| Linux | x86_64 | `x86_64-unknown-linux-gnu` |\n| Linux | arm64 | `aarch64-unknown-linux-gnu` |\n| Windows | x86_64 | `x86_64-pc-windows-msvc` |\n\n---\n\n## License\n\nThis project is licensed under the [Elastic License 2.0 (ELv2)](LICENSE). You may use, modify, and distribute the software, but you may not provide it to third parties as a hosted or managed service.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Update**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash\n```\n\n**Uninstall**\n\n```bash\nrm -f ~/.local/bin/animus \\\n  ~/.local/bin/ao\n```\n\n\u003cbr/\u003e\n\n\u003csub\u003eOpen source. Local-first. Built by founders running too many projects at once.\u003c/sub\u003e\n\n\u003c/div\u003e\n\n![footer](https://capsule-render.vercel.app/api?type=waving\u0026color=0:0d1117,50:161b22,100:1f6feb\u0026height=100\u0026section=footer)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaunchapp-dev%2Fanimus-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaunchapp-dev%2Fanimus-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaunchapp-dev%2Fanimus-cli/lists"}