CLI로 앱 만들기

목표

Kiro CLI를 사용하여 터미널에서 직접 애플리케이션을 생성하고, AI 기반 코드 생성의 빠른 프로토타이핑 능력을 체험합니다.

사전 준비

• Kiro CLI 설치 및 로그인 완료 (kiro-cli login)
• 터미널(Terminal) 접근 가능
• 작업할 빈 폴더 준비

해볼 것

1단계: 프롬프트로 앱 생성

터미널에서 다음 명령을 입력합니다:

kiro-cli chat

Kiro CLI 세션이 시작되면 아래 프롬프트를 입력하세요:

create simple html sudoku web application and save into file

2단계: 실행 승인

Kiro가 파일 생성 명령을 제안하면 y를 눌러 승인합니다.

⚠️ t(trust)를 누르면 이후 모든 명령이 확인 없이 실행됩니다. 삭제(rm) 등 위험한 명령에는 사용하지 마세요.

3단계: 결과 확인

1. 탐색기에서 생성된 HTML 파일 확인
2. 브라우저에서 파일을 열어 동작 확인
3. Kiro가 출력한 앱 설명 읽기

4단계: README 문서화

이 프로젝트에 대한 README.md 파일을 생성해주세요. 프로젝트 설명, 사용법, 기술 스택을 포함해주세요.

5단계: UI 개선 (고급 프롬프팅)

현재 웹 앱의 UI를 개선해주세요:
- 모던한 CSS 디자인 (그라디언트 배경, 카드 레이아웃)
- 반응형 디자인 적용
- 사용자 경험 향상 (애니메이션, 호버 효과)
- 접근성 개선 (aria-label, 키보드 내비게이션)

기대 결과

• 하나의 프롬프트로 동작하는 웹 애플리케이션이 생성됨
• 고급 프롬프팅으로 한 단계 더 세련된 앱으로 개선됨
• README 문서가 자동 생성됨

0 / 5항목을 클릭해 체크 · 진행 상태는 이 브라우저에 저장됩니다

• `kiro-cli chat` 세션 진입 성공필수
• 프롬프트로 HTML 파일 생성필수
• 브라우저에서 앱 동작 확인필수
• README 문서 생성선택
• UI 개선 프롬프트로 디자인 업그레이드선택

🚨 문제 해결

• kiro-cli 명령어를 찾을 수 없음: PATH에 Kiro CLI가 포함되었는지 확인. which kiro-cli 실행.
• 인증 오류: kiro-cli login으로 재인증.
• 파일이 생성되지 않음: 작업 디렉토리의 쓰기 권한 확인. 홈 디렉토리 대신 프로젝트 폴더에서 실행.

관련 실습

Scene A1 · Vibe 즉흥 요청에서 같은 대화형 앱 생성 흐름을 To-Do 프로젝트로 확장해보세요.

CLI 세션 슬래시 명령

Kiro CLI는 V3 하네스가 기본입니다(과거의 Classic/V2 세션은 deprecated 되었으며, 시작 시 전환 안내가 표시됩니다). kiro-cli chat V3 세션 안에서 다음 명령으로 작업과 설정을 관리합니다.

작업·계획·에이전트

• /spec — Spec 목록 확인과 Spec 모드 전환. 새 Spec은 /spec new, 작업 실행은 /spec run을 사용합니다.
• /plan — 파일을 바꾸지 않고 구현 계획을 검토합니다.
• /usage — 현재 계정의 사용량 정보를 확인합니다.
• /editor — 기본 편집기로 긴 프롬프트를 작성해 전송합니다.
• /agent — 에이전트 목록·생성·편집·전환을 관리합니다.

실습에서는 제안된 명령을 건별로 검토·승인하세요. /tools trust-all처럼 광범위한 신뢰 설정은 기본값으로 권장하지 않습니다.

입력·설정·세션

• /model — 모델을 전환하고 선택한 모델의 thinking·effort(추론 강도)를 한 곳에서 설정합니다. 기본 에이전트는 Auto이며, Claude(Sonnet·Opus 계열)·OpenAI GPT 계열 등 최신 모델을 직접 고를 수 있습니다.
• /voice — 음성으로 프롬프트를 입력합니다. on-device 음성 인식으로 오디오가 로컬에서 처리됩니다. Voice 모드 참조.
• /tangent — 현재 대화에서 분기해 별도 흐름으로 잠시 벗어난 뒤, 다시 원래 대화로 복귀합니다. 본 작업 맥락을 흐트러뜨리지 않고 짧은 곁가지 질문을 처리할 때 유용합니다.
• /workflow — 재사용 멀티스텝 플랜을 실행·관리합니다(먼저 /settings → Features에서 Workflows 활성화). 자세한 내용은 Workflows 참조.
• /powers — Powers를 설치·제거합니다(/powers install <name|path>, /powers uninstall <name>). 채팅 없이 kiro-cli powers install <name|path>로도 가능합니다.
• /config — 현재 세션에 적용된 agents·MCP·Powers·Steering·Skills·Hooks를 한 화면에서 확인합니다.
• /sessions — 로컬·클라우드 세션을 검색·필터·정렬·재개·정리합니다.
• /fullscreen — 현재 대화를 전용 전체화면으로 전환합니다(다시 입력하면 인라인 복귀). 전체화면 모드 참조.

슬래시 명령 구성은 릴리스에 따라 바뀝니다. 최신 목록은 세션에서 /help 또는 kiro.dev/changelog/cli에서 확인하세요.