Kiro Crew 설치 및 시작

선행 학습

Kiro Crew의 개념과 아키텍처는 Kiro Crew에서 확인하세요.

설치

방법 1: 데스크톱 앱

플랫폼	형식
macOS	서명된 .dmg
Linux	.AppImage

방법 2: One-line CLI 설치

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

설치 후 초기 설정:

kirocrew setup    # 초기 구성
kirocrew doctor   # 환경 점검
kirocrew gateway  # Gateway 데몬 시작

방법 3: Docker

docker pull ghcr.io/kirodotdev/kirocrew:stable
docker run -d -p 5476:5476 ghcr.io/kirodotdev/kirocrew:stable

전제 조건

• Kiro 계정 (IDE/CLI와 동일 계정)
• Python 런타임 (pipx 또는 ~/.kiro/crew/venv)

접근 인터페이스

Crew에 접근하는 방법은 여러 가지입니다:

인터페이스	설명
Web Dashboard	브라우저에서 태스크·메모리·스케줄 관리
Desktop App	macOS·Linux·Windows 네이티브 앱 (Linux ARM64 빌드 포함)
CLI/TUI	kirocrew chat으로 터미널에서 대화
채팅 연동	Slack · Discord · Telegram · Teams · Webex · WeCom · WeChat(Weixin) · WhatsApp · iMessage · Feishu(Lark) 등

빠른 시작 예시

1단계: Gateway 시작

kirocrew gateway

정상 시작 시 http://localhost:5476에서 Web Dashboard에 접근할 수 있습니다.

2단계: CLI로 대화

kirocrew chat

일반 Kiro CLI와 동일한 대화형 인터페이스이지만, 세션 종료 후에도 메모리가 유지됩니다.

3단계: Cron 스케줄 등록

kirocrew cron add --schedule "0 9 * * 1-5" \
  --task "프로젝트 의존성 업데이트 확인 후 요약 리포트 작성"

평일 오전 9시마다 자동으로 태스크가 실행됩니다.

기존 .kiro/ 설정과의 관계

Crew는 별도의 설정 체계를 사용하지 않습니다:

• Steering: .kiro/steering/ 파일이 Crew 세션에도 동일하게 적용됩니다.
• Custom Agents: .kiro/agents/에 정의한 에이전트를 Crew에서도 사용할 수 있습니다.
• Skills: .kiro/skills/ 워크플로를 Crew의 자체 Skills와 함께 활용합니다.
• MCP Servers: mcp.json에 설정한 외부 도구가 Crew에서도 접근 가능합니다.
• ACP: Agent Client Protocol을 공유하여 IDE·CLI와 동일한 도구 생태계를 사용합니다.

참고 링크

리소스	URL
공식 문서	kiro.dev/docs/crew/
제품 페이지	kiro.dev/crew/
블로그	kiro.dev/blog/introducing-kiro-crew/
GitHub	github.com/kirodotdev/KiroCrew

🚨 문제 해결

• Gateway가 시작되지 않음: 포트 5476이 이미 사용 중인지 lsof -i :5476으로 확인하세요.
• kirocrew 명령을 찾을 수 없음: 설치 스크립트 실행 후 셸을 재시작하거나 source ~/.bashrc를 실행하세요.
• Python 환경 오류: kirocrew doctor를 실행하여 Python 경로와 venv 상태를 점검하세요.
• Kiro 계정 인증 실패: IDE 또는 CLI에서 먼저 로그인한 뒤 다시 시도하세요. 계정이 공유됩니다.

✅ 핵심 요약

Crew = 세션을 넘어 지속되는 오픈소스 AI 에이전트. 기존 .kiro/ 설정을 그대로 쓰면서 Cron·Webhook·Subagent로 무인 자동화를 실현합니다.