소프트웨어 개발을 위한 에이전트 운영체제 Allen

AI 에이전트들로 구성된 협업 조직에 작업을 할당하고, 실제 저장소(repository)를 대상으로 실행되는 과정을 관찰하며, 체크포인트에서 개입하여 시간이 지남에 따라 개선하는 소프트웨어 개발을 위한 에이전트 운영체제입니다.

웹사이트: https://askallen.build/

Allen은 사용자의 코드베이스를 대상으로 하는 다팀(multi-team) AI 에이전트 조직을 구동합니다. 채팅으로 Allen과 대화하거나 Linear 티켓을 전달할 수 있습니다. 팀 리드 에이전트가 계획을 세우고 전문 코딩 에이전트에게 작업을 위임하며, 작업은 라이브 터미널이 있는 격리된 git worktree에서 실행됩니다. 모든 단계는 추적되고, 모든 출력물은 아티팩트(artifact)이며, 인간이 정의된 체크포인트에서 승인합니다. GitHub, Linear, Slack, MCP 서버, Claude Code, 그리고 Codex와 통합됩니다.

상태: early alpha. 전용 작업 공간 및 일회성 또는 비핵심 저장소에 먼저 실행해 보세요. 중요한 코드를 대상으로 사용하기 전에 워크플로우와 에이전트 정의를 검토하세요.

• Allen이 하는 일
• 핵심 개념
• 빠른 시작(Quickstart)
• 첫 번째 워크플로우
• 기능 투어
• 아키텍처
• 기본 포트
• 구성
• 통합
• 개발
• 문서화
• 보안
• 기여하기
• 라이선스

채팅 기반 에이전트 작업. 채팅을 열고 작업을 설명하면 Allen이 적절한 에이전트나 워크플로우로 라우팅합니다. 에이전트는 다른 에이전트에게 위임할 수 있으며, 전체 위임 트리가 표시됩니다. 모든 채팅은 구성 가능한 마스킹(redaction)을 거쳐 휴대용 JSON 번들(메시지, 실행 기록, 로그, 추적 경로, 아티팩트 포함)로 내보낼 수 있으며, 이 번들을 다른 Allen 인스턴스에 읽기 전용으로 재생(replay)할 수 있습니다.**시드된 에이전트 조직.**Allen은 첫 부팅 시 6개의 팀(경영진, 제품, 엔지니어링, 품질, 메타, 미배정)과 20개 이상의 에이전트를 시딩합니다. 이들 중 팀 리드는 오케스트레이션 역할을 하고, 전문가는 코드를 작성하고, 검토하며, 테스트하고, 문서화하고, 버그를 조사하며, PR 피드백을 해결하는 역할을 합니다.**YAML 워크플로우.**에이전트 노드, 코드 노드, 조건문(conditionals), 병렬 분기(parallel branches), 서브 워크플로우, 인간 검토 지점(human checkpoints)을 포함한 다단계 파이프라인입니다. 9가지 워크플로우가 내장되어 제공됩니다(계획 수립, 버그 수정, 기능 구현, PR 검토 해결, 자가 치유 등).**격리된 작업 공간.**모든 코딩 작업은 전용 git worktree에서 실행되며, 라이브 터미널(WebSocket PTY), 파일 감시자(file watcher), 개발 서버 미리 보기를 위한 리버스 프록시를 갖추고 있습니다.**완벽한 실행 관측 가능성.**추적 경로(Traces), 노드별 로그, 도구 호출(tool calls), 비용 및 토큰 사용량 분석(캐시된 입력, 캐시되지 않은 입력, 출력), 검토 지점(checkpoints), 아티팩트, 그리고 모든 워크플로우에 대한 Mermaid 그래프를 제공합니다.**인간 개입 루프(Human-in-the-loop).**워크플로우는 개입 지점(승인, 질문, 에스컬레이션)에서 일시 중지되고 사람을 기다립니다.**통합(Integrations).**GitHub(PR 동기화, CodeRabbit 댓글 해결), Linear(에이전트/워크플로우로 티켓 전송), Slack(스레드 채팅), 그리고 MCP 서버(Postgres, 사용자 지정 도구 등)와 통합됩니다.**자가 치유(Self-healing).**시간당 모니터가 Allen 자체의 런타임을 감시하고, 사고를 지문 인식하며, Linear 티켓을 작성하고, 버그 수정 워크플로우를 자동으로 전송할 수 있습니다.**학습/메모리.**에이전트는 글로벌/워크플로우/컨텍스트/에이전트별로 범위가 지정된 학습 내용(사실, 패턴, 실수)을 캡처하고 검색하며, 임베딩으로 지원됩니다.

Anthropic 계정이 필요합니다."
Codex CLI — 선택 사항.
npm install -g @openai/codex를 통해 설치합니다。

Allen의 채팅은 기본적으로 Codex를 사용하며, .env 파일에 ALLEN_DEFAULT_CHAT_PROVIDER=claude-cli를 설정하면 대신 Claude Code를 사용하여 채팅하고 OpenAI 계정 인증을 완전히 건너뛸 수 있습니다.

지원 플랫폼: macOS 및 Linux (Windows에서는 WSL2). 네이티브 Windows는 지원하지 않습니다.

git clone https://github.com/Inomy-shop/allen.git
cd allen

./scripts/setup.sh

설정 스크립트는 다음 순서로 작동합니다:

• npm 10+ 및 git을 확인하고, Node가 없거나 버전이 22보다 낮으면 nvm을 통해 Node 22를 설치합니다.
• MongoDB 7(macOS의 경우 Homebrew 사용)을 확인/설치하고 localhost:27017에서 접근 가능한지 확인합니다.
• 누락되었거나 PATH에 있는 버전이 --agent 지원 기능을 갖추지 못한 경우, 공식 설치 프로그램을 통해 독립형 Claude Code CLI를 설치합니다.
• 누락된 경우 npm을 통해 Codex CLI를 설치합니다.
• 모든 작업 공간 패키지에 걸쳐 npm install을 실행합니다.
• .env.example에서 .env 파일을 생성하고, JWT_ACCESS_SECRET/JWT_REFRESH_SECRET를 생성하며, CLAUDE_BIN을 확인된 독립형 CLI에 자동으로 고정(pin)합니다.
• 선택적 Cognee 기반 컨텍스트 엔진 설치 여부를 묻습니다. Enter 키를 누르면 건너뛰고, 나중에 npm run setup:context를 실행하여 설치할 수 있습니다.
• npm run health를 실행하고 종속성별로 PASS/FAIL을 출력합니다.

재실행은 안전합니다. 이미 완료된 작업은 건너뛰고 .env 파일을 보존합니다. 만약 단계 중 하나가 실패하면 스크립트는 빨간색 오류 줄과 함께 종료됩니다. 자세한 내용은 docs/troubleshooting.md를 참조하세요 → 설정 스크립트 실패 시 수정 매트릭스 참고.

claude # Anthropic 계정으로 로그인
codex # 선택 사항: OpenAI 계정으로 로그인 (chat에 claude-cli를 사용하는 경우 건너뜁니다)

두 CLI 모두 첫 로그인 후 디스크에 인증 정보를 유지합니다.

패키지들은 dist/로 컴파일되며 엔진은 빌드된 종속성(built dependency)으로 사용되므로, 시작하기 전에 반드시 빌드를 수행해야 합니다:

npm run build
npm start

이 명령어는 API 서버를 http://localhost:4023에서, UI를 http://localhost:5173에서 시작합니다.

http://localhost:5173을 엽니다.

. 새로운 인스턴스에서 Allen은 온보딩 플로우를 실행합니다: 첫 번째 관리자 계정 생성 → 상태 확인(health check) → 리포지토리 등록 → 첫 워크플로우 실행. 사용자 계정이 존재하면, first-admin 부트스트랩 엔드포인트가 닫히고 정상적으로 로그인할 수 있습니다.

필요할 때마다 종속성 검사를 다시 실행할 수 있습니다:

npm run health

첫 실행을 위해 임시적이거나 중요하지 않은 리포지토리를 사용하세요. 에이전트는 파일을 검사하고, 구현 워크플로우는 코드를 작성하고, 브랜치를 생성하며, PR(Pull Request)을 열 수 있습니다.

• Agents → Repos 화면에서 리포지토리 등록 (로컬 경로 또는 GitHub SSH URL에서 클론)
• Workflows를 열고 bug-fix-by-severity를 선택합니다.
• 리포지토리를 선택하고 버그 보고서를 입력합니다 (예:

|
multi-repo-change-orchestration.yml |
크로스 리포지토리 변경 전달을 위한 부모 오케스트레이터 — 각 리포지토리에 대한 작업 명확화, 계획 수립, 승인 후 자식 워크플로우 실행.

단계별 가이드는 docs/first-workflow.md를 참조하세요.

채팅 및 위임(Chat & delegation). 모든 에이전트와 대화할 수 있습니다. @mention으로 워크플로우, 리포지토리, 에이전트 또는 Linear 티켓(@ENG-123)을 언급하세요. 에이전트는 다른 에이전트에게 작업을 위임하며, 대화 스레드는 유지되고 위임 트리는 실행 뷰에서 볼 수 있습니다.

시각적 워크플로우 빌더(Visual workflow builder). UI(/workflows/new)에서 에이전트/조건/병렬/휴먼 노드를 연결하여 워크플로우를 구축하거나, packages/engine/workflows/에 YAML을 확인하세요. 엔진은 로드 시 구조를 검증하고 Mermaid 그래프로 렌더링합니다.

워크스페이스(Workspaces). 모든 코딩 작업은 <ALLEN_HOME>/worktrees/ 아래에 git worktree를 갖습니다. 사이드바에서 워크스페이스를 클릭하면 워크스페이스 모드 채팅(workspace-mode chat) (/chat?workspaceId=…)으로 열립니다: + 새 채팅, 닫기/복원, 리포지, 브랜치 및 worktree 경로를 보여주는 컨텍스트 바가 있는 브라우저 스타일의 탭 스트립입니다. 워크스페이스와 연결된 채팅에서 에이전트는 자동으로 cwd가 해당 worktree로 설정되어 실행됩니다. 워크스페이스 페이지(컨텍스트 바에서 접근 가능)에서는 여전히 라이브 터미널, 파일 브라우저 및 dev-server 미리보기 프록시를 제공합니다.

실행 및 추적(Executions & traces). 실행 페이지는 실행 중이거나 최근의 실행 목록을 보여줍니다 (페이지네이션, 필터링 가능). 모든 실행으로 드릴다운하여 노드 타임라인, 노드별 로그, 페이로드를 포함한 도구 호출, 토큰 사용 내역 분석 (캐시된 입력, 캐시되지 않은 입력, 출력 — 노드별 및 실행 총계), 비용 회계, 체크포인트 및 아티팩트를 확인할 수 있습니다.

채팅 내보내기/가져오기(Chat export/import). 채팅 세션을 메시지, 도구 호출(tool calls), 실행 트리(execution trees), 로그(logs), 추적 기록(traces), 아티팩트(artifacts), 개입(interventions), 감시자 상태(watcher state), 코드 차이 스냅샷(code-diff snapshots)을 포함하는 다운로드 가능한 JSON 번들로 내보낼 수 있습니다. 토글은 포함할 내용을 제어하며, 마스킹 옵션(redaction options)은 경로(paths), 식별자(identity), 비밀 정보(secrets)를 정리합니다. 다른 Allen 인스턴스에서 번들을 가져오려면: 미리 보기 단계에서 카운트와 경고가 표시된 후, 가져오기가 새로운 로컬 채팅을 생성하며 이는 읽기 전용 재생(read-only replay)으로 명확하게 표시되고 작성기(composer)는 비활성화되며 영구 배너가 나타납니다.

멀티 윈도우 데스크톱(Multi-window desktop). Electron 데스크톱 앱은 여러 개의 독립적인 창을 지원합니다(파일 → 새 창, Cmd+N 또는 macOS Dock 마우스 오른쪽 버튼 클릭 → 새 창). 각 창은 동일한 백엔드를 공유하지만 독립적으로 탐색하며 — 예를 들어 한 창에서 채팅 작업을 하는 동안 다른 창에서는 워크스페이스를 탐색할 수 있습니다. 창을 닫는 것이 공유 런타임(shared runtime)을 종료하거나 다른 열린 창에 영향을 주지는 않습니다. 데스크톱 모듈을 참조하십시오.

개입(Interventions). 워크플로우가 사람 노드(human node)에 도달하면 마감 기한이 있는 개입(interventions) (승인/질문/에스컬레이션)을 생성합니다. 개입 페이지는 필요한 사항을 나열하며, 답변하는 것이 실행을 재개합니다.

티켓(Tickets) (Linear). Linear 이슈를 탐색하고 필터링하며, 선호 에이전트를 표시하고, 티켓을 에이전트나 워크플로우로 전송할 수 있습니다. Allen은 선택된 리포지토리에서 워크스페이스를 생성하고 해당 티켓을 프롬프트(prompt)로 사용하여 에이전트를 실행합니다. Allen은 이슈를 읽고 로컬에서 할당을 추적하며, 쓰기 작업(write-back)은 Linear MCP 서버를 통해 이루어집니다.

풀 리퀘스트(Pull requests). GitHub PR을 미러링하고 CodeRabbit의 댓글을 추적하며, 검토 피드백을 자동으로 처리하기 위해 resolve-pr-reviews 워크플로우를 트리거할 수 있습니다.

크론/예약 작업(Cron / scheduled work). 6개의 내장 작업(리포지토리 스캔/풀, PR 동기화, MCP 번들 정리, CodeRabbit 스윕, 시간별 자가 복구 모니터)과 스케줄 페이지를 통해 사용자 생성 예약 에이전트/워크플로우 실행을 지원합니다.

자가 복구 모니터링(Self-healing monitoring). 시간별로 에이전트가 주도하는 스캔을 통해 Allen의 자체 런타임 기록을 검사하고, 인시던트를 지문 인식하여 중복 제거하며, Linear 티켓을 작성하고 심각도별 버그 수정(bug-fix-by-severity)를 자동으로 전송할 수 있습니다. . See docs/SELF_HEALING_MONITORING.md .