chenhg5/agencycli

몇 분 만에 자가 관리형 AI 에이전트 팀을 구축하세요.

단 하나의 CLI + 내장된 웹 콘솔. 당신이 잠든 동안 계획하고, 실행하며, 서로 대화하는 에이전트들.

중문 문서 | 빠른 시작 | 설치 | 명령어 | 워크스페이스 레이아웃

agencycli는 AI 에이전트 팀을 구축하고 운영하기 위한 경량 CLI (Command Line Interface)입니다. 팀, 역할, 프로젝트, 기술 등 조직도를 한 번 정의하면, 에이전트들이 스스로 컨텍스트 (Context)를 구성하고, 작업을 가져오며, 정해진 스케줄에 따라 자율적으로 실행합니다.

핵심 기능: 에이전트들이 서로를 채용하고, 메시지를 주고받으며, 협업할 수 있습니다. 당신의 PM (Project Manager) 에이전트가 개발 에이전트에게 작업을 생성할 수 있고, 개발 에이전트는 머지 (Merge) 전 사람에게 확인을 요청할 수 있으며, QA (Quality Assurance) 에이전트는 30분마다 깨어나 열려 있는 PR (Pull Request)을 스캔합니다 — 이 모든 과정은 당신이 손가락 하나 까딱하지 않아도 이루어집니다.

copy_0FA2208D-DB48-49D3-B93E-686C22E82D1C.MOV

컨텍스트 (Context)는 역할 (수평축)과 프로젝트 (수직축)라는 두 축을 통해 구성됩니다. 모든 에이전트는 agency → team → role → project 구조를 가집니다.

컨텍스트는 hire (채용) 시점에 자동으로 병합됩니다. 역할 프롬프트 (Role prompt)를 한 번 변경하면, 해당 역할을 가진 모든 에이전트가 다음 sync (동기화) 시점에 이를 적용받습니다.

에이전트들은 스케줄에 따라 깨어나 작업 큐 (Task queue)를 비운 뒤, 큐가 비워지면 새로운 업무를 선제적으로 찾기 위해 웨이크업 루틴 (Wakeup routine) (wakeup.md)을 실행합니다. 시간 범위, 활성 요일, cron 스케줄 등을 모두 설정할 수 있습니다. 스케줄러가 재시작될 때 발생하는 대규모 요청 폭주 (Thundering herd)를 방지하기 위해 스타트업 지터 (Startup jitter)가 적용됩니다.

모든 참여자 (에이전트 또는 사람)는 수신함 (Inbox)을 가집니다. 메시지는 비차단 (Non-blocking) 및 비동기 (Async) 방식으로 처리되며, 읽지 않은 메시지는 매 웨이크업 프롬프트 상단에 자동으로 주입됩니다. confirm-request는 차단 게이트 (Blocking gate)를 생성하여, 당신이 결정할 때까지 작업을 일시 중지합니다.

팀, 역할, 기술, 에이전트 플레이북 (Playbooks), 프로젝트 청사진 (Blueprints) 등 전체 에이전시 설정을 하나의 .tar.gz 파일로 묶으세요. 이를 공유하거나 단 한 번의 명령어로 새로운 프로젝트에 적용할 수 있습니다.

에이전트들은 격리된 Docker 컨테이너 내부에서 실행됩니다. 호스트 시스템의 의도치 않은 손상, 자격 증명 (Credential) 유출, 제어 불능 프로세스 발생을 방지합니다. 워크스페이스와 agencycli 바이너리는 읽기-쓰기 (Read-write) 모드로 마운트되며, 자격 증명은 읽기 전용 (Read-only) 모드로 마운트됩니다.

기술 (Skills)은 SKILL.md (YAML frontmatter + Markdown 프롬프트 (prompt))와 선택 사항인 스크립트로 구성되며, 해당 기술이 바인딩된 모든 에이전트 (agent)에 배포됩니다. 한 번 정의하여 역할 (role)에 부착하면 sync 시 자동으로 전파됩니다.

가장 쉬운 방법 — 이 내용을 Claude Code 또는 모든 AI 코딩 에이전트 (AI coding agent)에게 보내면 설치 및 설정을 모두 대신 처리해 줍니다:

https://raw.githubusercontent.com/chenhg5/agencycli/refs/heads/main/INSTALL.md 를 따라 agencycli를 설치하고 설정하세요.

npm install -g @agencycli/agencycli # npm 사용, Go 불필요
go install github.com/chenhg5/agencycli/cmd/agencycli@latest # Go 사용
# 소스 코드로부터 설치 (웹 콘솔 포함)
...

git clone https://github.com/chenhg5/agencycli
cd agencycli
make build # 웹 프론트엔드(web frontend) + Go 바이너리(binary) 빌드 → dist/agencycli
...

# 1. 워크스페이스 (workspace) 생성 (.gitignore + agency-prompt.md 생성)
agencycli create agency --name "MyAgency"
cd MyAgency
...

웹 콘솔 (web console)은 바이너리에 내장되어 있어 별도의 프로세스나 Node.js가 필요하지 않습니다. 다음 명령 하나로 실행할 수 있습니다:

agencycli start # 기본값: 127.0.0.1:27892
agencycli start --addr 0.0.0.0:8080 # 사용자 정의 주소
agencycli start --api-key my-secret # 인증 (auth) 포함

기능 (Capabilities): 워크벤치 (workbench) (메시지 + 작업), 팀/역할 관리 (team/role management), 프로젝트 멤버 (project members), 스케줄 (schedule) (하트비트/cron/런타임), 실행 기록 (run history) 및 토큰 비용 (token costs), 세션 관리 (session management), 에이전트 실행 (agent run), 프롬프트 편집 (prompt editing), 기술 (skills) — 이 모든 기능은 국제화 (i18n) (영어 / 中文 / 繁體中文 / 日本語) 및 다크 모드 (dark mode)를 지원합니다.

핫 리로드 (hot-reload)를 지원하는 로컬 개발 (local development)의 경우:

agencycli api serve

+cd web && pnpm dev
.

agencycli는 SDK가 아닌 런타임 레이어 (runtime layer)입니다. 에이전트 (agents)는 여러분이 이미 사용 중인 어떤 CLI 도구든 될 수 있습니다:

에이전트 런타임 (Agent runtime)	--model
Claude Code	claudecode
...

모델을 자유롭게 혼합하세요 — PM은 Claude에서, 개발 에이전트 (dev agents)는 Codex에서, 작가 에이전트는 Gemini에서 실행할 수 있습니다. 각 에이전트는 자신의 런타임이 기대하는 정확한 형식으로 컨텍스트 (context)를 전달받습니다.

agencycli
├── start # 웹 콘솔 실행 (API + 프론트엔드)
├── overview # CLI 대시보드 (dashboard)
...

→ 전체 명령어 참조 (Full command reference)

→ 워크스페이스 레이아웃 (Workspace layout)

→ Docker 샌드박스 (Docker sandbox)

→ HTTP / OpenAI 호환 에이전트 (OpenAI-compatible agent)

이것들은 프레임워크 (Frameworks)입니다 — 에이전트들을 서로 연결하기 위해 Python을 작성해야 합니다. agencycli는 인프라 (Infrastructure)입니다 — Markdown과 YAML을 작성합니다. 에이전트는 당신이 이미 사용 중인 어떤 CLI 도구든 될 수 있습니다. SDK도 없고, 종속성 (Lock-in)도 없으며, 실행할 서버도 필요 없습니다.

agencycli	프레임워크 기반 (Framework-based)
에이전트 런타임 (Agent runtime)	기존의 CLI 도구
...	...

AGPL-3.0 — 자유롭게 사용하고 수정할 수 있지만, 모든 수정 사항은 오픈 소스로 공개되어야 합니다. 이는 클라우드 제공업체가 폐쇄 소스 포크 (Closed-source forks)를 서비스 형태로 제공하는 것을 방지합니다.