Kiro Crew — 영속 개발 워크스페이스

먼저: Crew가 필요한가?

작업	먼저 쓸 도구
지금 한 프로젝트를 대화하며 수정·검토	Kiro IDE 또는 CLI
터미널에서 한 번 실행할 명령·스크립트	Kiro CLI
자리를 비운 동안 이어질 작업, 일정 실행, 여러 작업의 병렬 조율	Kiro Crew

IDE나 CLI만으로 작업이 끝난다면 Crew를 추가할 필요가 없습니다. Crew는 세션을 넘어 상태를 유지하거나, 스케줄·외부 이벤트·여러 에이전트 조율이 필요할 때 사용합니다.

Kiro Crew란

로컬 또는 원격 하드웨어에서 동작하는 오픈소스(Apache 2.0) 개인 AI 에이전트입니다. Kiro의 다른 app(IDE·CLI·Web·Mobile)이 공통 unified agent harness를 소비하는 front door인 것과 달리, Kiro Crew는 그 harness(기본 런타임 = Kiro CLI) 위에 올라가는 오케스트레이션 레이어로서 세션을 넘어 지속되는 에이전트 환경을 제공합니다.

Kiro는 Crew를 단순한 app이 아니라 harness 위에 세워진 "시스템 확장(집)"으로 설명합니다. always-on 자동화, 멀티에이전트 오케스트레이션, 세션 간 메모리 같은 기능 중 일부는 공통 harness가 아니라 Crew 자체에 들어 있으며, 공식적으로도 향후 harness와 다시 정합을 맞출 계획이라고 밝히고 있습니다. 구조 전체 그림은 Kiro란·왜 스펙 기반에서 확인하세요.

핵심 차별점 4가지

특성	설명
Persistent	세션 종료 후에도 메모리와 상태를 유지. 장기 메모리(선호·프로젝트·일일 이력·lessons)로 컨텍스트 보존
Self-learning	Lessons 시스템으로 수정·실패 패턴을 스스로 학습하여 이후 세션에 주입, 반복 오류를 줄임
Self-evolving	반복 패턴에서 Skills를 합성·개선하여 시간이 갈수록 더 정교한 작업 수행
Unattended	Cron·Webhook·Heartbeat으로 사람 없이도 자동 트리거·백그라운드 실행

기존 Kiro와 무엇이 다른가 — kiro-cli 단독 vs Kiro Crew

IDE·CLI 같은 app은 한 번에 하나의 세션에 집중하는 대화형 도구입니다. Kiro Crew는 같은 kiro-cli 런타임을 쓰되, "런타임이 일부러 관여하지 않는 것"(스케줄·메모리·멀티에이전트·거버넌스)을 위에서 더해주는 게이트웨이입니다. 공식 아키텍처 문서의 비교를 요약하면 다음과 같습니다.

역량	kiro-cli 단독 (app)	Kiro Crew
세션	터미널당 1개	다수 동시(채널 스레드·대시보드 슬롯·cron·subagent·task 스텝)
접근 표면	터미널만	CLI·웹 대시보드·데스크톱 앱 + 메신저 채널(Slack·Discord·Telegram·Teams·WeChat 등)
지속성	디렉터리별 대화 기록	세션을 넘는 메모리(선호·프로젝트·일일 이력·lessons)
세션 간 학습	없음	같은 메모리 저장소를 공유하는 세션끼리 학습 공유
스케줄링	없음	Cron 작업(every/at/cron 식) + 프로세스 간 파일 락
자율 태스크	없음	TaskRunner: 명세→분해→실행→재시도→리플랜→체크포인트
자가 학습	없음	수정에서 Lessons 추출해 이후 세션에 주입
도구 게이팅	에이전트 설정별	독립 PreToolUse 게이트 + 에이전트가 못 낮추는 2단계 거버넌스 상한
컨텍스트 관리	수동 압축	임계값 자동 압축, 예산 인지형 컨텍스트 조립, 감쇠 메모리
프로세스 복원력	수동 재시작	웜 풀·서킷 브레이커·크래시 복구·유휴 정리

한 줄 요약: IDE는 "코드를 쓰는 곳", CLI는 "스크립트로 돌리는 곳", Kiro Crew는 "여러 에이전트가 스케줄에 따라, 당신이 자리를 비운 동안에도 계속 일하는 곳" 입니다.

언제 Kiro Crew를 쓰나

Crew는 "직접 운전(drive)"이 아니라 "위임(delegate)"에 적합합니다. 공식 가이드가 드는 예시:

• 티켓 큐 처리 — 큐를 넘겨주면 분류·분배를 대신 수행
• 여러 레포에 걸친 장애 조사 — 당신이 수정에 집중하는 동안 Crew가 조사
• 긴 마이그레이션 — 회의 중이거나 자는 동안 체크포인트·재시도를 거치며 진행
• 정기 작업 — "평일 오전 9시에 검토할 열린 작업을 요약" 같은 cron 작업
• 병렬 리서치 — 여러 선택지를 subagent로 병렬 조사 후 종합

따라서 자연스러운 사용자층은 한 에이전트를 손으로 조종하기보다 여러 에이전트를 문제에 투입하려는 파워 유저·프런티어 개발자입니다.

출시 상태와 라이선스

항목	내용
라이선스	Apache License 2.0 (Kiro의 첫 오픈소스 app)
공개일	2026-08-04
과거 명칭	사내에서 MeshClaw로 운영되다 오픈소스로 공개
GitHub	kirodotdev/KiroCrew
릴리스 채널	stable(기본) · insider(RC) · nightly(main)

Web·Mobile과 달리 Preview 태그 없이 OSS로 공개되어 있으며, GA 제품에 준하는 품질·지원 기준을 적용한다고 공식적으로 밝히고 있습니다.

아키텍처 개요

Kiro Crew는 Kiro CLI(ACP harness) 위에서 동작합니다. CLI(런타임)는 LLM 연결, 도구 실행, MCP 관리, 세션 영속화, 컨텍스트 압축, ACP(Agent Client Protocol, JSON-RPC 2.0 stdio) 를 담당하고, Gateway는 그 위에서 스케줄·메모리·멀티에이전트 조율·거버넌스를 더합니다. 기존 .kiro/ 디렉터리의 Steering·Skills·Custom Agents 설정을 그대로 사용하고, Kiro 계정·과금 체계를 공유합니다.

kirocrew 자체도 하나의 에이전트 설정일 뿐입니다. 게이트웨이가 기본값으로 그것을 쓰고, 다른 에이전트와 세션을 열도록 요청하는 MCP 도구(spawn_run, cron_add, task_run)를 쥐고 있어서 "코디네이터" 역할을 합니다. 조율 동작은 게이트웨이 코드가 아니라 에이전트 설정에 들어 있습니다.

핵심 개념

Gateway

로컬 서버(http://localhost:5476)로 동작하며, 표면(채널·대시보드·CLI)을 런타임에 다중화하고 세션·스케줄·외부 트리거를 관리하는 중앙 데몬입니다.

Persistent Sessions & Memory

종료 후에도 상태가 보존됩니다. 선호·프로젝트·일일 이력·lessons가 메모리 저장소에 쌓여 다음 세션에서 이어지며, 같은 저장소를 공유하는 세션끼리 학습이 전파됩니다.

Lessons & Skills

• Lessons: 수정·실패 패턴을 durable lesson으로 기록해 이후 세션에 주입합니다. 전역 적용 또는 특정 레포로 범위를 제한(repo scope)할 수 있습니다.
• Skills: 반복 패턴을 재사용 가능한 워크플로로 합성합니다. 검사·수정·삭제할 수 있습니다.

Cron · Webhooks · Heartbeats

트리거	설명
Cron	시간 기반 스케줄(every/at/cron 식)로 정기 작업 자동 실행
Webhooks	인증된 외부 이벤트(GitHub push 등)에 반응하여 태스크 시작
Heartbeats	주기적 상태 확인으로 장시간 작업 모니터링

Subagents & Task Runner

• Subagents: 병렬 작업이 가치 있을 때(독립 작업 병행, 큰 입력 distillation, 독립 검증, 특화 역량 필요, 사용자 요청) 격리된 subagent를 띄워 결과를 부모 대화로 가져옵니다. 별도 명령 없이 에이전트가 판단합니다. 각 subagent는 독립 세션에 전체 메모리(선호·lessons·프로젝트 컨텍스트)를 주입받지만 현재 대화의 진행 중 작업은 보지 못합니다. 이로써 메인 세션을 가볍게 유지하고 subagent끼리 서로 간섭하지 않게 합니다.
• Task Runner: 태스크 명세를 받아 분해→실행→검증→실패 재시도→체크포인트에서 재개까지 자율 수행합니다. "이 마이그레이션을 수행하되 테스트 실패 시 멈춰" 같은 지시가 검증 포함 체크포인트 태스크로 돌아갑니다.

Subagent vs Task Runner: Subagent는 "같은 질문을 여러 갈래로 병렬 조사/검증" 할 때(팬아웃), Task Runner는 "하나의 긴 작업을 끝까지 자율 완수" 할 때(체크포인트·재시도) 씁니다. 전자는 폭, 후자는 깊이입니다.

Browser · Multi-instance · Apps (확장 표면)

Crew는 대화·스케줄을 넘어 실행 표면 자체를 넓힙니다. 깊이 있는 내용은 전용 문서로 이어집니다.

• Crew 브라우저: 실제 웹 페이지를 조작(이동·클릭·입력·폼 제출). 네이티브 패널 경로와 playwright-cli 폴백.
• 멀티 인스턴스 · Remote Crew: 원격 하드웨어(EC2 네이티브 SSM / ECS Fargate)에서 always-on 운영.
• 설정: config.json·.env·환경 변수·데이터 홈과 프라이버시 기본값.

Apps (App SDK)

대시보드 페이지·스코프된 Gateway API·이벤트·라이프사이클 훅으로 특정 업무에 맞춘 인터페이스/워크플로를 추가합니다. TypeScript 또는 Python으로 작성합니다.

거버넌스·보안

도구 승인, OS 샌드박싱, 민감 경로 검사, 자격 증명 마스킹, deny 규칙, 감사 이벤트, 거버넌스 프로파일을 조합한 다층(defense-in-depth) 모델입니다. 에이전트가 스스로 낮출 수 없는 거버넌스 상한을 둡니다.

app과 Kiro Crew의 비교

특성	IDE·CLI·Web·Mobile (app)	Kiro Crew (오케스트레이션 레이어)
위치	harness를 소비하는 front door	harness 위에 올라가는 시스템 확장
세션 지속	단일 세션 내	세션을 넘어 영속
메모리	세션 종료 시 소실	메모리 저장소로 보존·전파
트리거	사용자 입력	Cron·Webhook·Heartbeat
실행 방식	대화형(attended)	무인(unattended) 가능
병렬성	단일 에이전트(IDE Agent Focus 등으로 확장)	Subagent 오케스트레이션
설정 공유	.kiro/	.kiro/ 그대로 사용

무엇을 언제 쓰나 — 통합 결정 가이드

Crew의 기능이 많다 보니 "이건 언제 쓰지?"가 가장 흔한 질문입니다. 상황별로 정리하면:

하고 싶은 것	쓰는 기능	대신 고려할 것
지금 대화하며 바로 코딩	일반 chat 세션	— (굳이 Task Runner 불필요)
긴 작업을 자리를 비운 사이 완수	Task Runner	체크포인트·검증 조건을 지시에 명시
여러 선택지/레포를 병렬 조사	Subagents	결과 종합은 메인 세션이 담당
정기 반복 작업	Cron	1회성이면 그냥 chat
외부 이벤트(예: GitHub push)에 반응	Webhooks	시간 기반이면 Cron
로그인·클릭이 필요한 웹 작업	Browser	읽기만이면 단순 페이지 페치
노트북을 닫아도 계속 돌게	Remote Crew	상시 켜 둘 수 있으면 로컬
반복 패턴을 재사용 워크플로로	Skills	1회성 지시면 불필요
수정·실패를 다음 세션에 반영	Lessons	자동 축적되므로 보통 별도 조치 불필요

큰 원칙: Crew는 "직접 운전(drive)"보다 "위임(delegate)" 에 가치가 있습니다. 손으로 조종할 작업이면 IDE·CLI가, 맡겨두고 결과를 받을 작업이면 Crew가 맞습니다.

버전별 변화 추적

Crew는 Preview 없이 OSS로 공개된 뒤 빠르게 진화하고 있습니다. 업그레이드 전에 바뀐 전제를 확인하세요. (1차 출처는 공식 changelog)

버전	주요 변화
0.3	Crew Mode(한 채팅에서 병렬 서브세션 디스패치) · 대시보드 내장 브라우저 · 네이티브 Linux ARM64 빌드 · Windows 1급 지원 · Git 패널 · Node.js 22 최소 요건 · Telegram 단일 계정 · Knowledge 자동 수집 opt-in (0.3)
0.6	세션별 harness(런타임) 선택 (Preview) · 연결된 remote crew에서 작업 시작 (Preview) · crew 멤버의 자체 워커 디스패치 · Apps Launchpad (0.6)

다음 단계

• 설치·접근·빠른 시작: Kiro Crew 설치 및 시작
• 확장 표면: Browser · 멀티 인스턴스 · 설정