# Install from crates.io (recommended)
cargo install miyabi-cli

# Or download the binary (macOS ARM64)
curl -L https://github.com/ShunsukeHayashi/Miyabi/releases/download/v0.1.1/miyabi-macos-arm64 -o miyabi
chmod +x miyabi
sudo mv miyabi /usr/local/bin/

# Real-time status monitoring with Watch Mode
miyabi status --watch  # Auto-refresh every 3 seconds

# GitHub integration - see open Issues & PRs at a glance
miyabi status  # Shows:
# 📋 20 open issue(s)
# 🔀 3 open pull request(s)

# Agent execution with Issue numbers
miyabi agent run coordinator --issue 123

# Parallel execution of multiple Issues
miyabi parallel --issues 123,124,125 --concurrency 2

# インストール（crates.ioから）
cargo install miyabi-cli

# 新規プロジェクト作成（インタラクティブモード推奨）
miyabi init my-project --interactive

# または従来の方法
miyabi init my-project

# 簡単なコマンドでIssue処理（新機能！⭐）
miyabi work-on 1

# または従来の方法
miyabi agent run coordinator --issue 1

v0.1.1の新機能 ✨:

• 🚀 miyabi work-on - シンプルな新コマンド
• 🎯 miyabi init --interactive - 対話形式のセットアップ
• 📚 8つの新ドキュメント（39KB）
• 🎨 プロアクティブなエラーメッセージ

npx miyabi

• 🚀 初心者向け: Getting Started Guide - 250+行の完全ガイド
• 🔧 困ったときは: トラブルシューティングガイド - 280+行の解決策
• 🤖 Agent詳細: Agent Overview - 全21 Agents

Miyabiは、GitHub as OSアーキテクチャに基づいた完全自律型AI開発オペレーションプラットフォームです。

Issue作成からコード実装、PR作成、デプロイまでを完全自動化します。

graph LR
    A[Issue作成] --> B[IssueAgent]
    B --> C[CoordinatorAgent]
    C --> D[CodeGenAgent]
    D --> E[TestAgent]
    E --> F[ReviewAgent]
    F --> G[PRAgent]
    G --> H[DeploymentAgent]
    H --> I[✅ 完了]

    style A fill:#FF6B6B
    style I fill:#51CF66
    style C fill:#FFD93D
    style D fill:#6C5CE7
    style F fill:#00D2FF

Miyabiは Claude AI を使用して自動的にコードを生成します。以下の点にご注意ください：

• ✅ 必ずレビュー: 生成されたコードをマージ前に必ず確認してください
• ✅ 徹底的なテスト: 本番環境以外で十分にテストしてください
• ✅ エラーの可能性: AIが生成するコードには予期しないエラーが含まれる可能性があります
• ✅ 本番デプロイの責任: 本番環境へのデプロイはユーザーの責任です

Miyabiプロジェクトは、AI生成コードに起因する問題について一切の責任を負いません。 生成されたコードの品質、セキュリティ、動作については、ユーザー自身で確認・検証してください。

詳細は LICENSE および NOTICE をご覧ください。

• 📋 Issues - タスク管理
• ⚙️ Actions - CI/CDパイプライン
• 📊 Projects V2 - データ永続化
• 🔔 Webhooks - イベントバス
• 📄 Pages - ダッシュボード
• 📦 Packages - パッケージ配布
• 💬 Discussions - メッセージキュー
• 🔖 Releases - バージョン管理
• 🌍 Environments - デプロイ環境
• 🔒 Security - 脆弱性スキャン
• 🏷️ Labels - 53ラベル体系
• 🎯 Milestones - マイルストーン管理
• 🔀 Pull Requests - コードレビュー
• 📚 Wiki - ドキュメント
• 🔌 API - GraphQL/REST API

# crates.ioから最新版をインストール
cargo install miyabi-cli

# バイナリをダウンロード (macOS ARM64のみ)
curl -L https://github.com/ShunsukeHayashi/Miyabi/releases/download/v0.1.1/miyabi-macos-arm64 -o miyabi
chmod +x miyabi
sudo mv miyabi /usr/local/bin/

推奨理由:

• ✅ シングルバイナリ（8.4MB）
• ✅ 高速実行（Rustネイティブ）
• ✅ 依存関係なし（Node.js不要）
• ✅ 735+テスト、品質保証済み

npx miyabi

npm install -g miyabi
miyabi

npm install --save-dev miyabi
npx miyabi

注意: Claude Code Plugin統合は現在開発中です。利用可能になり次第、こちらで告知します。

Miyabiは将来的にClaude Codeの公式Pluginとして利用できるよう計画しています。

計画中の機能:

• /miyabi-init - 新規プロジェクト作成
• /miyabi-status - ステータス確認
• /miyabi-agent - Agent実行
• /miyabi-auto - 自動モード
• Event Hooks (pre-commit, pre-pr等)

以下の例は Rust Edition (miyabi) を使用しています。TypeScript版 (npx miyabi) をご利用の場合は、コマンドを読み替えてください。

# インタラクティブモード（推奨）
$ miyabi init my-awesome-app --interactive

? プロジェクトタイプは？ 🌐 Web Application
? GitHubリポジトリを作成しますか？ Yes
? プライベートリポジトリにしますか？ No

🚀 セットアップ開始...
✓ GitHubリポジトリ作成
✓ ラベル設定（53個）
✓ ワークフロー配置（10+個）
✓ Projects V2設定
✓ ローカルにクローン

🎉 完了！

📚 次のステップ:
  1. cd my-awesome-app
  2. miyabi work-on 1  # 最初のIssueを処理

従来の方法:

miyabi init my-awesome-app

$ cd my-existing-project
$ miyabi install

🔍 プロジェクト解析中...
✓ 言語検出: Rust
✓ ビルドツール: Cargo
✓ Git検出: origin → github.com/user/repo

📋 インストール予定:
  - 53個のラベル
  - GitHub Workflows
  - Projects V2連携

? 続行しますか？ Yes

✓ インストール完了！

# 通常モード
$ miyabi status

📊 Project Status

Miyabi Installation:
  ✅ Miyabi is installed
    ✓ .claude/agents
    ✓ .github/workflows
    ✓ logs
    ✓ reports

Environment:
  ✅ GITHUB_TOKEN is set
  ✅ DEVICE_IDENTIFIER: MacBook-Pro

Git Repository:
  ✅ Git repository detected
    Branch: main
    Remote: https://github.com/user/repo.git
    ✓ Working directory clean

Worktrees:
  No active worktrees

Recent Activity:
  3 log file(s) in logs/
  0 report file(s) in reports/

GitHub Stats:
  📋 20 open issue(s)
  🔀 3 open pull request(s)

# Watch Mode（3秒ごとに自動更新）
$ miyabi status --watch

🔄 Watch Mode Active
  (Auto-refresh every 3 seconds. Press Ctrl+C to exit)

📊 Project Status
... (上記と同じ出力が自動更新されます)

use miyabi_agents::{CoordinatorAgent, BaseAgent};
use miyabi_types::Issue;

// DAGベースの依存関係解析と並列実行制御
let coordinator = CoordinatorAgent::new(config);
let result = coordinator.execute(&task).await?;

// 並列実行可能なタスクを自動検出してWorktreeで実行
// 複数IssueをCLIで並列処理
// $ miyabi parallel --issues 123,124,125 --concurrency 3

機能:

• ✅ DAG（有向非巡回グラフ）による依存関係解析
• ✅ 並列実行可能タスクの自動検出
• ✅ Critical Path最適化（72%効率化）
• ✅ リアルタイム進捗トラッキング

use miyabi_agents::CodeGenAgent;
use miyabi_types::{Task, AgentResult};

// Claude Sonnet 4による高品質Rustコード生成
let codegen = CodeGenAgent::new(config);
let result = codegen.execute(&task).await?;

// 自動生成されるもの:
// - Rust structs/enums/traits実装
// - #[cfg(test)] mod tests { ... } 付きテスト
// - /// Rustdocコメント

機能:

• ✅ Claude Sonnet 4による実装
• ✅ Rust 2021 Edition完全対応
• ✅ テスト自動生成（80%+カバレッジ）
• ✅ Conventional Commits準拠

use miyabi_agents::ReviewAgent;

// 静的解析 + セキュリティスキャン
let reviewer = ReviewAgent::new(config);
let review = reviewer.execute(&task).await?;

// 品質スコアリング（80点以上でマージ可能）
// - cargo clippy --all-targets --all-features -- -D warnings
// - cargo test --all
// - cargo audit

機能:

• ✅ 静的解析（Clippy, Rustfmt）
• ✅ セキュリティスキャン（cargo audit, Gitleaks）
• ✅ 品質スコアリング（0-100点）
• ✅ 自動修正提案

Miyabiは明確な組織理論の5原則に基づいた自律型システム設計:

従来のシーケンシャル実行:
A → B → C → D → E → F   (36時間)

Miyabiの並列実行:
     ┌─ B ─┐
A ──┤      ├─ F         (26時間)
     └─ E ─┘
     ↓ 72%効率化 (-10時間)

脆弱性を発見した場合: SECURITY.md

Miyabi Community Discord で開発者と交流しましょう！

詳細計画: Discord Community Plan • Status: 準備中（Phase 1）

以下は Rust Edition (miyabi) のコマンド例です。TypeScript版は npx miyabi に読み替えてください。

miyabi

? 何をしますか？
  🌸 初めての方（セットアップガイド）
  🆕 新しいプロジェクトを作成
  📦 既存プロジェクトに追加
  📊 ステータス確認
  🤖 Agent実行
  ⚙️  設定
  ❌ 終了

# 新規プロジェクト作成
miyabi init <project-name> [--interactive] [--private]

# 既存プロジェクトに追加
miyabi install [--dry-run]

# ステータス確認（通常モード / Watch Mode）
miyabi status
miyabi status --watch  # 3秒ごとに自動更新

# シンプルなAgent実行
miyabi work-on <issue-number>

# または従来の方法
miyabi agent run <agent-type> --issue <issue-number>

# 並列実行（複数Issue）
miyabi parallel --issues 123,124,125 --concurrency 3

# 設定管理
miyabi config

推奨方法: gh CLI

# GitHub CLIで認証（推奨）
gh auth login

# アプリケーションは自動的に 'gh auth token' を使用

代替方法: 環境変数（CI/CD用）

export GITHUB_TOKEN=ghp_xxxxx

export MIYABI_LOG_LEVEL=info
export MIYABI_PARALLEL_AGENTS=3

要件	バージョン	説明
	>= 18.0.0	推奨: v20 LTS
	Latest	バージョン管理
	-	GitHubアカウント
	-	Personal Access Token

• gh CLI - GitHub CLI（推奨）

OS	サポート状況
	✅ macOS (Intel / Apple Silicon)
	✅ Linux (Ubuntu, Debian, RHEL系)
	✅ Windows (WSL2推奨)
	⚠️ Termux (一部機能制限あり)

Miyabiへのコントリビューションを歓迎します！

# 1. リポジトリをフォーク
# 2. フィーチャーブランチを作成
git checkout -b feature/amazing-feature

# 3. 変更をコミット（Conventional Commits準拠）
git commit -m 'feat: Add amazing feature'

# 4. ブランチをプッシュ
git push origin feature/amazing-feature

# 5. Pull Requestを作成

Conventional Commits準拠:

• feat: - 新機能
• fix: - バグ修正
• docs: - ドキュメント更新
• chore: - ビルド・設定変更
• test: - テスト追加・修正
• refactor: - リファクタリング
• perf: - パフォーマンス改善

Miyabiの開発を支援してください:

• ✅ 「Miyabi」は Shunsuke Hayashi の商号です（未登録商標）
• ✅ 改変版を配布する場合は、変更内容を明示する必要があります
• ✅ 詳細は LICENSE および NOTICE ファイルをご覧ください

• 🚀 miyabi work-on - シンプルな新コマンド（技術的複雑さを隠蔽）
• 🎯 miyabi init --interactive - 対話形式プロジェクトセットアップ
  • プロジェクトタイプ選択（WebApp, API, CLI, Library）
  • GitHub接続ウィザード
  • リアルタイム進捗フィードバック
  • プロアクティブエラーメッセージ

• ✨ Getting Started Guide (250+行) - 完全セットアップガイド
• 🆘 Troubleshooting Guide (280+行) - 詳細なトラブルシューティング
• 🎨 Real Code Examples - 全ディレクトリに実際のRustコード例
• 📖 Agent Overview - 全21 Agents詳細ガイド
• 🌟 Workflow Examples - 実コマンド・実出力付き完全ワークフロー

スコア推移: 7/10 → 9.5/10 → 10.5/10 ⭐

Before (7/10):

• ❌ 空の.claude/agents/ディレクトリ
• ❌ 不明瞭な次のステップ（3行）
• ❌ インタラクティブセットアップなし
• ❌ 汎用的なエラーメッセージ

After (10.5/10) ⭐:

• ✅ 全ディレクトリに実際のコード例
• ✅ 詳細な4ステップガイド（コピペ可能）
• ✅ プロジェクトタイプ選択付きインタラクティブセットアップ
• ✅ プロアクティブエラー：「これが正確な修正方法です」

• ✅ 735+テスト合格 (0失敗, 17 ignored)
• ✅ 0 Clippy警告 - 6つの警告修正 + doctest修正
• ✅ 8クレート公開 - 全てcrates.io v0.1.1で利用可能

1. miyabi-types - コア型定義
2. miyabi-core - 共通ユーティリティ（config, logger, retry, cache）
3. miyabi-llm - LLM統合層（GPT-OSS-20B, Ollama, vLLM, Groq）
4. miyabi-potpie - Potpie AI + Neo4j知識グラフ
5. miyabi-github - GitHub APIラッパー（octocrab）
6. miyabi-worktree - Git Worktree並列実行
7. miyabi-agents - 7 Coding Agents + 14 Business Agents
8. miyabi-cli - CLIツール（init, status, agent, work-on）

• ✅ Getting Started - docs/GETTING_STARTED.md
• ✅ Troubleshooting - docs/TROUBLESHOOTING.md
• ✅ Agent Overview - .claude/agents/README.md
• ✅ Full Guide - CLAUDE.md

• ✅ ライセンスをApache 2.0に変更（商標・特許保護強化）
• ✅ NOTICEファイル追加（帰属表示・商標保護）
• ✅ README英語版セクション追加
• ✅ GitHubトークンセキュリティ強化（gh CLI優先）
• ✅ Termux環境完全対応ガイド
• ✅ Discord MCP Server統合（コミュニティ運営）

❌ エラーが発生しました: Error: Failed to request device code: Not Found

# グローバルインストールを削除
npm uninstall -g miyabi

# npxキャッシュをクリア
rm -rf ~/.npm/_npx

# 最新版を明示的に指定
npx miyabi@latest

⚠️ トークンが無効です。再認証が必要です

# 古いトークンを削除
rm .env

# 新しいトークンを作成（上記の手順に従う）
echo "GITHUB_TOKEN=ghp_new_token" > .env

miyabi

npx miyabi

# Install from crates.io
cargo install miyabi-cli

# Run
miyabi

npx miyabi

That's it. Everything runs automatically.

Miyabi is a complete autonomous AI development operations platform built on the "GitHub as OS" architecture.

From issue creation to code implementation, PR creation, and deployment—everything is fully automated.

• ✅ Fully automated from issue creation to PR creation
• ✅ Structured 53-label system
• ✅ Auto-integration with GitHub Projects V2
• ✅ Real-time progress tracking
• ✅ High-speed processing with parallel execution (72% efficiency)

Miyabi uses Claude AI for automatic code generation. Please note:

• ✅ Always Review: Review all generated code before merging
• ✅ Thorough Testing: Test extensively in non-production environments
• ✅ Potential Errors: AI-generated code may contain unexpected errors
• ✅ Production Deployment: Users are responsible for code deployed to production

The Miyabi project is not liable for issues arising from AI-generated code. Users must verify the quality, security, and functionality of generated code themselves.

See LICENSE and NOTICE for full details.

• ✅ Auto-generated from TypeScript/JavaScript code
• ✅ JSDoc/TSDoc support
• ✅ Watch mode (auto-detects file changes)
• ✅ Training materials generation

• ✅ CODEOWNERS auto-generation
• ✅ Branch protection rules management
• ✅ Secret scanning integration
• ✅ Dependency vulnerability checking
• ✅ SBOM generation (CycloneDX format)

# Run directly with npx (recommended)
npx miyabi

# Global installation
npm install -g miyabi
miyabi

Miyabi is also available as an official Claude Code Plugin.

# Inside Claude Code
/plugin install miyabi

Available commands after installation:

/miyabi-init      # Create new project
/miyabi-status    # Check status
/miyabi-auto      # Water Spider auto mode
/miyabi-todos     # TODO detection & Issue creation
/miyabi-agent     # Run agent
/miyabi-docs      # Generate documentation
/miyabi-deploy    # Execute deployment
/miyabi-test      # Run tests

Details: Claude Code Plugin Integration Guide

When used as a Claude Code Plugin, the following event hooks are automatically executed:

pre-commit    # Pre-commit checks
post-commit   # Post-commit notifications
pre-pr        # Pre-PR checks
post-test     # Post-test coverage reports

Hook Features:

npx miyabi

✨ Miyabi

Everything completes with one command

? What would you like to do?
  🆕 Create new project
  📦 Add to existing project
  📊 Check status
  ❌ Exit

AI agents automatically:

• Analyze and label issues
• Decompose into tasks
• Implement code
• Review code quality
• Create PR

PR completes in 10-15 minutes. Just review and merge.

• Node.js >= 18.0.0 (recommended: v20 LTS)
• GitHub Account
• git CLI - Version control
• GitHub Personal Access Token - API authentication

• gh CLI - GitHub CLI (recommended)

• ✅ macOS (Intel / Apple Silicon)
• ✅ Linux (Ubuntu, Debian, RHEL-based)
• ✅ Windows (WSL2 recommended)
• ⚠️ Termux (some features limited)

Support Miyabi's development:

• Binary Distribution: Licensed under Apache License 2.0

  • ✅ Free to use for personal, educational, and commercial purposes
  • ✅ Free to distribute unmodified binaries with attribution
  • ✅ No usage restrictions or fees

• Source Code: Proprietary and not included

  • ⚠️ Source code is confidential and protected by copyright
  • ⚠️ Reverse engineering, decompilation, or disassembly is prohibited
  • ⚠️ This is NOT "open source" software (as defined by OSI)

• Trademarks: "Miyabi" is a product name claimed by Shunsuke Hayashi (unregistered)

• See Also: LICENSE, NOTICE, EULA

Privacy by Default - Data collection requires explicit opt-in consent:

• Mandatory Local Data (never transmitted):

  • Anonymous User ID (UUID v4)
  • EULA acceptance timestamp
  • Installation date

• Optional Data (opt-in required):

  • Email address (for product updates, if you register)
  • Anonymous usage analytics (command frequency, error rates, OS version)
  • Crash reports (anonymized stack traces)

GDPR & CCPA Compliant - Full rights to access, correct, and delete your data.

📖 Read More: Privacy Policy | EULA | Terms of Service

miyabi

npx miyabi