psefoy
v0.20.2
Published
Psefoy - Autonomous AI development platform with GitHub OS integration. Based on Miyabi framework with test11 validation fixes. Optimized for AI coding agents (Claude Code).
Maintainers
Readme
🌸 Miyabi (雅)
一つのコマンドで全てが完結する自律型開発フレームワーク
Zero-learning-cost CLI for autonomous AI development
Designed for both humans and AI agents (Claude Code, Devin, etc.)
🚀 Quick Start • 📖 Documentation • 💡 Features • 🤖 For AI Agents
🆕 What's New in v0.19.0
- 7 Claude Skills - Reusable workflow templates
code-reviewer- Code review with quality scoringcommit-helper- Conventional Commits generationtest-generator- Unit test generationdoc-generator- Documentation generationrefactor-helper- Safe refactoring guidanceskill-creator- Create custom skillsautonomous-coding-agent- CLI automation workflows
- Windows Support - Full cross-platform compatibility
- Dependencies Updated - @anthropic-ai/sdk 0.71, @octokit/rest 21
✨ What is Miyabi?
Miyabi (雅 - Japanese for "elegance") transforms your development workflow with one command.
npx miyabi init my-projectThat's it. No configuration files. No complex setup. Just pure elegance.
🎬 See it in Action
Before Miyabi:
❌ Manual repo setup
❌ Configure labels
❌ Setup workflows
❌ Create project boards
❌ Write documentation
❌ Configure CI/CD
⏰ Time: 2-3 hoursWith Miyabi:
npx miyabi init my-project
✓ Repository created
✓ 53 labels configured
✓ 12 workflows deployed
✓ Projects V2 linked
✓ Documentation generated
✓ CI/CD ready
⏰ Time: 2 minutes🌟 Key Highlights
🚀 Quick Start
📝 Note: Miyabi is currently optimized for TypeScript/Node.js projects. For other languages (Python, Go, Rust, etc.), see Language & Framework Support below for adaptation instructions.
For Humans 👨💻
Interactive Mode (Easiest)
npx miyabiThen select from the menu:
- 🌸 First-Time Setup (onboarding wizard)
- 🆕 Create New Project
- 📦 Add to Existing Project
- 📊 Check Status
- 🩺 Health Check (diagnostics)
One-Command Execution (v0.15.0+)
# Magic command - interactive wizard
npx miyabi run
# Quick shortcuts
npx miyabi fix 123 # Fix issue #123
npx miyabi build 456 # Build feature for issue #456
npx miyabi ship # Deploy with approval gatesFeatures:
- TUI Dashboard with real-time progress
- Human-in-the-loop approval gates for critical actions
- One command replaces complex agent orchestration
Direct Commands
# First-time setup wizard
npx miyabi onboard
# Health check & diagnostics
npx miyabi doctor
# Create new project
npx miyabi init my-awesome-project
# Add to existing project
cd existing-project
npx miyabi install
# Check agent status
npx miyabi status --watchFor AI Agents (Claude Code, Devin) 🤖
v0.5.0+ Auto-detects Claude Code and shows CLI commands:
npx miyabi
# → 💡 Claude Code環境が検出されました
# 利用可能なコマンド:
# npx miyabi init <project-name>
# npx miyabi install
# npx miyabi statusDirect usage:
# Create project with all options
npx miyabi init my-project --private
# Install to existing repo
npx miyabi install
# Get status
npx miyabi status
# Configure
npx miyabi config🌸 プログラムが苦手な方へ
👉 3ステップで完全自動セットアップ
プログラミングの知識がなくても大丈夫! Claude Codeが全部やってくれます。
ステップ1: Claude Codeをインストール
ステップ2: 魔法の言葉を入力
/setup-miyabi
Miyabiをセットアップしてくださいステップ3: AIの質問に答えるだけ!
あとは全部自動です 🎉
📖 詳細ガイド: プログラムが苦手な方向け完全ガイド
画面のスクリーンショット付き・所要時間: 約10分
💡 Features
🎯 Core Features
npx miyabi init my-projectWhat happens:
- ✅ GitHub repository created
- ✅ 53 labels configured (state machine)
- ✅ 12+ GitHub Actions deployed
- ✅ GitHub Projects V2 linked
- ✅ Local npm project initialized
- ✅
.claude/directory with 6 AI agents - ✅ Welcome issue created
- ✅ Documentation generated
Time: ~2 minutes
53 Labels Across 10 Categories
States (7 labels):
📥 state:pending→🔍 state:analyzing→🏗️ state:implementing→👀 state:reviewing→✅ state:done
Types (10 labels):
🐛 type:bug✨ type:feature📚 type:docs♻️ type:refactor🧪 type:test
Priority (4 labels):
📊 priority:P0-Critical⚠️ priority:P1-High📊 priority:P2-Medium📊 priority:P3-Low
Agents (6 labels):
🤖 agent:coordinator🤖 agent:codegen🤖 agent:review🤖 agent:issue🤖 agent:pr🤖 agent:deploy
Phase (8 labels):
🎯 phase:planning🏗️ phase:development🧪 phase:testing🚀 phase:deployment
12+ Workflows Included
| Workflow | Trigger | Purpose | |----------|---------|---------| | Autonomous Agent | Issue opened | Auto-analyze & implement | | Auto-Label | Issue/PR opened | Intelligent labeling | | State Machine | Label changed | State transitions | | Auto-Review | PR opened | Code review | | Deploy Pages | Push to main | Docs deployment | | Economic Circuit Breaker | High API usage | Cost control | | Weekly KPI Report | Schedule | Progress tracking | | Webhook Router | All events | Event routing |
Full .claude/ Directory Deployment
6 AI Agents:
CoordinatorAgent- Task orchestrationCodeGenAgent- Code generationReviewAgent- Quality assuranceIssueAgent- Issue managementPRAgent- Pull request automationDeploymentAgent- CI/CD
7 Custom Commands:
/agent-run- Run autonomous agent/create-issue- Smart issue creation/deploy- Deploy to production/generate-docs- Auto documentation/security-scan- Security audit/test- Run test suite/verify- System health check
MCP Servers:
github-enhanced.js- Enhanced GitHub integrationide-integration.js- IDE bridgingproject-context.js- Project awareness
Learn more about Claude Code →
🎨 User Experience
For Humans:
- ✨ Interactive menus
- 🇯🇵 Full Japanese support
- 📊 Beautiful status displays
- 🎯 Guided setup wizard
- ❓ Contextual help
For AI Agents:
- 🤖 Non-interactive mode
- 📋 JSON output
- 🔧 Programmatic API
- 🌐 Environment variables
- 📖 Full context in README
🌍 Language & Framework Support
Current Implementation (v0.13.0)
Primary Support: TypeScript/Node.js
Miyabi's GitHub Actions and workflows are currently optimized for:
- Language: TypeScript, JavaScript
- Runtime: Node.js ≥18
- Package Manager: npm
- Testing: Vitest
- Build Tools: tsc, esbuild
Workflows affected:
autonomous-agent.yml- Usesnpm run typecheck,npm run agents:parallel:execdeploy-pages.yml- Node.js app deploymentweekly-report.yml- TypeScript/Node.js implementationweekly-kpi-report.yml- TypeScript/Node.js KPI reporting
Multi-Language Roadmap
Phase 1 (Current): TypeScript/Node.js optimized templates Phase 2 (v0.14+): Language-agnostic workflow templates Phase 3 (2026+): Fully autonomous language detection
Adapting for Other Languages/Frameworks
You can easily adapt Miyabi for your stack using Claude Code:
# 1. Install Miyabi (creates TypeScript templates)
npx miyabi install
# 2. Ask Claude Code to adapt
# In Claude Code, run:Prompt for Claude Code:
.claude/commands と .claude/agents について、
元の指示の意図を変えずに、Python と FastAPI 用に書き換えてください。
以下を変更:
- npm → pip/poetry
- TypeScript → Python
- Vitest → pytest
- tsc → mypy
- Node.js → Python 3.11+
ワークフローファイルも同様に書き換えてください。Result: All workflows adapted for Python!
Prompt for Claude Code:
.claude/commands と .claude/agents について、
Go言語とGinフレームワーク用に書き換えてください。
以下を変更:
- npm → go mod
- TypeScript → Go
- Vitest → go test
- tsc → go build
- Node.js → Go 1.21+
ワークフローファイルも同様に書き換えてください。Prompt for Claude Code:
.claude/commands と .claude/agents について、
Rust言語とActixフレームワーク用に書き換えてください。
以下を変更:
- npm → cargo
- TypeScript → Rust
- Vitest → cargo test
- tsc → cargo build
- Node.js → Rust 1.70+
ワークフローファイルも同様に書き換えてください。Supported Stacks (with adaptation)
| Language | Framework | Package Manager | Testing | Status | |----------|-----------|----------------|---------|--------| | TypeScript | Express/Next.js | npm/yarn/pnpm | Vitest | ✅ Native | | JavaScript | React/Vue | npm/yarn/pnpm | Jest | ✅ Native | | Python | FastAPI/Django | pip/poetry | pytest | 🔄 Adapt | | Go | Gin/Echo | go mod | go test | 🔄 Adapt | | Rust | Actix/Rocket | cargo | cargo test | 🔄 Adapt | | Ruby | Rails/Sinatra | bundler | rspec | 🔄 Adapt | | Java | Spring Boot | maven/gradle | junit | 🔄 Adapt | | C# | .NET | nuget | xunit | 🔄 Adapt |
Legend:
- ✅ Native: Works out-of-the-box
- 🔄 Adapt: Use Claude Code to adapt workflows
Best Practices for Adaptation
- Keep workflow intentions intact - Don't change what workflows do, only how they do it
- Preserve label system - The 53-label system is language-agnostic
- Maintain agent roles - CoordinatorAgent, CodeGenAgent, etc. work with any language
- Update documentation - Document your language-specific setup
Contributing Multi-Language Templates
We welcome contributions for other languages! See:
- CONTRIBUTING.md - Contribution guidelines
- docs/MULTI_LANGUAGE_GUIDE.md - Template creation guide
📊 Commands Reference
init <project-name>
Create a new project with full automation.
# Interactive
npx miyabi init my-project
# With options
npx miyabi init my-project --private
# Skip npm install
npx miyabi init my-project --skip-installOptions:
-p, --private- Create private repository--skip-install- Skip npm install step
What it creates:
my-project/
├── .github/
│ ├── workflows/ # 12+ GitHub Actions
│ └── labels.yml # 53 labels
├── .claude/
│ ├── agents/ # 6 AI agents
│ ├── commands/ # 7 custom commands
│ ├── hooks/ # Command hooks
│ └── mcp-servers/ # 3 MCP servers
├── src/
├── package.json
└── README.mdinstall
Add Miyabi to an existing project.
# Interactive
npx miyabi install
# Dry run (preview changes)
npx miyabi install --dry-run
# Non-interactive mode (CI/CD, Termux, SSH)
npx miyabi install --non-interactive
npx miyabi install --yesOptions:
--dry-run- Preview changes without making them--non-interactive- Skip all prompts (auto-approve)-y, --yes- Auto-approve all prompts
What it does:
- ✅ Analyzes existing structure
- ✅ Merges labels (non-destructive)
- ✅ Auto-labels existing issues
- ✅ Deploys missing workflows
- ✅ Links to Projects V2
- ✅ Creates
.claude/directory
Smart merge:
- Existing labels are preserved
- Workflows skip if already exist
- Issues are auto-labeled intelligently
status
Check agent activity and project status.
# One-time check
npx miyabi status
# Watch mode (auto-refresh every 10s)
npx miyabi status --watchOutput:
┌──────────────┬────────┬─────────────┬──────────────┐
│ Agent │ Status │ Task │ Last Update │
├──────────────┼────────┼─────────────┼──────────────┤
│ Coordinator │ ✅ Active │ #123 │ 2 mins ago │
│ CodeGen │ 💤 Idle │ - │ - │
│ Review │ ✅ Active │ #124 │ 30 secs ago │
│ Issue │ ✅ Active │ #125 │ 1 min ago │
│ PR │ 💤 Idle │ - │ - │
│ Deploy │ ✅ Active │ main │ 5 mins ago │
└──────────────┴────────┴─────────────┴──────────────┘
📊 Summary:
✅ 4 agents active
💤 2 agents idle
📥 12 pending issues
🚀 3 in progressdocs
Generate documentation from code.
# Interactive
npx miyabi docs
# Direct
npx miyabi docs --input ./src --output ./docs/API.md
# Watch mode
npx miyabi docs --watch
# Include training materials
npx miyabi docs --trainingGenerates:
- API documentation
- Type definitions
- Usage examples
- Training materials (optional)
config
Manage Miyabi configuration.
# Interactive wizard
npx miyabi config
# Show current config
npx miyabi config --show
# Reset to defaults
npx miyabi config --resetConfiguration file (.miyabi.yml):
github:
defaultPrivate: true
token: ghp_xxxxx # Or use GITHUB_TOKEN env var
project:
defaultLanguage: typescript
defaultFramework: react
gitignoreTemplate: Node
licenseTemplate: mit
workflows:
autoLabel: true
autoReview: true
autoSync: true
cli:
language: ja # ja or en
theme: default
verboseErrors: truesetup
Interactive setup guide for beginners.
# Interactive mode
npx miyabi setup
# Non-interactive mode
npx miyabi setup --non-interactive
# Skip specific steps
npx miyabi setup --skip-token --skip-configOptions:
--non-interactive- Skip all prompts-y, --yes- Auto-approve all prompts--skip-token- Skip token setup--skip-config- Skip configuration
Guides through:
- ✅ Environment check (Node.js, Git, gh CLI)
- ✅ GitHub authentication
- ✅ Token creation
- ✅ Configuration
- ✅ First project creation
onboard
Comprehensive first-run wizard for new users.
# Interactive onboarding
npx miyabi onboard
# Skip optional features
npx miyabi onboard --skip-demo --skip-tourOptions:
--skip-demo- Skip demo project creation--skip-tour- Skip feature tour--non-interactive- Exit (requires interactive mode)-y, --yes- Same as --non-interactive
What it does:
- ✅ Welcome & introduction
- ✅ System health check (calls
doctor) - ✅ 30-second "What is Miyabi?" overview
- ✅ Demo project creation (optional)
- ✅ Interactive feature tour
- ✅ Quick commands reference
- ✅ Resource links
Perfect for:
- 🆕 First-time Miyabi users
- 📚 Learning the system
- 🎓 Understanding capabilities
- 🚀 Quick start
doctor
System health check and diagnostics.
# Basic health check
npx miyabi doctor
# Detailed diagnostics
npx miyabi doctor --verbose
# JSON output (for AI agents)
npx miyabi doctor --jsonHealth Checks Performed:
| Check | Description | Fix Suggestions |
|-------|-------------|-----------------|
| Node.js | Version ≥18.0.0 | Upgrade Node.js |
| Git | Installation & version | Install Git |
| GitHub CLI | gh authentication | Run gh auth login |
| GITHUB_TOKEN | Token format validation | Set env var or use gh CLI |
| Token Permissions | Required scopes check | Add repo, workflow, project |
| Network | GitHub API connectivity | Check internet connection |
| Repository | Git repo detection | Initialize git repo |
| .miyabi.yml | Config file validation | Fix YAML syntax |
| Claude Code | Environment detection | N/A (informational) |
Output Example:
🩺 Miyabi Health Check
✓ Node.js: v20.10.0 (OK)
✓ Git: git version 2.42.0 (OK)
✓ GitHub CLI: gh version 2.40.0 (Authenticated)
✓ GITHUB_TOKEN: Valid token format
⚠ Token Permissions: Missing recommended scopes: project
💡 Add recommended scopes for full functionality: https://github.com/settings/tokens
✓ Network Connectivity: GitHub API accessible
✓ Repository: Git repository detected
✓ Claude Code: Standard terminal
Summary:
✓ 7 checks passed
⚠ 1 warnings
8 total checks
⚠ Overall: Issues detected (but not critical)
Next Steps:
1. Review the suggestions above to fix issues
2. Run this command again to verify fixes
3. For help: https://github.com/ShunsukeHayashi/Miyabi/issuesJSON Mode:
npx miyabi doctor --json{
"checks": [
{
"name": "Node.js",
"status": "pass",
"message": "v20.10.0 (OK)",
"details": "Node.js v20.10.0 meets minimum requirement (≥18)"
},
...
],
"summary": {
"passed": 7,
"warned": 1,
"failed": 0,
"total": 8
},
"overallStatus": "issues"
}Exit Codes:
0- Healthy or minor issues1- Critical issues found
🤖 AI Agent Integration
Claude Code Auto-Detection (v0.5.0+)
Miyabi automatically detects Claude Code environment and provides CLI-friendly output:
$ npx miyabi
✨ Miyabi
一つのコマンドで全てが完結する自律型開発フレームワーク
💡 Claude Code環境が検出されました
利用可能なコマンド:
npx miyabi init <project-name> - 新規プロジェクト作成
npx miyabi install - 既存プロジェクトに追加
npx miyabi status - ステータス確認
npx miyabi docs - ドキュメント生成
npx miyabi config - 設定管理
npx miyabi setup - セットアップガイド
詳細: npx miyabi --helpDetection logic:
CLAUDE_CODE=trueANTHROPIC_CLI=trueTERM_PROGRAM=ClaudeANTHROPIC_API_KEYis set
Programmatic API
import { init, install, status, config } from 'miyabi';
// Initialize new project
await init('my-project', {
private: true,
skipInstall: false,
});
// Install to existing project
await install({
dryRun: false,
});
// Get status
const statusData = await status({ watch: false });
console.log(statusData);
// Configure
await config({
githubToken: process.env.GITHUB_TOKEN,
language: 'ja',
});Environment Variables
# GitHub token (required)
export GITHUB_TOKEN=ghp_your_token_here
# Anthropic API key (for AI features)
export ANTHROPIC_API_KEY=sk-ant-xxx
# Webhook secret (for webhook router)
export WEBHOOK_SECRET=your_secret
# Non-interactive mode (auto-approve prompts)
export MIYABI_AUTO_APPROVE=true
# CI environment (auto-detected)
export CI=trueNon-Interactive Mode:
Miyabi automatically detects non-interactive environments:
MIYABI_AUTO_APPROVE=true- Explicit non-interactive modeCI=true- CI/CD environments (GitHub Actions, GitLab CI, etc.)- Non-TTY terminals - Pipes, redirects, SSH without PTY
Usage in CI/CD:
# GitHub Actions example
- name: Install Miyabi
run: npx miyabi install --non-interactive
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}Usage in Termux (Android):
# Termux automatically uses non-interactive mode
export MIYABI_AUTO_APPROVE=true
npx miyabi install🔧 Configuration
Priority Order
Command-line flags (highest priority)
npx miyabi config --token=ghp_xxxEnvironment variables
export GITHUB_TOKEN=ghp_xxxConfig file (
.miyabi.yml)github: token: ghp_xxxDefault values (lowest priority)
Configuration File
github:
token: ghp_xxxxx # GitHub Personal Access Token
defaultPrivate: true # Create private repos by default
defaultOrg: my-org # Default organization
project:
defaultLanguage: typescript # typescript, javascript, python, go, rust
defaultFramework: react # react, vue, angular, next, express
gitignoreTemplate: Node # Node, Python, Go, Rust, Java, etc.
licenseTemplate: mit # mit, apache-2.0, gpl-3.0, etc.
workflows:
autoLabel: true # Auto-label new issues
autoReview: true # Auto-review PRs
autoSync: true # Auto-sync to Projects
cli:
language: ja # ja (日本語) or en (English)
theme: default # default, minimal, colorful
verboseErrors: true # Show detailed error messages📋 Requirements
Node.js
≥ 18.0.0
Git
Latest
GitHub CLI
Latest
GitHub
Account
Token
PAT
Installation
# Check requirements
node --version # Should be >= 18.0.0
git --version # Any recent version
gh --version # Latest stable
# Install miyabi (no installation needed for npx)
npx miyabi@latest
# Or install globally
npm install -g miyabiGitHub Authentication
Recommended: Use GitHub CLI (automatic)
# Authenticate once
gh auth login
# Miyabi will automatically use gh CLI token
npx miyabi install
# ✅ GitHub authentication complete (via gh CLI)Alternative: Personal Access Token
If you prefer manual token management, create at: https://github.com/settings/tokens/new
Required scopes:
- ✅
repo- Full repository access - ✅
workflow- Update workflows - ✅
write:packages- Publish packages - ✅
delete:packages- Manage packages - ✅
admin:org- Organization management (for org repos) - ✅
project- Projects V2 access
Token Priority:
- gh CLI (automatic, recommended) -
gh auth login - GITHUB_TOKEN environment variable -
export GITHUB_TOKEN=ghp_xxx - .env file - Local development
- OAuth flow - Interactive fallback
🐛 Troubleshooting
Error:
❌ GITHUB_TOKEN not found in environment
💡 対処法:
1. 環境変数 GITHUB_TOKEN を設定してください
2. `export GITHUB_TOKEN=ghp_your_token`
3. もしくは miyabi config を実行して設定してくださいSolution:
Option 1: Use GitHub CLI (Recommended)
# One-time setup
gh auth login
# Miyabi will automatically use gh CLI token
npx miyabi installOption 2: Environment variable
export GITHUB_TOKEN=ghp_your_token_here
npx miyabi init my-projectOption 3: .env file (local development only)
echo "GITHUB_TOKEN=ghp_your_token" > .env
npx miyabi install⚠️ Security Warning:
- Only use
.envfor local development - Always add
.envto.gitignore - Never commit
.envto version control - See SECURITY.md for best practices
Option 4: Config file
npx miyabi config
# → Follow prompts to set tokenError:
❌ repository creation failed: リポジトリ名 "my-project" は既に存在しています
💡 解決策:
1. 別の名前を試してください: npx miyabi init my-project-2
2. または、既存リポジトリを削除: gh repo delete my-project --yes
3. GitHub で確認: https://github.com/settings/repositoriesSolution:
Option 1: Different name
npx miyabi init my-project-newOption 2: Delete existing (⚠️ careful!)
gh repo delete my-project --yes
npx miyabi init my-projectOption 3: Install to existing
gh repo clone my-project
cd my-project
npx miyabi installError:
❌ GitHub API rate limit exceededSolution:
Check rate limit:
gh api rate_limitWait or use authenticated token:
export GITHUB_TOKEN=ghp_your_tokenRate limits:
- Unauthenticated: 60 requests/hour
- Authenticated: 5,000 requests/hour
Error:
❌ Claude template directory not found: /path/to/templates/claude-codeSolution:
Reinstall miyabi:
npm uninstall -g miyabi
npm cache clean --force
npx miyabi@latest init my-projectOr use local installation:
git clone https://github.com/ShunsukeHayashi/Miyabi.git
cd Miyabi/packages/cli
npm install
npm run build
npm link
miyabi init my-projectIssue: Running in Claude Code but interactive mode appears
Solution:
Manually set environment:
export CLAUDE_CODE=true
npx miyabiOr use direct commands:
npx miyabi init my-project
npx miyabi statusエラー:
npm error code ETARGET
npm error notarget No matching version found for miyabi-agent-sdk@*原因:
miyabi-agent-sdk はライブラリであり、CLIツールではありません。
npx miyabi-agent-sdk のように実行することはできません。
正しい使い方:
Option 1: Miyabi CLI を使用(推奨)
# Miyabi CLI から Agent を実行
npx miyabi agent run codegen --issue=123
npx miyabi agent run review --pr=456 --issue=123
npx miyabi agent run pr --issue=123Option 2: プログラムから直接使用
// package.json
{
"dependencies": {
"miyabi-agent-sdk": "^0.1.0-alpha.2"
}
}
// your-code.ts
import { CodeGenAgent } from 'miyabi-agent-sdk';
const agent = new CodeGenAgent({
githubToken: process.env.GITHUB_TOKEN,
anthropicApiKey: process.env.ANTHROPIC_API_KEY,
});
const result = await agent.generate({
issueNumber: 123,
repository: 'my-repo',
owner: 'my-org',
});詳細:
miyabi- CLIツール(npx miyabiで実行)miyabi-agent-sdk- ライブラリ(importで使用)
📚 Documentation
Core Docs
- 📖 Getting Started Guide - Step-by-step setup
- 🌸 For Non-Programmers - Complete beginner guide
- 📦 Install to Existing Project - Migration guide
- 🧪 Edge Case Tests - Testing scenarios
Agent Docs
- 🤖 Agent Operations Manual - Agent system
- 🔄 Webhook Event Bus - Event routing
- 📋 Testing Guide - Test strategies
API Reference
- 📝 API Documentation - Full API reference
- 🔧 Configuration Schema - Config options
- 🏷️ Label Reference - All 53 labels
🔗 Links
🙏 Acknowledgments
Built with love using:
📄 License
MIT © Shunsuke Hayashi
Open source with ❤️ from Tokyo 🗼
Note for AI Agents: This README contains full context. All features are documented above. Start by reading the AI Agent Integration section.
🌸 Made with elegance and precision • Report Issues • Contribute
