Kiro CLI（旧 Amazon Q Developer CLI）のアップデート情報を、初心者にも分かりやすく解説するプロジェクトです。 より正確な情報発信を心がけて今後も更新していきます。
旧称: 猫でもわかるAmazon Q Developer CLI 解体新書 旧 Amazon Q Developer CLI（2025年11月17日 開発終了）のドキュメントは docs/ にアーカイブとして保存しています（本ページ後半にも旧情報のアーカイブ節があります）。
- 📖 猫でもわかるKiro CLI アップデート情報 ← ⭐まずここから！
- 💻 公式インストール手順 - macOS / Windows 11 / Linux 別のインストール方法
- 📚 機能詳細ガイド - 54機能をカテゴリ別に解説
- 🔍 リファレンス - Settings / Slashコマンド / CLIコマンド / Built-in Tools の辞書
- 📋 変更履歴 - 全バージョンの詳細な変更内容
Kiro IDE・Kiro CLI・Kiro Web・Kiro Crew は別製品です。同名の機能でも仕様が異なることがあります。
| 対象 | サイト |
|---|---|
| Kiro CLI | 本サイト |
| Kiro IDE | 猫でもわかるKiro IDE アップデート情報 |
| Kiro Web | 猫でもわかるKiro Web アップデート情報 |
| Kiro Crew | 猫でもわかるKiro Crew アップデート情報 |
| Kiro 全体（まとめ） | 猫でもわかるKiro 入門 ― IDE・CLI・Web・Mobile・Crew まとめ |
Kiro IDE と Kiro CLI の比較は本サイトの Kiro IDE 版との比較 にまとめています。
2025年11月17日のv1.19.7リリースを最後に、Amazon Q CLIはオープンソースプロジェクトとしての積極的な開発を終了しました。今後は重要なセキュリティ修正のみが提供される予定です。
Amazon Q Developer CLIは、Kiro CLI として生まれ変わりました（v1.19.7リリース（2025年11月17日）の翌日に公式発表）：
- 新しい名称: Kiro CLI
- 開発形態: クローズドソース製品
- ライセンス: AWS Intellectual Property License
- 継続性: 既存のワークフローと購読はそのまま継続
- 最新機能: Kiro CLIで提供
- Issue管理: GitHub - kirodotdev/Kiro で継続
- Introducing Kiro CLI
- Kiro CLIの公式発表記事
- 基本概念と主要機能の紹介
- Amazon Q Developer CLIからの進化について
- Kiroweeeeeeek in Japan Day 6: Amazon Q Developer CLI to Kiro CLI
- Amazon Q Developer CLIからKiro CLIへの移行ガイド
- 日本での導入事例とベストプラクティス
- 移行時の注意点と推奨事項
各バージョンの変更内容は、変更履歴とアップデート情報にまとめています（本ページにはバージョン別の詳細を載せていません）。
kiro-docs/
├── 00_information/ # 基本情報・公式サイト情報
├── 01_features/ # 機能詳細ガイド（v2.37.1対応）
├── 02_update/ # アップデート情報
├── 03_deployment/ # デプロイメント・環境構築
├── 04_reference/ # リファレンス（Settings/Slash/CLI/Tools）
├── 07_aidlc/ # AI-DLC（Kiro CLI で実践する選択肢）
├── 08_cdk-skills/ # cdk-skills（CDK 開発支援 Skills 集）
└── 09_v3/ # Kiro CLI v3（Early Access）— 仕様駆動開発・IDE比較 🆕
主要ドキュメント:
このサイトは、Kiro CLI のアップデート情報を追い続けるとともに、Amazon Q CLI の最後の包括的なドキュメントとして以下の価値を提供し続けます：
- 最新情報の解説: Kiro CLI の各バージョンの変更内容を初心者にも分かりやすく解説
- 歴史的記録: オープンソース時代のQ CLIの全機能と設定の詳細
- 移行支援: Kiro CLIへの移行時の参考資料
- 学習資源: AI駆動開発ツールの理解を深める教材
- 技術資産: 127文書に及ぶ体系的な知識ベース（旧Q CLIアーカイブ）
Kiro CLIの最新情報は 公式サイト をご確認ください。
⚠️ ここから下は旧 Amazon Q Developer CLI（2025年11月17日 開発終了）時代のコンテンツのアーカイブです。 現行の Kiro CLI の情報は kiro-docs/ をご覧ください。
Amazon Q Developer CLIは、開発効率を劇的に向上させる強力なツールです。しかし、その真の力はまだ十分に知られていないと感じています。
このサイトでは、Q CLI自身を使ってQ CLIのソースコードを解析することで、Q CLIの可能性を示す実例となることを目指しました。公式ドキュメントには載っていない深い知見を発見し、体系的にまとめることを最終目的にしています。
目指したのは、初心者でも理解できる分かりやすさと、実務で即使える実践的な内容の両立です。
AWS技術者として、Q CLIの可能性をもっと多くの人に知ってもらい、実際に使ってもらいたい。その思いが、このサイトの原動力です。
- GitHub: https://github.com/aws/amazon-q-developer-cli
- 最終バージョン: v1.19.7（2025-11-17。以後は重要なセキュリティ修正のみ）
このサイトには127文書の体系的なドキュメントがあります：
docs/
├── 01_for-users/ # ユーザーガイド（84文書）
│ ├── 入門・機能・設定・ベストプラクティス
│ ├── デプロイ・トラブルシューティング
│ └── リファレンス・ガイド・セキュリティ・仕様
├── 02_for-developers/ # 開発者ガイド（11文書）
│ ├── コントリビューション（4文書）
│ └── アーキテクチャ（4文書）
├── 03_for-community/ # コミュニティ（15文書）
│ ├── アップデート情報（5文書）
│ ├── コミュニティ（3文書）
│ └── 分析レポート（3文書）
├── 04_issues/ # 課題管理（1文書）
└── 05_meta/ # メタドキュメント（15文書）
└── 品質保証・コントリビューション
📖 → 詳細なファイル一覧を見る（docs/README.md） - 全127文書の完全なツリー構造
このプロジェクトは、3つの柱で品質を保証しています：
- 自動化ツール - 1,849項目を機械的にチェック
- 手動チェック - 人間が内容を確認
- 作業原則 - 品質を保つルール
日々、品質向上のため人間による目視レビューを実施しています。
品質保証の詳細は Meta（メタドキュメント） をご覧ください。
graph LR
A[📖 ドキュメント確認] --> B[💻 インストール]
B --> C[🚀 クイックスタート]
C --> D[👣 最初の一歩]
style A fill:#fff3cd
style B fill:#d1ecf1
style C fill:#d4edda
style D fill:#f8d7da
- 📖 ドキュメントサイト全体を確認
- 💻 インストール - Q CLIのインストール方法
- 🚀 クイックスタート - 5分で始めるQ CLI
- 👣 最初の一歩 - 基本的な使い方
- 🧠 記憶管理ガイド ← ⭐必読！ - Q CLIの記憶の仕組みを理解
- 基本設定を確認: Getting Started
- 環境変数を設定: 環境変数ガイド
- Agent設定を作成: Agent設定ガイド
- 設定を確認: 設定優先順位ガイド
Q CLIを効果的に使うための最重要ガイド
Q CLIの応答品質はコンテキスト管理で決まります。以下のガイドで体系的に学習できます：
📚 コンテキスト管理完全ガイド ← ⭐必読！
全8章構成の包括的ガイド：
- 本質編 - コンテキストとは何か
- 仕組み編 - 内部動作の理解
- 効果編 - 何ができるか
- ベストプラクティス編 - 設計原則と実装パターン
- 実践ガイド編 - プロジェクト別実装例
- トラブルシューティング編 - 問題解決
- 上級編 - 最適化とチーム開発
- リファレンス編 - 技術仕様とFAQ
💡 学習の進め方
- 初心者: 第1章→第3章→第5章（基本を理解して実践）
- 中級者: 第4章→第5章→第6章（ベストプラクティスを習得）
- 上級者: 第7章→第8章（最適化とチーム開発）
問題が発生した場合：
- コンテキスト管理トラブルシューティングを確認
- 一般的なトラブルシューティングを確認
- 設定優先順位ガイドで優先順位を理解
- GitHub ISSUEで既知の問題を検索
Amazon Q Developer CLI（Q CLI）は、AWSが提供するAI駆動の開発者支援ツールです。
💡 ワンポイント: AWS CLIとの違い
- AWS CLI: AWSサービスを操作するコマンドラインツール（
aws s3 lsなど）- Q CLI: AIが自然言語を理解し、コード生成やファイル操作を支援（
q chat "S3バケットを作成して"など）
コマンドラインから自然言語で質問し、コード生成、ファイル操作、AWS操作などを実行できます。
💡 ワンポイント: 主要な用語
- Agent（エージェント）: Q CLIの動作をカスタマイズする設定ファイル。プロジェクトごとに異なる設定が可能
- MCP（Model Context Protocol）: 外部ツールと連携するためのプロトコル。MCPサーバーを追加することで機能を拡張できる
旧プロジェクトは、Amazon Q Developer CLI (Q CLI) の包括的な調査・分析を目的としていました。設定ファイルの仕様、バージョン履歴、ロードマップ、ソースコード構造など、Q CLIを効果的に活用するための詳細なドキュメントを提供します。
旧 Q CLI 向けに127文書の体系的なドキュメントがあります。
ドキュメントサイト では以下が確認できます：
- 📊 全127文書の一覧（カテゴリ別、対象ユーザー別）
- 🎯 目的別ガイド（やりたいことから適切なドキュメントを発見）
- 📈 統計情報とナビゲーション
- 設定項目: 45項目（テレメトリ、チャット、Knowledge、MCP等）
- 環境変数: 28項目（Q CLI固有19項目 + その他9項目）
- 優先順位: 5段階（コマンドライン引数 → 環境変数 → Agent設定 → グローバル設定 → デフォルト値）
- 環境変数展開:
${env:VAR_NAME}構文をサポート（MCP設定、Agent設定）
- 期間: 2025-07-31 ～ 2025-11-17（約3.5ヶ月）
- 最新バージョン: v1.19.7 (2025-11-17)
- 主要機能:
- Agent機能の成熟化（スキーマ、管理コマンド、編集機能、重複検出）
- MCP進化（rmcp移行、リモート対応、OAuth統合）
- Knowledge機能ベータ改善（BM25サポート、PDF対応）
- セキュリティ強化（execute_bash権限厳格化、fs_read制限、危険パターンブロック）
- コード品質向上（リファクタリング、モジュール分割、環境変数一元化）
Q CLIのセキュリティとプライバシーについて理解することは重要です：
- セキュリティアーキテクチャ設計思想 - なぜユーザーアカウント配下にインストールされるのか
- セキュリティ概要 - セキュリティの基本原則とトピック
- データプライバシー - データの取り扱いとプライバシー保護
- テレメトリー設定 - 使用状況データの収集と無効化方法
- データプライバシー保護: コンテンツ（質問、コード、応答）がサービス改善やモデル学習に使用されない
- Freeプランとの違い: Freeプランではコンテンツがサービス改善に使用される可能性がある
- エンタープライズ適合性: 機密情報を扱う組織に最適
- 詳細: 料金プラン比較
Windows未対応（v2.0.0で対応済み） - Kiro CLI v2.0.0でWindows 11ネイティブ対応- リモートMCP + OAuth未完成 - エンタープライズツールとの統合困難
- ADC未対応 - エンタープライズネットワーク環境での制限
- 管理機能の不足 - 使用状況の可視化、管理者ダッシュボード
詳細: エンタープライズ展開ガイド、セキュリティチェックリスト
- 機能調査: Q CLIの設定、環境変数、Agent機能の詳細分析
- アップデート追跡: バージョン履歴と新機能の評価
- ロードマップ分析: 開発計画とエンタープライズ採用への課題
- ベストプラクティス: 実践的な設定例とトラブルシューティング
- 公式リポジトリ: ソースコード、ドキュメント、スキーマ
- GitHub API: リリース情報、ISSUE、PR、ロードマップ
- AWS Blog: 最新情報、アップデート、ベストプラクティス
- ソースコード分析: Rust実装の詳細調査
- Amazon Q Developer CLI: AI支援による調査・分析・ドキュメント作成
- ripgrep (rg): 高速検索で設定項目を抽出
- GitHub API: リリース情報とISSUEの取得
- Mermaid: 図解の作成
| 日付 | 内容 |
|---|---|
| 2026-11-03 | v2.34.1、v2.34.2、v2.35.0、v2.35.1、v2.35.2、v2.36.0、v2.37.0、v2.37.1対応（前回までの反映で漏れていた v2.19.2、v2.20.2 を履歴に追加） |
| 2026-10-25 | v2.33.1、v2.34.0対応（v2.33.0 の出典を公式 Changelog に更新） |
| 2026-10-21 | v2.28.0、v2.29.0、v2.29.1、v2.30.0、v2.31.0、v2.31.1、v2.32.0、v2.33.0対応（v2.27.1 の出典を公式 Changelog に更新） |
| 2026-10-04 | v2.22.0、v2.22.1、v2.23.0、v2.23.1、v2.24.0、v2.24.1、v2.25.0、v2.26.0、v2.26.1、v2.27.0、v2.27.1対応 |
| 2026-09-13 | v2.21.0、v2.21.1、v2.21.2、v2.21.3、v2.21.4対応 |
| 2026-08-29 | v2.20.0、v2.20.1対応 |
| 2026-08-22 | v2.19.0、v2.19.1対応 |
| 2026-08-16 | v2.16.1、v2.16.2、v2.17.0、v2.18.0、v2.18.1対応 |
| 2026-08-01 | v2.15.0、v2.15.1、v2.15.2、v2.16.0対応 |
| 2026-07-25 | v2.13.1、v2.14.0、v2.14.1、v2.14.2対応 |
| 2026-07-20 | v2.13.0、v2.12.3対応 |
| 2026-07-15 | v2.12.2対応 |
| 2026-07-12 | v2.11.0、v2.12.0、v2.12.1対応 |
| 2026-06-28 | v2.10.0、v2.9.0対応 |
| 2026-06-21 | v2.7.1、v2.8.0、v2.8.1・v3（Early Access）対応 |
| 2026-06-21 | v2.7.0、v2.6.1対応 |
| 2026-06-07 | v2.6.0、v2.5.1、v2.5.0対応 |
| 2026-05-28 | v2.4.2対応 |
| 2026-05-23 | v2.4.0、v2.4.1対応 |
| 2026-05-13 | v2.3.0対応 |
| 2026-05-10 | v2.2.1、v2.2.2対応 |
| 2026-05-03 | v2.2.0対応 |
| 2025-12-14 | v1.19.7対応 |
| 2025-11-15 | v1.19.6対応 |
| 2025-11-13 | v1.19.5対応 |
| 2025-11-13 | v1.19.4対応 |
| 2025-11-01 | v1.19.3対応 |
| 2025-10-29 | v1.19.0対応：JAWS-UG AI/ML #32 発表（一般公開開始） |
- 調査担当: Amazon Q Developer CLI
- レビュー: katoh
このプロジェクトは MIT License の下で公開されています。
重要な免責事項
このプロジェクトは 非公式 のドキュメントです。Amazon Web Services, Inc.またはその関連会社によって作成、承認、または保証されたものではありません。
- 商標について: "Amazon Q Developer"、"AWS"、"Amazon Web Services" は Amazon.com, Inc. またはその関連会社の商標です
- 情報の正確性: 本ドキュメントの情報は調査時点のものであり、正確性を保証するものではありません
- 責任の制限: 本ドキュメントの使用により生じた損害について、作成者は一切の責任を負いません
- 公式情報: 最新かつ正確な情報は Amazon Q Developer 公式サイト をご確認ください
- 調査結果はGitHubで管理
- 定期的な更新（週次/月次）
- 構造化されたドキュメント形式での記録
- 変更履歴の適切な管理
このプロジェクトは継続的な調査と分析を通じて、Q CLIの効果的な活用を支援することを目指しています。