Molayo

© 2026 Molayo

GitHub요약2026. 06. 26. 10:09

launchapp-dev/animus-cli

요약

Animus CLI는 AI 에이전트가 병렬로 다양한 프로젝트를 수행할 수 있도록 돕는 엔지니어링 도구입니다. Claude Code, Cursor 등 AI 코딩 도구와 연동하여 에이전트 워크플로를 신속하게 설정하고 실행할 수 있습니다.

핵심 포인트

  • AI 에이전트 기반의 병렬 프로젝트 운영 지원
  • Claude Code, Cursor 등 주요 AI 코딩 도구와 호환
  • CLI 설치 및 MCP 서버를 통한 간편한 워크플로 설정
  • 애니머스 스킬(Animus Skills)을 통한 기능 확장 가능

Animus는 다양한 제품 포트폴리오를 뒷받침하는 AI 엔지니어링 팀을 운영합니다.

"저는 아이디어를 쫓느라 너무 많은 시간을 소비하고 있었습니다. SaaS 템플릿, 인증 (auth) 플랫폼, 이커머스 CRM 등 생각할 수 있는 모든 방향으로 구축하고 싶었습니다. Animus는 그것을 가능하게 해주었습니다. 한때 저는 80개의 에이전트 (agents)가 병렬로 실제 작업을 수행하는 16개의 프로젝트를 운영하고 있었습니다. 이것이 바로 제가 항상 존재하기를 바랐던 것입니다."

— Sami, LaunchApp 빌더

새로운 Claude Code (또는 Codex / OpenCode / Cursor) 세션을 열고 이를 붙여넣으세요. 에이전트가 Animus CLI를 설치하고, animus-skills를 클론 (clone)하며, 설정 스크립트를 실행하고, CLAUDE.md / AGENTS.md에 프로젝트 섹션을 추가합니다. 약 1분 안에 워크플로 (workflows)를 실행할 수 있게 됩니다.

Animus + Animus Skills 설치: curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash를 실행하여 animus CLI (현재 이 리포지토리의 v0.6.14)를 설치한 다음, 데몬 (daemon)에 필요한 provider + subject + workflow_runner + queue 플러그인 (plugins)을 가져옵니다 (1회성 설정, 멱등성 (idempotent) 보장; 웹 UI 및 추가 provider를 위해 animus plugin install-defaults --include-recommended를 추가하세요). 그런 다음 스킬 (skills)을 연결하고 다음을 실행합니다: git clone --single-branch --depth 1 https://github.com/launchapp-dev/animus-skills.git ~/.claude/skills/animus-skills && cd ~/.claude/skills/animus-skills && ./setup. CLAUDE.md (Codex의 경우 AGENTS.md)에 다음 슬래시 명령어 (slash commands) 목록이 포함된 "Animus" 섹션을 추가합니다: /animus-setup, /animus-getting-started, /animus-mcp-setup, /animus-workflow-authoring, /animus-pack-authoring, /animus-skill-authoring, /animus-troubleshooting. 에이전트를 재시작하여 새로운 animus MCP 서버가 인식되도록 합니다. 프로젝트 루트에서 animus init --walkthrough를 실행하여 .animus/를 스캐폴딩 (scaffold)하고, 팩 (packs)을 설치하며, 선택적으로 데몬을 시작합니다.

Codex CLI의 경우, 클론 (clone) 경로를 ~/.codex/skills/animus-skills로 바꾸고 CLAUDE.md 대신 AGENTS.md를 편집하세요.

curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash
animus plugin install-defaults

현재 업스트림(upstream) 설치 프로그램은 macOS를 대상으로 합니다. Linux 및 Windows에서는 릴리스 아카이브(release archive)를 사용하거나 소스에서 빌드(build from source)하세요.

두 번째 명령은 v0.4.12 및 그 이후 버전에서 필수적이며 (v0.5에서 workflow_runner 및 queue 플러그인을 포함하여 확장됨) — 데몬(daemon)은 더 이상 번들로 제공되는 프로바이더(providers), 서브젝트 백엔드(subject backends), 워크플로 러너(workflow runners) 또는 큐 구현체(queue implementations)를 포함하지 않습니다. 최소 하나씩의 필수 역할이 설치될 때까지 실행을 거부할 것입니다. 이 명령은 멱등성(idempotent)을 가지며 이미 설치된 항목은 건너뜁니다. 웹 UI, GraphQL 트랜스포트(transport) 및 추가 프로바이더를 함께 받으려면 --include-recommended를 전달하세요.

avm은 각 프로젝트를 특정 animus 커널 버전(kernel version)에 고정하며 (nvm / rustup 방식과 유사), 투명하게 디스패치(dispatch)합니다: 프로젝트의 .animus-version이 커널을 선택하며, 전역 기본값(global default)으로 폴백(fallback)합니다. 어떤 프로젝트에서든 animus를 실행하면 자동으로 올바른 버전을 사용합니다.

curl -fsSL https://raw.githubusercontent.com/launchapp-dev/avm/main/install.sh | sh
avm install v0.6.14 # 커널 버전 다운로드
avm use --global v0.6.14 # 머신 기본값; 프로젝트별: `avm use v0.6.14`는 .animus-version을 작성함

Animus는 npm/cargo 스타일의 매니페스트(manifest)를 사용합니다. 커밋된 animus.toml은 프로젝트의 커널, 플러그인(plugins) 및 팩(packs)을 선언합니다; animus install은 이를 .animus/plugins.lock으로 해결(resolve)하고 세트를 설치하므로, 체크아웃된 프로젝트의 온보딩(onboarding)은 두 개의 명령으로 완료됩니다:

git clone <repo> && cd <repo>
cp .env.example .env && $EDITOR .env # 프로젝트에 선언된 비밀값(secrets)을 채움
animus install # animus.lock으로부터 플러그인 + 팩을 설치한 후, .env를 비밀 저장소(secret store)로 로드
...

animus init은 animus.toml, .env.example, 그리고 병합 안전한(merge-safe) .gitignore를 스캐폴딩(scaffolds)합니다; animus add <spec> / animus remove <name>은 의존성(dependencies)을 관리합니다. docs/reference/cli/index.md를 참조하세요.

options

# 특정 버전
ANIMUS_VERSION=v0.6.14 curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash
# 사용자 정의 디렉토리
...

v0.4.11 또는 그 이전 버전에서 업그레이드하기

먼저 실행 중인 데몬 (daemon)을 중지한 다음 업그레이드하세요. 전체적인 근거와 롤백 (rollback) 절차는 docs/migration/v0.4.11-to-v0.4.12.md를 참조하세요.

animus daemon stop
curl -fsSL https://raw.githubusercontent.com/launchapp-dev/animus-cli/main/scripts/install.sh | bash
animus plugin install-defaults --include-subjects --include-transports
...

선행 조건 (prerequisites)

최소 하나 이상의 AI 코딩 CLI가 필요합니다:

npm install -g @anthropic-ai/claude-code # Claude (권장)
npm install -g @openai/codex # Codex
npm install -g @google/gemini-cli # Gemini

Animus는 한 명의 창업자가 제품 포트폴리오를 출시하는 방식입니다.

YAML에서 에이전트 팀을 정의하세요. Animus는 이들을 병렬 git 워크트리 (worktrees)에서 실행하고, 품질 검사 (quality checks)를 통해 작업을 제어하며, 검토된 PR (Pull Requests)을 생성합니다. 그동안 당신은 다음 아이디어에 집중할 수 있습니다.

Claude, Codex, Gemini, OpenCode, Ollama 또는 이미 사용 중인 모든 코딩 에이전트를 사용하세요. Animus는 오케스트레이션 (orchestration)을 수행할 뿐, 당신의 도구를 대체하지 않습니다.

로컬 우선 (Local-first). 당신의 코드는 절대 머신을 떠나지 않습니다. 플러그인 우선 (Plugin-first). Linear, GitHub Issues, Asana, Jira 또는 당신이 이미 사용 중인 어떤 트래커와도 함께 작동합니다.

코어 데몬 (core daemon)은 오케스트레이션 런타임 (orchestration runtime)입니다. 프로바이더 (providers), 서브젝트 백엔드 (subject backends), 트리거 (triggers), 트랜스포트 (transports), 웹 UI 및 로그 저장소는 launchapp-dev 산하의 독립적인 animus-* 플러그인으로 제공됩니다. animus plugin install <owner/repo>를 통해 선택적인 cosign 서명 검증과 함께 이를 가져올 수 있습니다. 데몬은 시작 시 설치된 플러그인을 발견하고, Unix 소켓 제어 프로토콜을 노출하며, CLI, MCP 서버 및 웹 트랜스포트는 해당 제어 인터페이스를 통해 라우팅됩니다.

┌──────────────────────────────────────────────────┐
│ Animus Daemon (Rust) │
│ │
...

현재: 포트폴리오 빌더 (portfolio builders).

1인 창업자 (Solo founders): 3개 이상의 프로젝트를 병렬로 운영하는 경우
인디 해커 (Indie hackers): 떠오르는 모든 아이디어를 즉시 출시하는 경우
2인 규모의 스튜디오 (Two-founder studios): 20명 규모의 팀처럼 제품을 출시하려는 경우

점점 늘어나는 사례: 코드 유지보수에 허덕이는 팀들.

  • 오래된 의존성 (deps), 누락된 테스트, 문서 불일치 (doc drift)가 발생하는 코드베이스
  • 아무도 유지보수할 시간이 없는 마이크로서비스 (Microservices)
  • "현대화 프로젝트"만을 기다리고 있는 레거시 시스템 (Legacy systems)

대상 제외:

  • 엔지니어를 "대체"할 AI를 찾는 모든 사람
  • 관리형 코딩 에이전트 (Devin / Codespaces 사용 사례)를 찾는 기업
  • Cursor 또는 Claude Code 내부에서 모든 것을 수행하는 것에 이미 만족하는 팀

병렬 워크트리 (parallel worktrees), 감독 기능이 있는 에이전트 (supervised agents), 품질 게이트 (quality gates), 자동화된 PR (automated PRs)과 같은 동일한 기능이 두 사용자층 모두에게 유용합니다. 저희는 우리가 가장 잘 아는 사용자, 즉 우리 자신이기 때문에 포트폴리오 빌더 (portfolio builders)를 대상으로 시작했습니다.

cd your-project # 어떤 git 리포지토리든 가능
animus init --walkthrough # 가이드 설정: 플러그인 (plugins), 팩 (packs), 스타터 워크플로 (starter workflow), 데몬 (daemon)

워크스루 (walkthrough)는 필요한 플러그인을 설치하고, 권장 워크플로 팩을 설치하며, 스타터 워크플로를 .animus/workflows/로 복사하고, 선택적으로 데몬을 시작합니다. 이는 제로 상태에서 워크플로를 실행하기까지의 가장 빠른 경로입니다. 스크립트 기반 / CI 대안:

animus doctor # 필수 요구 사항 확인 및 자동 복구 (auto-remediate)
animus plugin install-defaults # 단일 명령: provider + subjects + workflow_runner + queue
animus init --template task-queue --non-interactive --install-packs
...

v0.5 참고 사항: 모든 필수 역할(role)에 대한 플러그인—provider, subject backend, workflow_runner, queue—이 설치되지 않으면 데몬 시작이 거부됩니다. 시작에 실패할 경우 정확한 복구 명령을 위해 animus daemon preflight를 실행하세요. v0.4.11에서 v0.4.12로의 업그레이드 내역은 docs/migration/v0.4.11-to-v0.4.12.md를 참조하십시오. v0.5는 동일한 install-defaults 복구 패턴을 따릅니다.

번들로 제공되는 init 템플릿: task-queue, conductor, direct-workflow

v0.4.4 참고 사항: animus task ... 및 animus requirements ...는 animus subject --kind <kind>로 대체되어 삭제되었습니다.

. task 및 requirement subject 플러그인을 설치한 다음, subject --kind task 또는 subject --kind requirement를 통해 라우팅합니다.

|
Bind models, tools, MCP servers, and system prompts to named profiles. Route by task complexity. ```
agents:
default:
model: claude-sonnet-4-6
...

이름이 지정된 프로필에 모델(models), 도구(tools), MCP 서버(MCP servers), 시스템 프롬프트(system prompts)를 바인딩합니다. 작업 복잡도(task complexity)에 따라 라우팅합니다. |
| 
Reusable execution units. Three modes: ```
phases:
  implementation:
    mode: agent
...
``` | 
재사용 가능한 실행 단위(execution units). 세 가지 모드: |
| 
Compose phases into pipelines with skip conditions and post-success hooks. ```
workflows:
- id: standard
  phases:
...
``` | 
건너뛰기 조건(skip conditions) 및 성공 후 훅(post-success hooks)이 포함된 파이프라인으로 페이즈(phases)를 구성합니다. |
| 
Cron-based autonomous execution and event-driven triggers. Trigger types: ```
schedules:
- id: work-planner
  cron: "*/5 * * * *"
...
``` | 
Cron 기반 자율 실행 및 이벤트 기반 트리거(event-driven triggers). 트리거 유형: |

Animus는 단일 에이전트를 실행하는 것이 아니라, **제품 조직 전체(entire product organization)**를 실행합니다:

┌─────────────────────────────────────────────────────────────────┐
│ │
│ Planners Builders Reviewers │
│ ... │
└─────────────────────────────────────────────────────────────────┘


| 
Every agent phase returns a typed verdict: | 
모든 에이전트 페이즈(agent phase)는 타입이 지정된 판결(typed verdict)을 반환합니다: |
| 
Route 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. | 
유형과 복잡도에 따라 작업을 서로 다른 모델로 라우팅합니다. 우선순위가 낮은 버그 수정(bugfixes)은 저렴한 모델로 보내고, 중요한 아키텍처(architecture) 작업은 Opus로 보냅니다. work-planner 에이전트가 이를 자동으로 관리합니다. |
| 
Every task gets its own git worktree. Agents work in parallel on separate branches without conflicts. Post-success hooks handle merge, cleanup, and PR creation. | 
모든 작업은 고유한 git 워크트리(worktree)를 가집니다. 에이전트들은 충돌 없이 별도의 브랜치에서 병렬로 작업합니다. 성공 후 훅(post-success hooks)이 머지(merge), 정리(cleanup), PR 생성을 처리합니다. |

| 복잡도 (Complexity) | 유형 (Type) | 모델 (Model) | 이유 (Why) |
|---|---|---|---|
| `low` | bugfix/chore | GLM-5-Turbo | 가장 저렴한 옵션 |
| `medium` | feature | Claude Sonnet | 신뢰할 수 있고 빠름 |
| `medium` | UI/UX | Gemini 3.1 Pro | 비전(Vision) + 디자인 전문성 |
| `high` | refactor | Codex GPT-5.3 | 강력한 코드 이해력 |
| `high` | architecture | Claude Opus | 최상의 품질 |
| `critical` | any | Claude Opus | 타협 없음 |

플러그인 생태계는 launchapp-dev 산하의 독립적인 GitHub 리포지토리(repositories)에 존재합니다. `animus plugin install-defaults`에 의해 설치되는 정확한 `(repo, tag)` 세트는 `crates/orchestrator-core/src/plugin_registry.rs`라는 단일 진실 공급원(single source of truth)에 정의되어 있으므로, CLI 설치 프로그램과 데몬 사전 점검(daemon preflight)은 항상 어떤 태그가 "기본값(the default)"인지에 대해 일치하게 됩니다.

| Kind | Repos |
|---|---|
Protocol + tooling |`animus-protocol` , `animus-plugin-template` , `animus-plugin-registry` |
Subject backends |`animus-subject-default` , `animus-subject-requirements` , `animus-subject-linear` , `animus-subject-sqlite` , `animus-subject-markdown` |
Providers |`animus-provider-claude` , `animus-provider-codex` , `animus-provider-gemini` , `animus-provider-opencode` , `animus-provider-oai` |
Triggers |`animus-trigger-webhook` , `animus-trigger-slack` |
Transports + web UI |`animus-transport-http` , `animus-transport-graphql` , `animus-web-ui` |
Log storage |`animus-log-storage-file` |

animus plugin install launchapp-dev/animus-provider-claude
animus plugin list # SIG 컬럼으로 설치된 항목 확인
animus plugin install-defaults --include-subjects --include-transports
...


설치 시, 발행된 경우 sigstore cosign 서명을 검증합니다. 이를 강제하려면 `--require-signature`를 사용하세요. 자세한 내용은 docs/architecture/plugin-signing.md를 참조하십시오.

**Animus Skills**는 보조 스킬 번들입니다. 위의 원클릭 프롬프트로 설치하거나, 직접 다음 명령어를 사용하여 설치할 수 있습니다:

git clone https://github.com/launchapp-dev/animus-skills.git ~/animus-skills
cd ~/animus-skills && ./setup # 설치된 에이전트 호스트 자동 감지


`./setup` 스크립트는 `--host claude|codex|opencode|cursor|slate|kiro|all`, `--no-cli`(animus 설치 건너뛰기), 그리고 `--no-mcp`(프로젝트의 `.mcp.json` 작성 건너뛰기)를 지원합니다.

| |
| |
|

animus subject Unified subject surface: list/get/create/update/next/status --kind <kind>
(task와 requirement kind는 설치된 subject_backend 플러그인에서 제공됩니다)
animus workflow 다단계 워크플로우 실행 및 관리
...


전체 표면(surface)은 `animus --help`를 실행하여 확인하십시오.

**v0.4.4 버전에서 제거됨:** `animus task` (→ `animus subject --kind task`), `animus requirements` (→ `animus subject --kind requirement`), `animus setup` (→ `animus init`), `animus now` (→ `animus status`), `animus errors` (→ `animus history`).

Animus v0.5는 **커널 + 플레이버 (kernel + flavors)** 아키텍처입니다. 즉, Rust 워크스페이스 데몬 커널(daemon kernel)과 프로바이더(providers), 서브젝트 백엔드(subject backends), 워크플로 실행(workflow execution), 큐(queues), 트랜스포트(transports), 그리고 웹 UI(web UI)를 위한 엄선된 외부 플러그인(out-of-tree plugins) 번들로 구성됩니다. `Cargo.toml`에 정의된 현재 워크스페이스 멤버는 다음과 같습니다:

`animus-plugin-protocol` — 인트리(in-tree) stdio 플러그인 프로토콜 타입들
`animus-plugin-runtime` — 플러그인 구현을 위한 런타임(runtime) 헬퍼들
`orchestrator-daemon-runtime` — 데몬 큐(daemon queue), 스케줄링(scheduling), 서브젝트 디스패치(subject dispatch), 그리고 런타임 감독(runtime supervision)
`orchestrator-logging` — 공유 트레이싱(tracing) 및 로그 파일(log-file) 유틸리티
`orchestrator-plugin-host` — 플러그인 검색(discovery), 설치 상태(install state), stdio 호스트(stdio host), 그리고 프로바이더 세션 브리지(provider session bridge)
`orchestrator-config` — 워크플로 YAML 로딩(loading), 팩 로딩(pack loading), 스캐폴딩(scaffolding), 그리고 페이즈 플랜 해상(phase plan resolution)
`orchestrator-core` — 도메인 서비스(domain services), 부트스트랩(bootstrap), 플러그인 레지스트리(plugin registry), 그리고 상태 변이(state mutation) API
`orchestrator-cli`

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0