Kiro CLI 기초

Kiro 배경은 IDE 기초에서

같은 엔진에 터미널 인터페이스 — .kiro/ 설정 공유·Plan 검토·Tool Trust·Headless 자동화가 CLI의 핵심 축

IDE vs CLI

같은 엔진, 다른 인터페이스

.kiro/ 설정의 두 스코프

Global(전역) 또는 Workspace(프로젝트) 단위로 설정하며, Workspace가 우선

🌐 Global — ~/.kiro/ (모든 Workspace 공통)

~/.kiro/                (Global)
├── steering/           # 팀 표준, 보안 정책
│   ├── coding-standards.md
│   └── team-conventions.md
├── settings/
│   └── mcp.json        # 전역 MCP
├── hooks/              # 전 워크스페이스 적용 훅
├── agents/
└── skills/

📁 Workspace — /.kiro/ (Git 공유 · 우선순위 높음)

<project>/.kiro/        (Workspace)
├── steering/           # 아키텍처, 컨벤션
│   ├── product.md
│   ├── tech-stack.md
│   └── conventions.md
├── specs/              # 요구사항/설계/태스크
├── settings/
│   └── mcp.json        # Workspace 전용 MCP
├── hooks/
├── agents/
└── skills/

CLI 시작

설치에서 첫 대화까지 — 세션이 열리기까지 필요한 네 단계

4단계로 CLI 시작

curl 설치 → 브라우저 인증 → kiro-cli chat → @파일·슬래시 명령 작업의 순서

1. 1
   설치

   • macOS/Linux: curl -fsSL https://cli.kiro.dev/install | bash
   • Windows: irm 'https://cli.kiro.dev/install.ps1' | iex
   • Ubuntu: .deb 패키지 (sudo dpkg -i kiro-cli.deb)
   • 주의 — Homebrew/npm 설치 미지원, 공식 설치 스크립트만 사용
2. 2
   인증

   • 첫 실행 시 브라우저 로그인 — GitHub·Google·Builder ID·IAM Identity Center 중 선택
   • 또는 kiro-cli login으로 수동 인증 시작
   • Device Flow 지원 — SSH/컨테이너에서도 인증 가능
   • KIRO_HOME 환경변수로 설정 디렉토리 변경 가능
3. 3
   세션 시작

   • kiro-cli chat으로 대화형 세션 시작
   • 현재 디렉토리가 워크스페이스로 설정
   • .kiro/ 있으면 Steering/Hooks/Skills 자동 로드
   • IDE와 동일한 모델과 설정을 공유
4. 4
   작업

   • 자연어로 요청 → AI가 코드 생성/수정/실행
   • @파일경로로 특정 파일 컨텍스트 지정
   • Tool Trust(Yes·Trust·No)로 도구 실행 승인 제어
   • 슬래시 명령어 — /plan · /compact · /clear · /upgrade-agent(V2→V3 agent 설정 마이그레이션)

실행 모드

지금 이 작업엔 어떤 모드가 맞는가 — 세 가지 선택지

3가지 모드

상황에 맞는 CLI 실행 모드 선택

1. 1
   Interactive

   • 기본 모드 — kiro-cli chat으로 시작
   • 자연어 요청 → 즉시 코드 생성/수정
   • @파일, 슬래시 명령어, Tool Trust로 제어
   • Introspect 서브에이전트 — Kiro 기능·설정 질문에 응답 (CLI V3부터 사용 가능)
   • 탐색적 개발, 디버깅, 프로토타이핑에 최적
2. 2
   Plan

   • Shift+Tab으로 전환
   • AI가 실행 계획을 먼저 보여줌
   • 계획 승인 후에만 파일 변경 실행
   • 멀티파일 변경, 아키텍처 결정에 안전
3. 3
   Headless

   • --no-interactive 플래그로 비대화형 실행
   • 프롬프트는 위치 인자로 전달 — kiro-cli chat --no-interactive "..."
   • exit 0=성공 · 1=실패 · 3=MCP 시작 실패로 파이프라인 분기
   • CI/CD, GitHub Actions, CodeBuild에 삽입

Plan 모드

실행 전에 계획을 먼저 보는 승인 게이트

Plan 모드 워크플로우

요청 → 계획 출력 → 검토 → 실행 — 승인 전에는 자연어로 계획 자체를 수정 가능

1. 1
   요청

   • 자연어로 원하는 작업 요청
   • "인증 미들웨어 추가해줘"
   • "API 엔드포인트 리팩토링해줘"
2. 2
   계획 출력

   • AI가 실행 계획을 텍스트로 표시
   • 어떤 파일을 만들/수정할지 명시
   • 예상 변경 범위와 순서를 보여줌
3. 3
   검토

   • 사용자가 계획을 읽고 판단
   • "테스트 파일도 추가해줘"로 계획 수정 가능
   • 불필요한 변경이 있으면 제거 요청
4. 4
   실행

   • 승인하면 AI가 계획대로 실행
   • 각 파일 변경마다 Tool Trust 적용
   • 실행 중에도 Ctrl+C로 중단 가능

일반 모드 vs Plan 모드

Plan 모드를 쓸 시점의 판단 기준

Tool Trust

도구 실행 하나하나를 승인으로 제어하는 안전 장치

Tool Trust 승인 체계

AI가 신뢰되지 않은 도구를 쓸 때마다 입력창 위 알림 바로 승인 요청 — 3가지로 응답

승인 장면 — 알림 바에서 3초 판단

신뢰되지 않은 도구가 호출되는 순간 — 입력창 위에 뜨는 실제 알림 바

도구별 권장 정책

안전과 편의의 균형

Headless

사람 없이 파이프라인 스텝으로 도는 CLI

CI/CD 파이프라인 통합

GitHub Actions에서 Kiro CLI 실행

# .github/workflows/kiro-review.yml
name: Kiro Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Kiro CLI
        run: curl -fsSL https://cli.kiro.dev/install | bash

      - name: Run Code Review
        env:
          KIRO_API_KEY: ${{ secrets.KIRO_API_KEY }}
        run: |
          kiro-cli chat \
            --no-interactive \
            --trust-all-tools \
            "변경된 파일을 리뷰하고 문제점을 보고해줘"

      - name: Check Exit Code
        if: failure()
        run: echo "Kiro가 문제를 발견했습니다"

Headless 실행 흐름

push에서 결과 리포트까지

1. 1
   git push

   • PR 생성 또는 커밋 푸시가 파이프라인 트리거
   • GitHub Actions, CodeBuild, GitLab CI 등
   • on: [pull_request] 또는 on: [push]
2. 2
   환경 준비

   • CI 러너에 Kiro CLI 설치 (공식 설치 스크립트: curl -fsSL https://cli.kiro.dev/install | bash)
   • 인증 키를 환경변수로 설정 (KIRO_API_KEY)
   • --trust-all-tools로 자동 승인
3. 3
   Kiro 실행

   • 프롬프트를 위치 인자로 전달해 비대화형 실행
   • 코드 리뷰, 테스트 생성, 문서 갱신 등 자동 수행
   • stdout으로 결과 출력
4. 4
   결과 처리

   • exit 0=성공, 1=실패
   • stdout을 파싱하여 PR 코멘트 또는 Slack 알림
   • if: failure()로 분기 제어