npx miyabi

The Magic

📝 Write an Issue    →    🤖 7 AI Agents collaborate    →    ✅ PR arrives

Miyabi orchestrates 7 specialized coding agents that autonomously analyze, implement, review, test, and create pull requests — all triggered by a single GitHub Issue.

Why Miyabi?

Miyabi treats GitHub as an operating system — Issues are the task queue, Labels are the state machine, Actions are the execution engine, and Webhooks are the event bus.

Ecosystem

Miyabi is a full-stack agentic framework. These are its core subsystems:

┌─────────────────────────────────────────────────────────────────┐
│                        🌸 Miyabi                                │
│                                                                 │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────────────────┐  │
│  │ Miyabi CLI   │  │ Agent SDK    │  │ MCP Bundle            │  │
│  │ 25 commands  │  │ 7 coding +   │  │ 172+ tools for        │  │
│  │ npx miyabi   │  │ 14 business  │  │ Claude Desktop/Code   │  │
│  └──────────────┘  └──────────────┘  └───────────────────────┘  │
│                                                                 │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────────────────┐  │
│  │ Agent Skill  │  │ GitNexus     │  │ GitHub as OS          │  │
│  │ Bus          │  │ Code Intel   │  │ 53 labels × 16        │  │
│  │ 110+ skills  │  │ Impact       │  │ workflows             │  │
│  └──────────────┘  └──────────────┘  └───────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

Component	Repository	Stars
Agent Skill Bus	ShunsukeHayashi/agent-skill-bus
GitNexus	ShunsukeHayashi/gitnexus-stable-ops
MCP Bundle	Included in monorepo

Quick Start

# Install and run
npx miyabi

# Check system status
npx miyabi status --json
npx miyabi doctor --json

# Full automation: Issue → Code → Test → PR
npx miyabi cycle

# Shortcuts
npx miyabi fix 123        # Fix bug (Issue #123)
npx miyabi build 123      # Add feature (Issue #123)
npx miyabi ship           # Deploy to production

# MCP Server for Claude Desktop/Code
npm install -g miyabi-mcp-bundle

Packages

Package	npm	Description
miyabi		CLI - 25-command autonomous development framework
miyabi-mcp-bundle		MCP Server - 172+ tools for Claude Desktop/Code
@miyabi/agent-sdk	v0.1.0	Agent SDK - 7 Coding Agents in TypeScript
@agentic-os/core	v0.1.0	Core - Agent system foundation

Monorepo Structure

packages/
├── cli/                  # Miyabi CLI (npx miyabi)
├── mcp-bundle/           # MCP Server (172+ tools)
├── miyabi-agent-sdk/     # Agent SDK (7 Coding Agents)
├── core/                 # @agentic-os/core
├── coding-agents/        # Coding Agent implementations
├── business-agents/      # Business Agent definitions
├── shared-utils/         # Cross-package utilities
├── context-engineering/  # Context engineering tools
├── github-projects/      # GitHub Projects V2 integration
├── task-manager/         # Task management
├── doc-generator/        # Documentation generator
└── miyabi-web/           # Web dashboard

CLI Commands

Core Commands

Development Commands

Tool Commands

Agent System

7 Coding Agents

14 Business Agents (Planned)

Marketing, Sales, Content, and Analytics agents for end-to-end business automation. Currently in design phase.

Quality Gate

CodeGenAgent → ReviewAgent (score 80+?) → [Yes] → PRAgent
                    ↓ [No]
              Retry up to 3x → Below threshold → Escalate to human

GitHub as Operating System

pending → analyzing → implementing → reviewing → done

Key Features

Agent Skill Bus (110+ Skills)

Dynamically load and execute skills via the bus — code-reviewer, test-generator, commit-helper, and 107 more.

npx miyabi skills list    # List 110+ skills
npx miyabi skills health  # Health score

agent-skill-bus is the standalone skill engine that powers Miyabi's extensibility.

GitNexus Code Intelligence

Automatic dependency analysis, test coverage mapping, and cross-package impact assessment before any code change.

gitnexus-stable-ops provides the code intelligence backbone.

Distributed Cluster Execution

Run tasks across up to 5 machines (MacBook + Windows + Mac mini x3) via SSH/Tailscale network dispatch.

X/Discord Auto-Notification

miyabi release announce auto-posts release info via X (Twitter) API v2 and Discord webhooks.

Development

# Root level
npm test                  # vitest
npm run build             # TypeScript compile
npm run lint              # ESLint
npm run typecheck         # TypeScript type check
npm run verify:all        # lint + typecheck + test + security

# CLI package
cd packages/cli
npm run dev               # tsx (development)
npm run build             # tsc + fix-esm-imports
npm test                  # vitest

# MCP Bundle
cd packages/mcp-bundle
npm run dev               # tsx hot reload
npm test                  # vitest

Requirements

• Node.js 18+
• GitHub account + GITHUB_TOKEN

Learn More

• CLI Documentation
• MCP Bundle Documentation
• Agent SDK
• Discord Community
• Report Issues
• Sponsor

Like Miyabi?

If Miyabi helps your development workflow, consider:

• Give it a Star to help others discover it
• Follow @The_AGI_WAY for updates and AI development insights
• Join Discord to connect with the community
• Sponsor to support continued development

License

Apache 2.0 - Copyright (c) 2025-2026 Shunsuke Hayashi / 合同会社みやび