Kiro CLI チートシート - 即戦力コマンド集
ターミナルで動くAI開発ツール「Kiro CLI」の実務で使える全コマンドを1枚にまとめました。コピペしてすぐ使えます。
基本操作
インストール・起動
# macOS
brew install kiro
# Linux (Ubuntu/Debian)
curl -fsSL https://kiro.dev/install.sh | sh
# 初回起動
kiro-cli
# エージェント指定で起動
kiro-cli --agent my-agent
# すべてのツールを信頼して起動
kiro-cli --trust-all-tools
認証
# ログイン
kiro-cli login
# ログアウト
kiro-cli logout
チャット中のスラッシュコマンド
基本
/help # ヘルプ表示
/quit # 終了(Ctrl+D)
/clear # 会話履歴クリア
/paste # クリップボードから貼り付け
/editor # エディタで入力(Ctrl+J)
/usage # 使用状況表示
セッション管理
/chat resume # セッション再開(対話的)
/chat save PATH # セッション保存
/chat load PATH # セッション読み込み
/chat list-sessions # セッション一覧
コンテキスト管理
/context show # 現在のコンテキスト表示
/context add PATH # ファイル追加
/context remove PATH # ファイル削除
/context clear # セッションコンテキストクリア
モデル切り替え
/model # 現在のモデル表示
/model set-current-as-default # デフォルトに設定
エージェント
/agent swap # エージェント切り替え
/agent edit NAME # エージェント編集
/agent generate # 新規エージェント作成
ツール権限
/tools # ツール権限表示
/tools trust TOOL # ツール信頼
/tools untrust TOOL # 信頼解除
/tools trust-all # すべて信頼
/tools reset # デフォルトにリセット
プロンプト
/prompts list # プロンプト一覧
/prompts create --name NAME # プロンプト作成
/prompts edit NAME # プロンプト編集
/prompts details NAME # プロンプト詳細
# プロンプトの使用
@プロンプト名 # ローカル/グローバル
@server-name/prompt-name # MCP
Code Intelligence
/code overview [PATH] # コードベース概要
/code summary # ドキュメント生成
/code init # LSP初期化
MCP
/mcp list # MCPサーバー一覧
/mcp status # ステータス確認
/mcp reload # 再読み込み
実験的機能
/tangent # Tangent Mode(Ctrl+T)
/compact # 会話を圧縮
/reply # 前の回答を引用して返信
CLIコマンド
エージェント管理
# 一覧表示
kiro-cli agent list
# 作成
kiro-cli agent create --name my-agent
# 編集
kiro-cli agent edit my-agent
# 検証
kiro-cli agent validate my-agent
# 削除
kiro-cli agent delete my-agent
# デフォルト設定
kiro-cli agent set-default my-agent
チャット
# セッション再開
kiro-cli chat --resume
kiro-cli chat --resume-picker
# 非対話モード
kiro-cli chat --no-interactive "プロンプト"
# MCP必須モード
kiro-cli chat --require-mcp-startup
自然言語→コマンド変換
# 1つ生成
kiro-cli translate "ファイル一覧表示"
# 3つ生成
kiro-cli translate -n 3 "テキスト検索"
診断
kiro-cli doctor # 基本診断
kiro-cli doctor --all # 全項目診断
kiro-cli doctor --strict # 厳格モード
アップデート
kiro-cli update # 対話的更新
kiro-cli update --non-interactive # 自動更新
テーマ
kiro-cli theme dark # ダークテーマ
kiro-cli theme light # ライトテーマ
kiro-cli theme system # システム設定
kiro-cli theme --list # テーマ一覧
インライン補完
kiro-cli inline enable # 有効化
kiro-cli inline disable # 無効化
kiro-cli inline status # ステータス
設定管理
# 一覧表示
kiro-cli settings list
kiro-cli settings list --all
kiro-cli settings list --format json
# 取得
kiro-cli settings telemetry.enabled
# 設定
kiro-cli settings telemetry.enabled true
# 削除
kiro-cli settings --delete chat.defaultModel
# エディタで開く
kiro-cli settings open
MCP管理
kiro-cli mcp list # 一覧
kiro-cli mcp add server-name # 追加
kiro-cli mcp remove server-name # 削除
kiro-cli mcp status # ステータス
設定ファイル(cli.json)
パス
グローバル: ~/.kiro/settings/cli.json
プロジェクト: .kiro/settings/cli.json
主要設定
{
"chat.defaultModel": "claude-sonnet-4",
"chat.defaultAgent": "my-agent",
"chat.diffTool": "delta",
"chat.enableNotifications": true,
"telemetry.enabled": true,
"knowledge.defaultIncludePatterns": ["*.py", "*.js"],
"knowledge.defaultExcludePatterns": ["*.log", "node_modules"],
"chat.tangentModeKey": "t",
"chat.autocompletionKey": "Tab"
}
カスタムエージェント設定
基本構造
{
"name": "my-agent",
"description": "説明",
"instructions": "詳細な指示",
"resources": [
"file://./src",
"file://.kiro/steering/*.md"
],
"tools": ["read", "write", "shell"],
"toolsSettings": {
"fs_read": {
"allowedPaths": ["src/**"]
}
},
"model": "claude-sonnet-4",
"availableAgents": ["subagent1", "subagent2"],
"trustedAgents": ["formatter"],
"keyboardShortcut": "ctrl+a"
}
配置場所
グローバル: ~/.kiro/agents/
プロジェクト: .kiro/agents/
MCPサーバー設定
mcp.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://..."
}
}
}
}
配置場所
グローバル: ~/.kiro/settings/mcp.json
プロジェクト: .kiro/settings/mcp.json
Autonomous Agent
app.kiro.dev/agentでの操作
1. リポジトリ選択
2. タスクを記述
例: "auth.tsのlogin関数にエラーハンドリングを追加"
3. /kiro all でPRの全コメントに対応
4. /kiro fix で特定コメントに対応
GitHubイシューから
方法1: イシューに kiro ラベルを追加
方法2: イシューコメントで /kiro とメンション
Dockerfile設定
FROM node:18
WORKDIR /workspace
COPY package*.json ./
RUN npm install
ENV NODE_ENV=production
ステアリングファイル
配置場所
.kiro/steering/code-standards.md
.kiro/steering/architecture.md
例
# コーディング規約
## TypeScript
- strictモードを使用
- const assertionsを使用
- 非同期関数には必ずtry-catch
## テスト
- 最低80%のカバレッジ
- *.test.ts 命名規則
フック(Hooks)
配置場所
.kiro/hooks/preToolUse.sh
.kiro/hooks/postToolUse.sh
.kiro/hooks/agentSpawn.sh
例: preToolUse.sh
#!/bin/bash
INPUT=$(cat)
TOOL=$(echo "$INPUT" | jq -r '.tool')
if [ "$TOOL" = "fs_write" ]; then
FILE=$(echo "$INPUT" | jq -r '.arguments.path')
# Pythonファイルならlintチェック
if [[ "$FILE" == *.py ]]; then
pylint "$FILE" 2>&1 || {
echo "Lint errors detected" >&2
exit 2 # ブロック
}
fi
fi
exit 0 # 許可
Exit Codes
-
0: 成功(続行) -
2: ツール実行をブロック(preToolUseのみ) - その他: フック失敗(警告)
モデル選択とコスト
| モデル | クレジット倍率 | 用途 |
|---|---|---|
| Auto | 1.0x | 推奨(コスト効率最高) |
| Haiku 4.5 | 0.4x | 高速・安価 |
| Sonnet 4.5 | 1.3x | バランス型 |
| Sonnet 4.0 | 1.3x | 予測可能 |
| Opus 4.5 | 2.2x | 最高性能 |
| Opus 4.6 | 2.2x | 実験的・最先端 |
トラブルシューティング
よくある問題
# 認証失敗
kiro-cli login
# オートコンプリート不動作
kiro-cli doctor
# ログ確認
tail -f $TMPDIR/kiro-log/*.log
# デバッグログ有効化
export KIRO_LOG_LEVEL=debug
kiro-cli chat
プロキシ設定
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
キーボードショートカット
| キー | 機能 |
|---|---|
Ctrl+D |
終了 |
Ctrl+J |
エディタモード |
Ctrl+T |
Tangent Mode |
Tab |
オートコンプリート |
クイックリファレンス
5秒で開始
kiro-cli # 起動
/context add src/ # コンテキスト追加
@architecture # プロンプト使用
コードレビュー
/prompts create --name review
@review
[コードを貼り付け]
自動PR作成
app.kiro.dev/agent で:
"UserServiceクラスのユニットテストを作成"
チーム設定共有
project/
├── .kiro/
│ ├── agents/team-default.json
│ ├── steering/code-standards.md
│ ├── hooks/preToolUse.sh
│ └── settings/mcp.json
まとめ
このチートシートをブックマークして、日常開発で活用してください。
- 基本:
kiro-cliで起動 - コンテキスト:
/context addでファイル追加 - プロンプト:
@名前で再利用 - エージェント: チーム固有のワークフローを自動化
- Autonomous Agent: GitHubイシュー→PR完全自動化
Happy Coding with Kiro CLI!
