vibes-plug
Universal AI Agent Swarm & MCP plugin with 178 specialized skills, 9 autonomous subagents, and auto-activating Swarm Director for Antigravity, Cursor, Claude Code, Windsurf, and OpenAI Codex.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/roedyrustam/vibes-plug with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/roedyrustam/vibes-plug'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/roedyrustam--vibes-plug)HTML
<a href="/listings/roedyrustam--vibes-plug"><img src="/api/listings/roedyrustam--vibes-plug/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
*Supported Platforms: Google Antigravity (AGY), Claude Code, Cursor IDE, OpenAI Codex CLI, Windsurf, Trae, VSCode (Cline / Roo Code), Kimi, and Kiro.*
Method 1: CLI (NPM Installation - Recommended)
The CLI automatically scaffolds the required master rules for your specific IDE.
npm i -g vibes-plug vibes-plug init
Method 2: GitHub Installation (Direct via NPX / Git Clone - Always Latest)
You can install or execute VibesPlug directly from the GitHub repository using any of the following methods:
**Option A: Instant Execution via NPX (No Local Clone Required)** Run the installer directly from GitHub without cloning the repository:
# Run installer for all detected IDEs & platforms npx github:roedyrustam/vibes-plug --all # Or install globally from GitHub npm install -g git+https://github.com/roedyrustam/vibes-plug.git vibes-plug --all
**Option B: Clone & Universal Multi-Platform Installer** Clone the repository and run the built-in installer to auto-configure all your tools:
git clone https://github.com/roedyrustam/vibes-plug.git cd vibes-plug npm install # Run installer across all detected platforms: npm run install-all # (or node scripts/install.js --all)
**Option C: Direct Git Clone for Google Antigravity (AGY)** Google Antigravity natively loads plugins from `~/.gemini/config/plugins/`. Clone directly into your Antigravity plugins directory:
# macOS & Linux: git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug # Windows (PowerShell): git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
**Option D: Targeted Per-Project Installation** From your cloned `vibes-plug` directory, inject rules and skills into any specific project:
# For Claude Code (global + project): node scripts/install.js --claude --project /path/to/my-project # For Cursor IDE (project-specific): node scripts/install.js --cursor --project /path/to/my-project # For OpenAI Codex: node scripts/install.js --codex --project /path/to/my-project # For Windsurf, Trae, or VSCode (Cline): cp .windsurfrules /path/to/my-project/ cp .traerules /path/to/my-project/ cp .clinerules /path/to/my-project/
**Option E: Staying Updated via GitHub** To pull the latest skills and superintelligence engine updates:
cd ~/.gemini/config/plugins/vibes-plug # (or your cloned repository folder) git pull origin main npm test
Method 3: Platform-Specific Manual Configuration (ZIP Archive / Drop-in)
If you download the `.zip` archive, extract it and configure your IDE as follows: - **Google Antigravity (AGY):** Move the folder to `~/.gemini/config/plugins/vibes-plug`. - **Claude Code:** Run `vibes-plug --claude` or copy `CLAUDE.md` and `.claude/rules/` to your project root. - **Cursor IDE:** Run `vibes-plug --cursor --project .` or copy `.cursorrules` and `.cursor/rules/` to your project root. - **OpenAI Codex CLI:** Run `vibes-plug --codex` or copy `CODEX.md` and `.codex/rules/` to your project root. - **Windsurf IDE:** Copy `.windsurfrules` to your project root. - **Trae IDE:** Copy `.traerules` to your project root. - **VSCode (Cline / Roo):** Copy `.clinerules` to your project root. - **Kimi / Kiro:** Copy `.kimirules` or `.kirorules` to your project root.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
plugin.json · Manifest · 94 lines
- {
- "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
- "name": "vibes-plug",
- "displayName": "Vibes-Plug: Autonomous AI Swarm",
- "version": "4.8.0",
- "description": "Universal AI Agent Swarm & MCP plugin with 178 specialized skills, 9 autonomous subagents, and auto-activating Swarm Director for Antigravity, Cursor, Claude Code, Windsurf, and OpenAI Codex.",
- "logo": "assets/logo.svg",
- "icon": "assets/logo.svg",
- "suggestedPrompts": [
- "Activate autonomous multi-agent swarm to design and implement this task",
- "Dispatch fullstack-craftsman and quality-guardian in parallel",
- "Audit codebase invariants, AST symbols, and enforce anti-slop rules"
- ],
- "author": {
- "name": "Roedy Rustam",
- "email": "roedyrustam.id@gmail.com",
- "url": "https://github.com/roedyrustam"
- },
- "publisher": {
- "name": "Roedy Rustam",
- "url": "https://github.com/roedyrustam"
- },
- "homepage": "https://github.com/roedyrustam/vibes-plug",
- "repository": {
- "type": "git",
- "url": "https://github.com/roedyrustam/vibes-plug.git"
- },
- "bugs": {
- "url": "https://github.com/roedyrustam/vibes-plug/issues"
- },
- "documentation": "https://github.com/roedyrustam/vibes-plug#readme",
- "changelog": "https://github.com/roedyrustam/vibes-plug/blob/main/CHANGELOG.md",
- "privacyUrl": "https://github.com/roedyrustam/vibes-plug/blob/main/PRIVACY.md",
- "termsUrl": "https://github.com/roedyrustam/vibes-plug/blob/main/TERMS.md",
- "securityContact": "roedyrustam.id@gmail.com",
- "securityPolicy": "https://github.com/roedyrustam/vibes-plug/blob/main/SECURITY.md",
- "license": "MIT",
- "licenseUrl": "https://github.com/roedyrustam/vibes-plug/blob/main/LICENSE",
- "pricing": "free",
- "keywords": [
- "ai-agents",
- "multi-agent-swarm",
- "mcp-server",
- "model-context-protocol",
- "claude-code",
- "cursor-rules",
- "antigravity",
- "openai-codex",
- "vibe-coding",
- "agentic-ai",
- "skill-as-a-tool",
- "reverse-engineering",
- "ghidra",
- "binary-analysis",
- "rea",
- "fullstack",
- "fintech",
- "zero-to-prod",
- "anti-slop",
- "windsurf"
- ],
- "extensions": {
- "com.cursor": {
- "rulesDir": ".cursor/rules/",
- "rulesFile": ".cursorrules",
- "mcpConfig": ".cursor/mcp.json"
- },
- "org.vibesplug.platforms": {
- "antigravity": {
- "entry": "AGENTS.md",
- "config": "plugin.json",
- "skillsDir": "skills/",
- "logo": "assets/logo.svg",
- "icon": "assets/logo.svg"
- },
- "claude": {
- "entry": "CLAUDE.md",
- "rulesDir": ".claude/rules/",
- "skillsDir": "skills/"
- },
- "cursor": {
- "entry": ".cursorrules",
- "rulesDir": ".cursor/rules/",
- "mcp": ".cursor/mcp.json",
- "skillsDir": "skills/"
- },
- "codex": {
- "entry": "CODEX.md",
- "rulesDir": ".codex/rules/",
- "skillsDir": "skills/"
- }
- }
- }
- }
README.md · README · 875 lines · 2 findings marked
- <div align="center">
- <img src="./logo.jpg" alt="VibesPlug Logo" width="220" style="border-radius: 20px; margin-bottom: 16px; box-shadow: 0 8px 24px rgba(0,0,0,0.25);" />
- # ⚡ VibesPlug Pro v4.7.2: 178-Skill AI Agent Swarm & SaaT Architecture
- **Turn any IDE into an autonomous 178-agent software development studio.**
- *Zero AI Slop • Sovereign Anti-Slop Directive • Zero Tech Debt • Pure Production Velocity*
- <sub>💠 **3D Emblem Philosophy**: **Titanium Neural Plug** (Universal 6-IDE & MCP Connector) • **Obsidian Crystalline Brain** (Deterministic P1–P7 Reasoning) • **8 Orbital Spheres** (8 Specialist Subagents & 178 Domain Skills)</sub>
- <p align="center">
- <a href="https://vibes-plug.vercel.app/"><img src="https://img.shields.io/badge/Web_Showcase-Live-06b6d4?style=for-the-badge&logo=vercel&labelColor=0d1117" alt="Web Showcase" /></a>
- <a href="https://github.com/roedyrustam/vibes-plug/stargazers"><img src="https://img.shields.io/github/stars/roedyrustam/vibes-plug?style=for-the-badge&logo=github&color=FFD700&labelColor=0d1117" alt="GitHub Stars" /></a>
- <a href="https://github.com/roedyrustam/vibes-plug/network/members"><img src="https://img.shields.io/github/forks/roedyrustam/vibes-plug?style=for-the-badge&logo=github&color=58a6ff&labelColor=0d1117" alt="GitHub Forks" /></a>
- <a href="https://www.npmjs.com/package/vibes-plug"><img src="https://img.shields.io/npm/v/vibes-plug?style=for-the-badge&logo=npm&color=ef4444&labelColor=0d1117" alt="NPM Version" /></a>
- <a href="https://www.npmjs.com/package/vibes-plug"><img src="https://img.shields.io/npm/dt/vibes-plug?style=for-the-badge&logo=npm&color=10b981&labelColor=0d1117" alt="NPM Downloads" /></a>
- <a href="https://github.com/roedyrustam/vibes-plug/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge&labelColor=0d1117" alt="License" /></a>
- <a href="https://github.com/roedyrustam/vibes-plug/actions/workflows/plugin-security-scan.yml"><img src="https://img.shields.io/badge/Plugin_Trust-Verified-22c55e?style=for-the-badge&logo=shieldsdotio&labelColor=0d1117" alt="Plugin Trust Score" /></a>
- <a href="https://github.com/roedyrustam/vibes-plug/blob/main/SECURITY.md"><img src="https://img.shields.io/badge/Security_Policy-Active-f59e0b?style=for-the-badge&logo=shield&labelColor=0d1117" alt="Security Policy" /></a>
- <a href="https://twitter.com/intent/tweet?text=Turn%20any%20IDE%20into%20a%20178-agent%20autonomous%20software%20studio%20with%20VibesPlug!%20%F0%9F%9A%80%20https%3A%2F%2Fgithub.com%2Froedyrustam%2Fvibes-plug%20%23VibeCoding%20%23AIAgents"><img src="https://img.shields.io/badge/Share%20on-X-000000?style=for-the-badge&logo=x&labelColor=0d1117" alt="Share on X" /></a>
- </p>
- <p align="center">
- <a href="https://github.com/roedyrustam/vibes-plug">⭐ <b>Star this repo</b></a> to support the project & help it trend!
- </p>
- [🇬🇧 English](#english) | [🇮🇩 Bahasa Indonesia](#bahasa-indonesia) | [🇨🇳 中文 (Mandarin)](#mandarin) | [🇩🇪 Deutsch (German)](#german) | [🇯🇵 日本語 (Japanese)](#japanese) | [📈 Star History](#star-history)
- </div>
- ---
- ### 🎬 Swarm Director in Action
- <div align="center">
- <img src="./vibes-swarm-demo.gif" alt="VibesPlug Swarm Demo" width="95%" style="border-radius: 12px; border: 1px solid rgba(255,255,255,0.1); box-shadow: 0 12px 36px rgba(0,0,0,0.5);" />
- </div>
- <br />
- ### ⚡ Universal 1-Line Installers (Zero-Config Global Setup)
- ```bash
- # 🐧 Linux / 🍏 macOS / 🪟 WSL (Bash / Zsh):
- curl -fsSL https://raw.githubusercontent.com/roedyrustam/vibes-plug/main/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 44 on GitHub
- # 🪟 Windows (PowerShell):
- irm https://raw.githubusercontent.com/roedyrustam/vibes-plug/main/install.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 47 on GitHub
- # 📦 Or via NPX / GitHub:
- npx vibes-plug init
- npx github:roedyrustam/vibes-plug --all
- ```
- ---
- ## 💥 Why VibesPlug? (The Paradigm Shift)
- | Metric / Capability | Vanilla Vibe Coding (Prompts) | Static IDE Rules (.cursorrules) | ⚡ VibesPlug Pro (Swarm) |
- | :--- | :--- | :--- | :--- |
- | **Agent Coordination** | ❌ 1 confused LLM doing everything | ⚠️ Static rules without orchestration | 🤖 **Swarm Director & 178 Specialists** |
- | **Full-Stack Lifecycle** | ❌ Fragmented & prone to regressions | ⚠️ Ad-hoc guidance | 🚀 **Autonomous 8-Phase Zero-To-Prod** |
- | **Self-Evolving Skills** | ❌ Stale knowledge | ❌ Manual rule authoring | 🧬 **`vibes evolve` & Multi-Platform Codex Generator** |
- | **CI Resilience** | ❌ Breaks on node version mismatches | ❌ No auto-remediation | 🩺 **Autonomous CI Auto-Healer (`vibes ci:heal`)** |
- | **Tech Stack** | ⚠️ Often outputs legacy 2022 patterns | ⚠️ Stale prompts | ⚡ **React 19, Next 15, Tailwind v4, Bun 1.2+** |
- | **Code Gardening & QA** | ❌ Hallucinated dead code & slop | ❌ No automated debt check | 🧹 **Zero-Tech-Debt Auditor & Red Teaming** |
- | **Sovereign Anti-Slop** | ❌ Lazy stubs, placeholder stubs, & fluff | ⚠️ Untested static prompts | 🛡️ **Zero-Tolerance Anti-Slop Engine & Scanner** |
- | **Payment & Micro-Economy** | ❌ Incomplete integrations | ⚠️ Basic docs | 💳 **DOKU Checkout, SNAP BI, Stripe, M2M Agent Wallets** |
- | **Visual Studio Cockpit** | ❌ None | ❌ None | 🎨 **Interactive 2D Graph (2,435 edges) & Swarm Blackboard** |
- | **Native MCP Server** | ❌ None | ❌ None | 🔌 **Stdio & SSE MCP v1.x Server with 42 Frontier Tools & Profile Masking** |
- | **Distribution** | ⚠️ Complex global installs | ⚠️ Manual copying | 📦 **Single-Binary (`vibes package:binary`) & 1-Line Shell Installers** |
- | **IDE Portability** | ❌ Locked to one interface | ⚠️ Cursor only | 🌐 **Antigravity, Cursor, Claude Code, Codex, Windsurf, Trae** |
- ---
- ## 🧩 The 178-Skill Arsenal (Category Breakdown)
- VibesPlug Pro is powered by **178 specialized AI domain skills**, coordinated autonomously by the master ideation orchestrators (`brainstorming` and `zero-to-prod-orchestrator`).
- > 📖 **Browse Complete Directory**: View the comprehensive [178-Skill Interactive Catalog (`CATALOG.md`)](CATALOG.md) or explore the interactive live showcase at [**vibes-plug.vercel.app**](https://vibes-plug.vercel.app/) or generate machine-readable indexes anytime via `vibes docs markdown` or `vibes docs json`.
- | 🎨 **Frontend & Mobile UI/UX** (39 Skills) | ⚙️ **Backend, Systems & API Design** (28 Skills) |
- | :--- | :--- |
- | `angular-expert` <br> `apple-ecosystem-expert` <br> `astro-framework-expert` <br> `blockchain-web3-expert` <br> `browser-extension-mv3-pro` <br> `design-system-architect` <br> `desktop-electron-expert` <br> `ephemeral-generative-ui-architect` <br> `flutter-dart-expert` <br> `form-validation-expert` <br> `global-a11y-i18n-expert` <br> `glsl-shader-expert` <br> `hig` <br> `htmx-hypermedia-expert` <br> `micro-frontend-architect` <br> `mobile-expo-expert` <br> `modern-css-native-expert` <br> `mpa-orchestrator` <br> `multimodal-spatial-video-cloner` <br> `nextjs-app-router-expert` <br> `performance-web-vitals` <br> `pwa-offline-first-expert` <br> `reactive-sync-engine-expert` <br> `rich-text-editor-expert` <br> `screenshot-to-code-expert` <br> `senior-frontend` <br> `solidjs-expert` <br> `spa-orchestrator` <br> `state-management-expert` <br> `svelte-sveltekit-expert` <br> `svg-animation-motion-expert` <br> `tailwind-expert` <br> `tanstack-query-expert` <br> `tauri-expert` <br> `ui-ux-pro-max` <br> `visual-ui-auditor` <br> `vue-frontend-expert` <br> `web-3d-graphics-expert` <br> `webxr-ar-vr-expert` | `api-design-expert` <br> `api-gateway-proxy-expert` <br> `async-queue-temporal-expert` <br> `autonomous-api-drift-healer` <br> `bun-runtime-expert` <br> `cloudflare-workers-expert` <br> `composable-mach-architect` <br> `cron-scheduler-expert` <br> `domain-driven-design-expert` <br> `ephemeral-wasm-sandbox-executor` <br> `event-driven-architect` <br> `fullstack-expert` <br> `go-programming-expert` <br> `graphql-apollo-expert` <br> `js-backend-expert` <br> `legacy-code-translator` <br> `living-codebase-ast-graph` <br> `monorepo-architect` <br> `mvc-expert` <br> `openapi-swagger-codegen-expert` <br> `python-programming-expert` <br> `rust-programming-expert` <br> `scalability-clean-code` <br> `spec-driven-development-expert` <br> `structured-output-contracts` <br> `typescript-expert` <br> `wasm-edge-computing-expert` <br> `web-game-engine-expert` |
- | 🤖 **Frontier AI, LLM, MCP & Multi-Agent** (34 Skills) | 💸 **SaaS, FinTech, E-Commerce & Growth** (17 Skills) |
- | :--- | :--- |
- | `a2a-agent-protocol-expert` <br> `adaptive-model-cascade` <br> `affective-computing-emotion-ai` <br> `agentic-coding-workflow-expert` <br> `agentic-memory-architect` <br> `agentic-micro-economy-architect` <br> `ai-llm-integration-expert` <br> `ai-media-generation-expert` <br> `ai-prompt-engineering-expert` <br> `ai-safety-governance-expert` <br> `computer-use-os-agent-expert` <br> `context-window-engineer` <br> `deep-research-analyst` <br> `doku-mcp-server` <br> `durable-agent-execution-expert` <br> `frontier-ai-models-expert` <br> `gemini-agent-booster` <br> `graph-rag-knowledge-expert` <br> `kv-cache-prefix-optimizer` <br> `llm-finops-router` <br> `llm-observability-expert` <br> `local-slm-edge-ai-expert` <br> `mcp-server-architect` <br> `multi-agent-orchestration` <br> `parallel-tool-orchestrator` <br> `pydantic-ai-expert` <br> `speculative-multi-draft-synthesizer` <br> `synthetic-data-finetuning-expert` <br> `test-time-compute-optimizer` <br> `thinking-budget-orchestrator` <br> `vector-db-rag-expert` <br> `vercel-ai-sdk-expert` <br> `voice-ai-realtime-agent` <br> `xerj-search-expert` | `agentic-m2m-settlement` <br> `app-promo-media-expert` <br> `chatbot-messaging-expert` <br> `data-telemetry-expert` <br> `doku-payment-gateway` <br> `double-entry-ledger-fintech-expert` <br> `ecommerce-expert` <br> `email-notification-expert` <br> `feature-flag-analytics-expert` <br> `headless-cms-expert` <br> `n8n-automation-expert` <br> `payment-gateway-expert` <br> `saas-architect` <br> `saas-billing` <br> `saas-multi-tenant` <br> `seo` <br> `wordpress-headless-expert` |
- | 🛡️ **Testing, Security, Anti-Slop & Reverse Engineering** (31 Skills) | 🚀 **Data, Media, Lifecycle & DevOps Orchestration** (27 Skills) |
- | :--- | :--- |
- | `accessibility-testing-expert` <br> `ai-code-review-autonomous` <br> `anti-slop` <br> `app-analyzer-optimizer` <br> `authentication-identity-expert` <br> `autonomous-red-teamer` <br> `autonomous-tdd-debugger` <br> `biome-linter-formatter-expert` <br> `coderabbit` <br> `compliance-gdpr-privacy-expert` <br> `e2e-testing-expert` <br> `error-resilience-expert` <br> `fga-rebac-authorization-expert` <br> `firebase-security-expert` <br> `formal-spec-z3-verifier` <br> `logging-error-tracking-expert` <br> `mcp-sampling-critic` <br> `passkeys-webauthn-identity-expert` <br> `post-quantum-crypto-migrator` <br> `prompt-injection-firewall` <br> `property-mutation-testing-expert` <br> `rate-limit-abuse-prevention` <br> `rea-analysis-optimization` <br> `rea-changelog-update` <br> `rea-ci-tests-audit` <br> `rea-tool-design` <br> `reverse-engineer-anything` <br> `sbom-supply-chain-security-expert` <br> `supabase-security-expert` <br> `zero-tech-debt-auditor` <br> `zero-trust-secret-vault` | `brainstorming` <br> `browser-automation-expert` <br> `ci-cd-devops-architect` <br> `cloud-hosting-expert` <br> `data-pipeline-etl-expert` <br> `data-visualization-expert` <br> `database-orm-expert` <br> `dependency-upgrade-migrator` <br> `docker-container-expert` <br> `documentation-site-expert` <br> `file-upload-media-expert` <br> `geospatial-maps-expert` <br> `github-actions-expert` <br> `kubernetes-gitops-platform-expert` <br> `olap-columnar-analytics-expert` <br> `pdf-document-generation-expert` <br> `prd-architect` <br> `proactive-background-watcher` <br> `production-ready-hardener` <br> `realtime-collaboration-expert` <br> `search-engine-expert` <br> `self-healing-cloud-orchestrator` <br> `session-memory-manager` <br> `sse-websocket-streaming-expert` <br> `web-scraper` <br> `website-design-cloner` <br> `zero-to-prod-orchestrator` |
- ---
- ## 🤖 Native Specialist Subagents (Antigravity & Swarm Topologies)
- VibesPlug bundles 9 dedicated specialist subagents residing in `agents/`, ready to execute complex cross-domain tasks autonomously via Fan-Out / Fan-In and Critic-Validator loops:
- | Specialist Subagent | File | Core Mission & Bound Skills |
- | :--- | :--- | :--- |
- | **`swarm-architect`** | [`agents/swarm-architect.md`](agents/swarm-architect.md) | **Discovery, PRD & ERD**: High-level system architecture, PostgreSQL DDL schemas, and DDD bounded contexts. |
- | **`fullstack-craftsman`** | [`agents/fullstack-craftsman.md`](agents/fullstack-craftsman.md) | **Production Fullstack**: React 19, Next.js 15, Tailwind v4, Hono/Bun/Node backend, and Prisma/Drizzle ORM. |
- | **`quality-guardian`** | [`agents/quality-guardian.md`](agents/quality-guardian.md) | **Zero-Tolerance Quality Gate**: TDD self-healing, Playwright E2E, adversarial security fuzzing, and Anti-Slop audit. |
- | **`fintech-payment-sentinel`** | [`agents/fintech-payment-sentinel.md`](agents/fintech-payment-sentinel.md) | **FinTech & Payments**: DOKU Checkout, SNAP BI Direct API, HMAC-SHA512 webhook security, and atomic idempotency. |
- | **`ai-mcp-engineer`** | [`agents/ai-mcp-engineer.md`](agents/ai-mcp-engineer.md) | **AI & MCP Protocols**: Model Context Protocol (MCP v1.x) servers, A2A agent interoperability, durable workflows, and Gemini booster. |
- | **`cloud-devops-sre`** | [`agents/cloud-devops-sre.md`](agents/cloud-devops-sre.md) | **Cloud, DevOps & SRE**: Kubernetes GitOps (ArgoCD/Cilium), Docker hardening, CycloneDX SBOM supply chain security, and Zero-Trust secrets. |
- | **`data-rag-architect`** | [`agents/data-rag-architect.md`](agents/data-rag-architect.md) | **Data, OLAP & RAG**: ClickHouse/DuckDB OLAP analytics, Linear-style reactive sync engines, hybrid Vector/Graph RAG, and OpenFGA/SpiceDB ReBAC. |
- | **`mobile-spatial-craftsman`** | [`agents/mobile-spatial-craftsman.md`](agents/mobile-spatial-craftsman.md) | **Mobile, Desktop & Spatial**: React Native/Expo, Flutter, Tauri v2, 3D WebGPU/Three.js, TSL/WGSL shaders, and WebXR spatial computing. |
- | **`reverse-security-auditor`** | [`agents/reverse-security-auditor.md`](agents/reverse-security-auditor.md) | **Reverse Engineering & Binary Audit**: REA/Ghidra/LLDB binary decompilation, Electron/firmware triage, `Evidence` spans, and Z3/SBOM verification. |
- > 💡 **Custom Agent Generation**: Create tailored subagents for any project across Antigravity (`.agents/agents/`), Cursor (`.cursor/rules/`), and Claude Code (`.claude/rules/`) using `vibes create-agent --name <name> --skills <skills>`.
- ---
- ## 🧠 Superintelligence Engineering Substrate (P1 – P7 Engines)
- VibesPlug Pro embeds 7 foundational engineering engines that give AI models sub-millisecond AST precision, deterministic caching, in-memory sandboxing, and mathematical theorem proving:
- | Engine | Command | Description |
- | :--- | :--- | :--- |
- | **P1: Prompt-Cache Compiler** | `vibes compile-cache` | Compiles deterministic prefix instruction set into `.cache-prefix.json` (>1024 tokens) to lock KV-Cache reuse, slashing billing by 75–90% and accelerating TTFT by 10x. |
- | **P2: In-Memory DB Sandbox** | `vibes db:eval [file\|--sql]` | In-memory SQLite DDL/migration simulation engine to audit RLS policies, catch missing FK indexes, and prevent destructive `DROP TABLE/COLUMN` before production. |
- | **P3: AST Subgraph Engine** | `vibes ast <action> [args]` | In-memory AST symbol inspection (`symbols`), targeted function isolation (`inspect`), and dependency blast radius calculation without token bloat. |
- | **P4: Speculative PRM Arbiter**| `vibes arbitrate [draftA] [draftB]`| Heuristic Process Reward Model (PRM) evaluator scoring competing code drafts across Type Safety, Anti-Slop, Error Resilience, and Algorithmic Complexity. |
- | **P5: Invariant Verifier (SMT)**| `vibes verify-invariants [file]` | Proves state machine transitions (SaaS billing, auth, orders), detects unreachable states and deadlocks, and generates SMT-LIB 2.0 specifications for Z3/CVC5. |
- | **P6: Ephemeral WASM/VM Sandbox**| `vibes sandbox "<code\|file>"` | Ultra-low latency (<2ms) isolated micro-sandbox evaluating AI code with wall-clock timeout kill and zero host access. |
- | **P7: Universal SaaT Dispatcher** | `vibes skill exec <skill> <act>` | Turns all 178 declarative skills & 1,081 code blueprints into deterministic executable tools across 8 domain adapters, per-skill AST/Regex guardrails (`rules`/`verify`), contextual file/intent auto-routing (`skill="auto"`), language-segmented loading (`read --lang=en\|id` for 45–55% token savings), 9 multi-skill chains (`vibes skill chain`), and subagent micro-slices (`.skill-slices.json`). |
- | **P8: Schema Drift Healer** | `vibes drift:heal [sql] [ts]` | Detects structural drift between PostgreSQL DDL schemas and TypeScript/Zod/OpenAPI contracts (missing columns, nullability, RLS) and synthesizes a zero-drift healing patch. |
- ### ⚡ Executable Skill Engine & Contextual Auto-Router (`skill-rules-engine`)
- Every skill in VibesPlug is backed by deterministic execution and active guardrails rather than passive prose:
- - **Per-Skill AST & Regex Guardrails (`rules` / `verify`)**: Enforces framework-specific invariants (e.g., Next.js 15 async `params`, React 19 Compiler & `useEffect` fetch bans, Tailwind v4 `@theme` CSS-first tokens, Vue 3.5 `<script setup>` & Pinia, Svelte 5 Runes, Rust `// SAFETY:` comments & `.unwrap()` bans, Go error handling, Python Pydantic v2 `.model_dump()`, PostgreSQL RLS, DOKU/SNAP BI constant-time `timingSafeEqual` HMAC & integer minor-unit currency, Docker `:latest` tag bans, and MCP stdio `stdout` protection).
- - **Contextual File & Intent Auto-Router (`vibes skill exec auto verify --file=<path>`)**: Automatically matches file extensions (`.rs`, `.go`, `.py`, `.vue`, `.svelte`, `.tsx`, `Dockerfile`, `.sql`, `.wgsl`) and import signatures to the appropriate domain skills and executes their guardrails inside `vibes_verify_gate`.
- - **Language-Segmented Skill Loading (`--lang=en|id`)**: Loads only the English or Bahasa Indonesia section of any `SKILL.md` (with optional boilerplate stripping), cutting context window consumption by **45–55%** with zero loss of technical blueprints.
- - **Smart AST-Aware Blueprint Slicing**: Extracts complete function/component signatures and indexes all 1,081 code blocks by Markdown section headings (`--query=<keyword>`).
- ### 🔬 Reverse Engineering & Binary Analysis (REA Suite)
- VibesPlug integrates the 5-skill **REA (Reverse Engineer Anything)** ecosystem for evidence-backed binary, firmware, managed/Electron, and runtime inspection:
- - `reverse-engineer-anything` — Decompile & analyze native binaries (Ghidra/LLDB), Electron/JS bundles, APK/firmware images, and capture live web `AgentEnv` bundles.
- - `rea-tool-design` — Contract-first CLI/MCP tool boundary & `Evidence` span design.
- - `rea-analysis-optimization` — Bounded cache keys, latency/CPU/memory profiling, and agent context optimization for binary analysis.
- - `rea-ci-tests-audit` — Evidence-backed CI/test-suite drift, fixture, and false-pass auditing.
- - `rea-changelog-update` — Pinned Git history contributor attribution & Release Please synchronization.
- ---
- ## 🔌 Native Model Context Protocol (MCP v1.x) Server
- VibesPlug provides a native standalone MCP server running over standard I/O (JSON-RPC 2.0) and Server-Sent Events (SSE). Connect it to Claude Desktop, Cursor, Antigravity, or Codex via `mcp_config.json`:
- ```bash
- # Start the MCP server manually or via vibes CLI
- vibes mcp
- # or npm run mcp
- ```
- ### Registered Frontier MCP Tools:
- 1. `vibes_ast_query` — Query AST symbols, inspect function bodies, or compute refactoring blast radius.
- 2. `vibes_eval_sql` — Evaluate DDL schemas and audit PostgreSQL RLS policies in an in-memory sandbox.
- 3. `vibes_arbitrate_code` — Score and arbitrate competing code solutions via Process Reward Model (PRM).
- 4. `vibes_verify_invariants` — Formally prove state machine invariants and generate SMT-LIB 2.0 formulas.
- 5. `vibes_get_skill` — Fetch instructions and contracts from any of the 178 specialized skills (supports `mode: "compact"` micro-slices and `lang: "en"|"id"` language-segmented loading for 45–85% token savings).
- 6. `vibes_list_skills` — Discover all 178 skills with domain categories, summaries, and tags.
- 7. `vibes_inject_skill` — Directly inject one or more skills into `.agents/skills/<name>`.
- 8. `vibes_compile_cache` — Compile and lock deterministic prompt prefix for KV-Cache optimization.
- 9. `vibes_memory` — Read and write cross-session architectural decisions and emit compact checkpoints.
- 10. `vibes_swarm` — Generate multi-agent execution plans (Fan-Out/Fan-In, Saga, Critic-Validator).
- 11. `vibes_eval_sandbox` — Safely execute and verify ephemeral JavaScript/TypeScript code snippets in an isolated micro-sandbox.
- 12. `vibes_critic_validate` — Autonomous Critic-in-the-Loop review gate verifying code quality and AST invariants.
- 13. `vibes_visual_audit` — Multimodal visual UI compliance audit for Anti-Slop Pillar 7 rubrics.
- 14. `vibes_swarm_dispatch` — Concurrently dispatch parallel multi-agent workers with automated skill binding, sandbox verification, and Critic-in-the-Loop auditing.
- 15. `vibes_finops_report` — Query local FinOps token consumption metrics and estimated prompt caching (KV-Cache) cost savings.
- 16. `vibes_graph_query` — Query indexed AST symbols and dependency blast radius in `.agents/graph/symbol_graph.json`.
- 17. `vibes_graph_search` — High-precision local Hybrid GraphRAG search combining BM25, TF-IDF vector, and AST boost.
- 18. `vibes_pr_review` — Autonomous GitHub PR review bot auditing git diffs against Sovereign Anti-Slop rubrics.
- 19. `vibes_self_heal` — Autonomous test runner and self-healing failure diagnoser with proposed patch generation.
- 20. `vibes_registry_search` — Search decentralized community skills registry by keyword or category.
- 21. `vibes_registry_install` — Install gold-standard verified skills directly from registry into `.agents/skills/`.
- 22. `vibes_bridge_status` — Inspect Universal Cross-IDE Bridge status across Antigravity, Claude, Cursor, and Codex.
- 23. `vibes_bridge_sync` — Synchronize rules, skills, and context bundles across all detected AI platforms.
- 24. `vibes_verify_gate` — Atomic in-memory pre-commit verification gate evaluating candidate code before writing to disk.
- 25. `vibes_swarm_bus` — Query active swarms, telemetry events, or emit inter-agent broadcast coordination signals.
- 26. `vibes_package_extension` — Build zero-dependency `.vsix` companion extension archive for VS Code and Cursor.
- 27. `vibes_learn_skill` — Synthesize complete gold-standard bilingual skills from raw project codebases or repository patterns.
- 28. `vibes_skill_dispatch` — Universal Skill-as-a-Tool (SaaT) Dispatcher executing any of the 178 skills or `skill: "auto"` (`blueprint`, `slice`, `extract-code`, `rules`, `read`, `audit`, `eval`, `verify`, `generate`, `fuzz`, `chain`).
- 29. `vibes_skill_chain` — Execute multi-skill DAG workflows and composite pipelines (`saas-launch-gate`, `ai-agent-hardening`, `fintech-settlement-gate`, `zero-debt-release`).
- 30. `vibes_batch` — Execute multiple MCP tools concurrently in a single JSON-RPC round-trip (`Promise.allSettled`).
- 31. `vibes_run_benchmark` — Run performance, KV-Cache, and latency benchmark suite across all engines.
- 32. `vibes_git_hooks` — Install, inspect, or remove Sovereign Guard Git pre-commit hooks.
- 33. `vibes_optimize_budget` — Compute dynamic token budget allocations and context window slices.
- 34. `vibes_skill_drift` — Audit all 178 skills for structural drift, frontmatter compliance, and health scores (`100/100`).
- 35. `vibes_terminal_monitor` — Real-time system health, memory, and swarm telemetry monitor.
- 36. `vibes_speculative_consensus` — Parallel multi-draft speculative execution with AST-aware consensus arbitration.
- 37. `vibes_detect_stack` — Auto-detect project tech stack (`package.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`) and recommend matching skills.
- 38. `vibes_tool_profile` — Dynamically switch active MCP tool exposure profiles (`full`, `core`, `frontend`, `backend`, `security`, `ai-mcp`) to cut schema token overhead by up to 75%.
- ### ⚡ Vibes Studio Cockpit & Remote MCP (Visual Dashboard)
- Vibes-Plug features a zero-dependency local web cockpit with interactive panels, topological DAG workflow designer, and Server-Sent Events (SSE) remote transport:
- ```bash
- # Launch visual web cockpit (opens http://localhost:3888) with 11 interactive tabs & Remote MCP
- vibes studio
- # Universal Cross-IDE State Bridge: synchronize rules & 178 skills across Antigravity, Claude, Cursor, Codex
- vibes bridge [status|sync|bundle]
- # Autonomous Skill Synthesizer: synthesize gold-standard bilingual skills from raw codebase patterns
- vibes learn <skill-name> [--repo <url>] [--category <cat>]
- # Pre-Disk Verification Gate: validate candidate code in-memory (AST, Anti-Slop, security, sandbox)
- vibes verify-gate <code|file>
- # Real-Time Swarm Concurrency Bus: observe active agent swarms and broadcast coordination events
- vibes swarm:bus [status|events|broadcast]
- # Local Hybrid GraphRAG Search: search codebase symbols via BM25 + Vector Cosine + AST connectivity
- vibes graph:search "<query>" [--top-k 5]
- # Zero-Dependency VSIX Packager: build companion extension archive for VS Code & Cursor in <50ms
- vibes package:vscode
- # Interactive Project Scaffolding Wizard (custom stack & tailored skills)
- vibes wizard
- # Execute and verify code in Ephemeral Micro-Sandbox (<2ms execution, timeout protection)
- vibes sandbox "<code|file>" [--timeout <ms>]
- # Dispatch parallel multi-agent workers concurrently with automated skill binding & synthesis
- vibes swarm:dispatch "<task>" [--concurrency 3]
- # Track token economics, KV-cache efficiency, and estimated financial savings
- vibes finops status
- # Run Critic-in-the-Loop code / PRD audit
- vibes critic <file>
- # Run Multimodal Visual UI audit (Pillar 7 Anti-Slop)
- vibes visual-audit <file|code>
- # Or run standalone Remote MCP Server for Claude Desktop, Cursor, or remote agents
- vibes mcp --transport sse --port 3333
- # Autonomous Skill & Codex Evolver: evolve skills & multi-platform codex rules
- vibes evolve <skill-name> [--category <cat>] [--from-repo <dir>]
- # Autonomous CI Auto-Healer: diagnose stack traces and apply safe remediation
- vibes ci:heal [command|logPath] [--dry-run|--apply]
- # Standalone Single-Binary Compiler: package zero-dependency executable
- vibes package:binary [--platform <os>] [--arch <arch>]
- # Run the complete Sovereign Quality & Anti-Slop Guard (648 files + 51 tests)
- vibes guard
- ```
- ### 💻 Native VSCode & Cursor IDE Companion Extension
- Vibes-Plug includes a native extension package in [`extensions/vscode/`](extensions/vscode/):
- - **Status Bar Indicator**: Live status displaying `$(zap) VibesPlug: 178 Skills Active`.
- - **Command Palette & Context Menus**: 11 native commands including Studio Cockpit, Scaffolding Wizard, Sovereign Guard, Active Document Critic, Token FinOps Report, Pre-Disk Gate, and Swarm Dispatcher.
- - **Packaging & Installation**: Build zero-dependency `.vsix` anytime via `vibes package:vscode` or `npm run package:vscode` in <50ms and install directly into VSCode, Cursor, or Windsurf.
- ---
- <a name="english"></a>
- ## 🇬🇧 English Version
- Welcome to **VibesPlug Pro**. Unlike generic prompt libraries, VibesPlug acts as a **Swarm Director**, orchestrating 178 specialized AI subagents. It is strictly engineered to extract maximum reasoning capabilities from ALL Late-2026 Frontier Models across all IDE tiers (xAI Grok 4.7 High Fast / Grok 4.6, Cursor Composer 2.5 Fast, Google Gemini 4 Argon Medium / Gemini 4 Pro / Project Astra, OpenAI GPT-5.6 Sol Medium / GPT-5 / o3, Anthropic Claude Opus 5.5 Medium / Claude Sonnet 5.5 High / Claude Fable 5.1, Muse Wonder High, and DeepSeek-R1 / Pro / V3) with an automated **Availability Fallback Invariant** (gracefully routing unprovisioned Gemini 4 tasks to Gemini 3.8 Flash, and Claude Opus 5.5 to Claude Opus 4.6 without workflow interruption).
- ### 🚀 Universal Installation Guide (All IDEs & LLMs)
- *Supported Platforms: Google Antigravity (AGY), Claude Code, Cursor IDE, OpenAI Codex CLI, Windsurf, Trae, VSCode (Cline / Roo Code), Kimi, and Kiro.*
- #### Method 1: CLI (NPM Installation - Recommended)
- The CLI automatically scaffolds the required master rules for your specific IDE.
- ```bash
- npm i -g vibes-plug
- vibes-plug init
- ```
- #### Method 2: GitHub Installation (Direct via NPX / Git Clone - Always Latest)
- You can install or execute VibesPlug directly from the GitHub repository using any of the following methods:
- **Option A: Instant Execution via NPX (No Local Clone Required)**
- Run the installer directly from GitHub without cloning the repository:
- ```bash
- # Run installer for all detected IDEs & platforms
- npx github:roedyrustam/vibes-plug --all
- # Or install globally from GitHub
- npm install -g git+https://github.com/roedyrustam/vibes-plug.git
- vibes-plug --all
- ```
- **Option B: Clone & Universal Multi-Platform Installer**
- Clone the repository and run the built-in installer to auto-configure all your tools:
- ```bash
- git clone https://github.com/roedyrustam/vibes-plug.git
- cd vibes-plug
- npm install
- # Run installer across all detected platforms:
- npm run install-all
- # (or node scripts/install.js --all)
- ```
- **Option C: Direct Git Clone for Google Antigravity (AGY)**
- Google Antigravity natively loads plugins from `~/.gemini/config/plugins/`. Clone directly into your Antigravity plugins directory:
- ```bash
- # macOS & Linux:
- git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
- # Windows (PowerShell):
- git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
- ```
- **Option D: Targeted Per-Project Installation**
- From your cloned `vibes-plug` directory, inject rules and skills into any specific project:
- ```bash
- # For Claude Code (global + project):
- node scripts/install.js --claude --project /path/to/my-project
- # For Cursor IDE (project-specific):
- node scripts/install.js --cursor --project /path/to/my-project
- # For OpenAI Codex:
- node scripts/install.js --codex --project /path/to/my-project
- # For Windsurf, Trae, or VSCode (Cline):
- cp .windsurfrules /path/to/my-project/
- cp .traerules /path/to/my-project/
- cp .clinerules /path/to/my-project/
- ```
- **Option E: Staying Updated via GitHub**
- To pull the latest skills and superintelligence engine updates:
- ```bash
- cd ~/.gemini/config/plugins/vibes-plug # (or your cloned repository folder)
- git pull origin main
- npm test
- ```
- #### Method 3: Platform-Specific Manual Configuration (ZIP Archive / Drop-in)
- If you download the `.zip` archive, extract it and configure your IDE as follows:
- - **Google Antigravity (AGY):** Move the folder to `~/.gemini/config/plugins/vibes-plug`.
- - **Claude Code:** Run `vibes-plug --claude` or copy `CLAUDE.md` and `.claude/rules/` to your project root.
- - **Cursor IDE:** Run `vibes-plug --cursor --project .` or copy `.cursorrules` and `.cursor/rules/` to your project root.
- - **OpenAI Codex CLI:** Run `vibes-plug --codex` or copy `CODEX.md` and `.codex/rules/` to your project root.
- - **Windsurf IDE:** Copy `.windsurfrules` to your project root.
- - **Trae IDE:** Copy `.traerules` to your project root.
- - **VSCode (Cline / Roo):** Copy `.clinerules` to your project root.
- - **Kimi / Kiro:** Copy `.kimirules` or `.kirorules` to your project root.
- ### 💻 How to Use the Plugin & CLI
- **1. Zero-Friction Prompting (In-IDE)**
- You do *not* need to tag skills manually. Just open your IDE's AI Chat and type your vision:
- > *"Build me a multi-tenant SaaS platform with DOKU QRIS and Stripe billing, a Next.js 15 App Router frontend with Tailwind v4, and role-based access control with PostgreSQL RLS."*
- The Swarm Director automatically intercepts the request, runs Step 1 Context Discovery, generates `PRD.md` and `ERD.md`, and orchestrates the cooperating skills through the 8-Phase Zero-To-Prod workflow.
- **2. Comprehensive CLI Toolkit Reference**
- ```bash
- # Workspace & Skill Management
- vibes init <project-name> # Scaffolds 8-Phase Zero-To-Prod structure (README, PROGRESS, BLUEPRINT, PRD)
- vibes bootstrap <type> <name> # Super-scaffolds project + skills (saas | ecommerce | mobile | api | fullstack | spec-api)
- vibes wizard # Interactive CLI wizard to scaffold project stack & custom skill bundle
- vibes sync # Verifies & synchronizes master trigger across all IDE rules
- vibes ui # Interactive terminal TUI to visually select & install skills
- vibes studio [--port <n>] # Launches local web Studio Cockpit dashboard (visual 178-skill explorer)
- vibes list [filter] # Lists all 178 skills (optional: keyword filter)
- vibes search <query> # Searches 178 skills with relevance ranking
- vibes add <skill-name> # Injects a skill from registry into local project (.agents/skills)
- vibes remove <skill-name> # Removes an installed skill from local project
- vibes skill info <skill-name> # Shows metadata, description, and orchestration connections
- vibes skill exec <s-name> <act> # Universal SaaT Dispatcher (blueprint|slice|extract-code|rules|read|audit|eval|verify|generate|fuzz)
- vibes skill exec auto verify # Contextual Auto-Router: matches file/imports (--file=<path>) & runs skill guardrails
- vibes skill chain <recipe> # Executes multi-skill pipelines (saas-launch-gate, ai-agent-hardening, fintech-settlement-gate)
- vibes skill compile-slices # Compiles 93%-compressed (<350 token) micro-slices into .skill-slices.json
- vibes skill matrix # Displays domain capability & executable code-blueprint matrix across all skills
- vibes recipe list # Lists curated skill bundles (ai-stack, fullstack-pro, fintech-core, spec-driven-api)
- vibes recipe apply <name> # Applies a curated skill recipe to current workspace
- vibes docs [markdown|json] # Exports full 178-skill catalog to terminal, CATALOG.md, or CATALOG.json
- vibes create-skill <name> # Scaffolds a new skill following the standard specification
- vibes create-agent --name <n> # Generates a custom subagent across Antigravity, Cursor, and Claude
- vibes create-mcp <server-name> # Scaffolds a new Model Context Protocol server
- # Superintelligence Engines & Verification
- vibes guard # Runs full Sovereign Guard CI pipeline (P1–P5 + Anti-Slop + Swarm + Memory)
- vibes compile-cache # Compiles deterministic KV-Cache prefix (>1024 tokens) for 75-90% token savings
- vibes db:eval [file|--sql] # Simulates & audits SQL DDL migrations in-memory for RLS and schema safety
- vibes ast <action> [args] # Queries AST symbols (symbols), inspects bodies (inspect), or computes blast-radius
- vibes arbitrate [fileA] [fileB] # Scores & arbitrates competing code drafts using Process Reward Models (PRM)
- vibes verify-invariants [file] # Formally proves state machine invariants & generates SMT-LIB 2.0 specs
- vibes swarm "<task>" # Executes Autonomous Swarm Director (Fan-Out/Fan-In, Saga, Critic-Validator)
- vibes memory <record|query|cp> # Local episodic project memory & ultra-compact checkpointing (<150 tokens)
- vibes mcp # Starts native stdio Model Context Protocol (MCP v1.x) server
- # Quality Gates & Diagnostics
- vibes anti-slop # Runs Sovereign Anti-Slop scanner (detects placeholders & empty stubs)
- vibes anti-slop --strict # Strict CI mode: fails build on any warning
- vibes anti-slop --fix # Automatically removes syntax-narrating redundant comments
- vibes audit # Runs zero-tech-debt-auditor for dead code, magic numbers & strict types
- vibes critic <file> # Runs deep Critic-in-the-Loop audit on code/PRD before commit
- vibes visual-audit <file> # Audits UI code or screenshot image against Pillar 7 & generates vision rubric
- vibes doctor # Checks environment health & IDE integration integrity
- vibes hooks install # Installs pre-commit Git hook enforcing zero-slop gates
- ```
- ### 🛡️ Reusable GitHub Action (CI/CD Quality Gate)
- Integrate the Sovereign Anti-Slop Gate and Critic-Validator directly into any repository:
- ```yaml
- name: Sovereign Guard Gate
- on: [push, pull_request]
- jobs:
- guard:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v4
- - uses: roedyrustam/vibes-plug/.github/actions/vibes-guard@main
- with:
- strict: 'true'
- ```
- ---
- <a name="bahasa-indonesia"></a>
- ## 🇮🇩 Versi Bahasa Indonesia
- Selamat datang di **VibesPlug Pro**. Berbeda dengan kumpulan prompt biasa, VibesPlug bertindak sebagai **Swarm Director (Sutradara Utama)** yang mengorkestrasi 178 sub-agen AI spesialis. Sistem ini direkayasa secara ketat untuk mengekstrak penalaran maksimum dari SEMUA Model Frontier Terkini Akhir-2026 di seluruh tier IDE (xAI Grok 4.7 High Fast / Grok 4.6, Cursor Composer 2.5 Fast, Google Gemini 4 Argon Medium / Gemini 4 Pro / Project Astra, OpenAI GPT-5.6 Sol Medium / GPT-5 / o3, Anthropic Claude Opus 5.5 Medium / Claude Sonnet 5.5 High / Claude Fable 5.1, Muse Wonder High, dan DeepSeek-R1 / Pro / V3) dengan **Invarian Fallback Ketersediaan** otomatis (mengalihkan tugas Gemini 4 yang belum tersedia/mengalami batas kuota ke Gemini 3.8 Flash, dan Claude Opus 5.5 ke Claude Opus 4.6 tanpa menghentikan alur kerja).
- ### 🚀 Panduan Instalasi Universal (Semua IDE & LLM)
- *Platform Didukung: Google Antigravity (AGY), Claude Code, Cursor IDE, OpenAI Codex CLI, Windsurf, Trae, VSCode (Cline / Roo Code), Kimi, dan Kiro.*
- #### Metode 1: CLI (Instalasi NPM - Rekomendasi Instan)
- CLI akan otomatis mengonfigurasi aturan utama (*master rules*) sesuai dengan IDE yang Anda gunakan.
- ```bash
- npm i -g vibes-plug
- vibes-plug init
- ```
- #### Metode 2: Instalasi via GitHub (Direct NPX / Git Clone - Selalu Versi Terbaru)
- Anda dapat memasang atau mengeksekusi VibesPlug langsung dari repositori GitHub dengan beberapa opsi berikut:
- **Opsi A: Eksekusi Langsung via NPX (Tanpa Perlu Clone)**
- Jalankan skrip installer langsung dari repositori GitHub tanpa meng-clone repo ke komputer Anda:
- ```bash
- # Jalankan installer untuk seluruh platform IDE yang terdeteksi
- npx github:roedyrustam/vibes-plug --all
- # Atau pasang secara global langsung dari URL GitHub
- npm install -g git+https://github.com/roedyrustam/vibes-plug.git
- vibes-plug --all
- ```
- **Opsi B: Git Clone & Multi-Platform Universal Installer**
- Clone repositori dan gunakan installer otomatis bawaan untuk mendeteksi serta mengonfigurasi seluruh IDE Anda:
- ```bash
- git clone https://github.com/roedyrustam/vibes-plug.git
- cd vibes-plug
- npm install
- # Pasang ke semua platform yang terpasang di komputer Anda:
- npm run install-all
- # (atau jalankan node scripts/install.js --all)
- ```
- **Opsi C: Git Clone Langsung untuk Google Antigravity (AGY)**
- Google Antigravity memuat plugin secara otomatis dari folder `~/.gemini/config/plugins/`. Anda dapat langsung meng-clone ke direktori plugin tersebut:
- ```bash
- # macOS & Linux:
- git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
- # Windows (PowerShell):
- git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
- ```
- **Opsi D: Pemasangan Spesifik per Proyek**
- Dari direktori `vibes-plug` yang sudah di-clone, Anda dapat menyuntikkan rules dan skills ke folder proyek tertentu:
- ```bash
- # Untuk Claude Code (global + proyek spesifik):
- node scripts/install.js --claude --project /path/ke/proyek-anda
- # Untuk Cursor IDE (proyek spesifik):
- node scripts/install.js --cursor --project /path/ke/proyek-anda
- # Untuk OpenAI Codex:
- node scripts/install.js --codex --project /path/ke/proyek-anda
- # Untuk Windsurf, Trae, atau VSCode (Cline):
- cp .windsurfrules /path/ke/proyek-anda/
- cp .traerules /path/ke/proyek-anda/
- cp .clinerules /path/ke/proyek-anda/
- ```
- **Opsi E: Pembaruan Rutin via GitHub**
- Untuk mendapatkan update 178 skill dan engine terbaru:
- ```bash
- cd ~/.gemini/config/plugins/vibes-plug # (atau folder hasil clone Anda)
- git pull origin main
- npm test
- ```
- #### Metode 3: Konfigurasi Manual Berdasarkan Platform (Arsip ZIP / Salin File)
- Jika Anda mengunduh arsip `.zip`, ekstrak dan konfigurasikan IDE Anda sebagai berikut:
- - **Google Antigravity (AGY):** Pindahkan folder ke `~/.gemini/config/plugins/vibes-plug`.
- - **Claude Code:** Jalankan `vibes-plug --claude` atau salin `CLAUDE.md` dan `.claude/rules/` ke root proyek.
- - **Cursor IDE:** Jalankan `vibes-plug --cursor --project .` atau salin `.cursorrules` dan `.cursor/rules/` ke root proyek.
- - **OpenAI Codex CLI:** Jalankan `vibes-plug --codex` atau salin `CODEX.md` dan `.codex/rules/` ke root proyek.
- - **Windsurf IDE:** Salin `.windsurfrules` ke root proyek Anda.
- - **Trae IDE:** Salin `.traerules` ke root proyek Anda.
- - **VSCode (Cline / Roo):** Salin `.clinerules` ke root proyek Anda.
- - **Kimi / Kiro:** Salin `.kimirules` atau `.kirorules` ke root proyek Anda.
- ### 💻 Cara Penggunaan Plugin & CLI
- **1. Prompting Bebas Hambatan (Di dalam IDE)**
- Anda *tidak* perlu memanggil nama skill secara manual. Cukup buka Chat AI di IDE Anda dan ketik visi aplikasi Anda:
- > *"Buatkan saya platform SaaS multi-tenant dengan sistem pembayaran DOKU Checkout dan QRIS SNAP BI, frontend Next.js 15 App Router dengan Tailwind v4, serta otentikasi role-based dengan RLS PostgreSQL."*
- Swarm Director akan otomatis mencegat permintaan, menjalankan Tahap 1 Penemuan Konteks, membuat dokumen `PRD.md` dan `ERD.md`, serta mengorkestrasikan skill-skill yang bekerja sama melalui alur kerja 8-Fase Zero-To-Prod.
- **2. Panduan Lengkap Perintah CLI Toolkit**
- ```bash
- # Manajemen Workspace & Skill
- vibes init <project-name> # Men-scaffold struktur Zero-To-Prod 8-Fase (README, PROGRESS, BLUEPRINT, PRD)
- vibes bootstrap <type> <name> # Super-scaffold proyek + skill (saas | ecommerce | mobile | api | fullstack | spec-api)
- vibes sync # Verifikasi & sinkronisasi aturan pemicu utama di semua IDE
- vibes ui # TUI terminal interaktif untuk memilih dan memasang skill secara visual
- vibes studio [--port <n>] # Membuka dashboard web lokal Studio Cockpit (eksplorasi visual 178 skill)
- vibes list [filter] # Menampilkan daftar 178 skill (opsional: filter kata kunci)
- vibes search <query> # Mencari 178 skill berdasarkan relevansi kata kunci
- vibes add <skill-name> # Menyuntikkan skill dari repositori ke proyek lokal (.agents/skills)
- vibes remove <skill-name> # Menghapus skill yang terpasang dari proyek lokal
- vibes skill info <skill-name> # Menampilkan metadata, deskripsi, dan relasi orkestrasi skill
- vibes skill exec <s-name> <act> # Universal SaaT Dispatcher (blueprint|slice|extract-code|rules|read|audit|eval|verify|generate|fuzz)
- vibes skill exec auto verify # Auto-Router Kontekstual: deteksi otomatis skill dari file/import (--file=<path>) & jalankan guardrail
- vibes skill chain <recipe> # Mengeksekusi pipeline multi-skill (saas-launch-gate, ai-agent-hardening, fintech-settlement-gate)
- vibes skill compile-slices # Mengompilasi micro-slice terkompresi 93% (<350 token) ke .skill-slices.json
- vibes skill matrix # Menampilkan matriks kapabilitas domain & 1.000+ blueprint kode eksekusi
- vibes recipe list # Menampilkan daftar paket resep skill (ai-stack, fullstack-pro, fintech-core, spec-driven-api)
- vibes recipe apply <name> # Menerapkan paket resep skill ke workspace proyek saat ini
- vibes docs [markdown|json] # Mengekspor katalog 178 skill ke terminal, CATALOG.md, atau CATALOG.json
- vibes create-skill <name> # Membuat boilerplate skill baru sesuai standar spesifikasi
- vibes create-agent --name <n> # Menghasilkan custom subagent lintas Antigravity, Cursor, dan Claude
- vibes create-mcp <server-name> # Men-scaffold server Model Context Protocol baru
- # Engine Superintelligence & Verifikasi Formal
- vibes guard # Menjalankan seluruh pipeline CI Sovereign Guard (P1–P5 + Anti-Slop + Swarm)
- vibes compile-cache # Mengompilasi prefix KV-Cache deterministik (>1024 token) hemat biaya 75-90%
- vibes db:eval [file|--sql] # Simulasi & audit migrasi SQL DDL di memori untuk proteksi RLS
- vibes ast <action> [args] # Kueri bedah simbol AST (symbols), isolasi fungsi (inspect), atau blast-radius
- vibes arbitrate [fileA] [fileB] # Menilai & mengarbitrasi draf kode kompetitif dengan Process Reward Model (PRM)
- vibes verify-invariants [file] # Membuktikan formal invarian state machine & menghasilkan spesifikasi SMT-LIB 2.0
- vibes swarm "<task>" # Menjalankan Swarm Director otonom (Fan-Out/Fan-In, Saga, Critic-Validator)
- vibes memory <record|query|cp> # Memori episodik proyek & pembuatan checkpoint ultra-ringkas (<150 token)
- vibes mcp # Memulai server native Model Context Protocol (MCP v1.x) melalui stdio
- # Gerbang Kualitas & Diagnostik
- vibes anti-slop # Menjalankan scanner Sovereign Anti-Slop (deteksi placeholder & stub kosong)
- vibes anti-slop --strict # Mode CI ketat: setiap peringatan slop membatalkan build
- vibes anti-slop --fix # Menghapus otomatis komentar narasi sintaksis yang redundan
- vibes audit # Menjalankan zero-tech-debt-auditor untuk kode mati & penegakan tipe ketat
- vibes doctor # Memeriksa kesehatan lingkungan dan integrasi seluruh IDE
- vibes hooks install # Memasang Git pre-commit hook untuk menegakkan gerbang anti-slop
- ```
- ### ⚡ Mesin Eksekusi Skill & Auto-Router Kontekstual (`skill-rules-engine`)
- Setiap skill dari 178 skill dilengkapi dengan eksekusi deterministik dan guardrail aktif:
- - **Guardrail AST & Regex Spesifik per Skill (`rules` / `verify`)**: Menegakkan invarian spesifik framework secara otomatis (Next.js 15 async `params`, React 19 Compiler & larangan `fetch` di dalam `useEffect`, Tailwind v4 `@theme`, Vue 3.5 `<script setup>` & Pinia, Svelte 5 Runes, komentar wajib `// SAFETY:` & larangan `.unwrap()` pada Rust, penanganan error Go, Pydantic v2 `.model_dump()`, PostgreSQL RLS, verifikasi tanda tangan HMAC `timingSafeEqual` & tipe mata uang integer pada DOKU/SNAP BI, larangan tag `:latest` Docker, serta proteksi `stdout` MCP stdio).
- - **Auto-Router File & Intent Kontekstual (`vibes skill exec auto verify --file=<path>`)**: Mencocokkan ekstensi file (`.rs`, `.go`, `.py`, `.vue`, `.svelte`, `.tsx`, `Dockerfile`, `.sql`, `.wgsl`) dan *import signature* secara otomatis ke skill terkait serta memvalidasinya di dalam `vibes_verify_gate`.
- - **Pemuatan Skill Terpilah Bahasa (`--lang=en|id`)**: Memuat hanya seksi Bahasa Inggris atau Bahasa Indonesia dari `SKILL.md` (dengan opsi pemangkasan tabel statis), menghemat **45–55% token *context window*** tanpa kehilangan satu pun blueprint kode.
- - **Pemotongan Blueprint Cerdas Sadar-AST**: Mengekstrak tanda tangan fungsi/komponen secara utuh dan mengindeks seluruh 1.081 blok kode berdasarkan judul sub-bab Markdown (`--query=<kata-kunci>`).
- ---
- <a name="mandarin"></a>
- ## 🇨🇳 中文版 (Mandarin)
- 欢迎来到 **VibesPlug Pro**。VibesPlug 充当 **集群指挥官 (Swarm Director)**,编排 178 个专业的 AI 子代理。它经过严格工程化设计,旨在从所有前沿模型 (Gemini 4 Pro、Claude 5、GPT-5.6/O3、OpenAI Codex 和 DeepSeek) 中提取最大的推理能力。
- ### 🚀 通用安装指南 (所有 IDE 和 LLM)
- *支持的平台: Google Antigravity, Claude Code, Cursor IDE, OpenAI Codex CLI, Windsurf, Trae, VSCode (Cline), Kimi, Kiro。*
- #### 方法 1: CLI (NPM 安装 - 推荐)
- ```bash
- npm i -g vibes-plug
- vibes-plug init
- ```
- #### 方法 2: 通过 GitHub 安装 (Git Clone / NPX 直接运行 - 始终获取最新版)
- 您可以直接从 GitHub 仓库安装或运行 VibesPlug:
- **选项 A: 通过 NPX 直接从 GitHub 运行 (无需克隆)**
- ```bash
- # 运行安装程序至所有检测到的 IDE
- npx github:roedyrustam/vibes-plug --all
- # 或直接通过 Git URL 全局安装
- npm install -g git+https://github.com/roedyrustam/vibes-plug.git
- vibes-plug --all
- ```
- **选项 B: 克隆并运行多平台安装程序**
- ```bash
- git clone https://github.com/roedyrustam/vibes-plug.git
- cd vibes-plug
- npm install
- npm run install-all
- ```
- **选项 C: 直接克隆至 Google Antigravity (AGY)**
- ```bash
- # macOS / Linux
- git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
- # Windows (PowerShell)
- git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
- ```
- **选项 D: 针对特定项目的注入安装**
- ```bash
- # Claude Code:
- node scripts/install.js --claude --project /path/to/project
- # Cursor IDE:
- node scripts/install.js --cursor --project /path/to/project
- # OpenAI Codex:
- node scripts/install.js --codex --project /path/to/project
- ```
- **选项 E: 通过 GitHub 保持最新**
- ```bash
- cd ~/.gemini/config/plugins/vibes-plug
- git pull origin main
- npm test
- ```
- #### 方法 3: 平台专属配置
- - **Antigravity (Google):** 移至 `~/.gemini/config/plugins/vibes-plug`,规则位于 `rules/AGENTS.md`,MCP 服务配置在 `mcp_config.json`。
- - **Claude Code:** 运行 `vibes-plug --claude` 或将 `CLAUDE.md` 与 `.claude/rules/` 复制到项目根目录。
- - **Cursor IDE:** 运行 `vibes-plug --cursor --project .` 或将 `.cursorrules` 与 `.cursor/rules/` 复制到项目根目录。
- - **OpenAI Codex:** 运行 `vibes-plug --codex` 或将 `CODEX.md` 与 `.codex/rules/` 复制到项目根目录。
- - **Windsurf / Trae / VSCode (Cline):** 复制对应的 `.windsurfrules`、`.traerules` 或 `.clinerules` 到项目根目录。
- ### 💻 核心 CLI 命令
- - `vibes init <project-name>` — 初始化 8 阶段端到端项目架构。
- - `vibes ui` — 终端交互式 TUI 界面,可视化选择与安装技能。
- - `vibes studio [--port <n>]` — 启动本地 Web Studio 驾驶舱仪表板 (178 个技能可视化探索、子代理集群与 P1-P5 引擎)。
- - `vibes recipe list` — 列出预置技能配方套件 (ai-stack, fullstack-pro, fintech-core, spec-driven-api)。
- - `vibes docs [markdown|json]` — 导出 178 个技能的完整目录至终端、`CATALOG.md` 或 `CATALOG.json`。
- - `vibes guard` — 运行完整的 Sovereign Guard CI 生产就绪验证流水线 (P1–P5 + Anti-Slop)。
- - `vibes compile-cache` — 编译并锁定确定性 KV-Cache 前缀 (>1024 tokens),降低 75-90% 代币开销。
- - `vibes db:eval` — 在内存沙箱中模拟和审计 SQL DDL 迁移及 RLS 策略。
- - `vibes ast <action>` — 精确查询 AST 代码符号并计算重构影响范围 (blast-radius)。
- - `vibes arbitrate` — 使用过程奖励模型 (PRM) 评分并仲裁竞品代码草稿。
- - `vibes verify-invariants` — 形式化验证状态机并生成用于 Z3 的 SMT-LIB 2.0 规格。
- - `vibes swarm "<task>"` — 启动自主多代理集群协同 (Fan-Out/Fan-In, Saga, Critic-Validator)。
- - `vibes memory` — 本地跨会话情节记忆与超紧凑检查点 (<150 tokens)。
- - `vibes mcp` — 在 stdio 上启动原生 Model Context Protocol (MCP v1.x) 8 项前沿工具服务。
- - `vibes anti-slop` — 运行零废话代码扫描器,消除未实现的代码桩与占位符。
- ---
- <a name="german"></a>
- ## 🇩🇪 Deutsche Version (German)
- Willkommen bei **VibesPlug Pro**. VibesPlug fungiert als **Swarm Director** und orchestriert 178 spezialisierte KI-Subagenten. Es wurde streng dafür entwickelt, maximale Schlussfolgerungsfähigkeiten aus ALLEN Frontier-Modellen (Gemini 4 Pro, Claude 5, GPT-5.6/O3, OpenAI Codex und DeepSeek) zu extrahieren.
- ### 🚀 Universelle Installationsanleitung (Alle IDEs & LLMs)
- *Unterstützte Plattformen: Antigravity, Claude Code, Cursor, OpenAI Codex, Windsurf, Trae, VSCode (Cline), Kimi, Kiro.*
- #### Methode 1: CLI (NPM-Installation - Empfohlen)
- ```bash
- npm i -g vibes-plug
- vibes-plug init
- ```
- #### Methode 2: GitHub-Installation (Git Clone / Direkt per NPX - Immer aktuell)
- Sie können VibesPlug direkt aus dem GitHub-Repository ausführen oder installieren:
- **Option A: Direkte Ausführung via NPX (Kein Klonen erforderlich)**
- ```bash
- # Installer direkt von GitHub ausführen
- npx github:roedyrustam/vibes-plug --all
- # Oder global via Git URL installieren
- npm install -g git+https://github.com/roedyrustam/vibes-plug.git
- vibes-plug --all
- ```
- **Option B: Git Clone & Universeller Installer**
- ```bash
- git clone https://github.com/roedyrustam/vibes-plug.git
- cd vibes-plug
- npm install
- npm run install-all
- ```
- **Option C: Direktes Klonen für Google Antigravity (AGY)**
- ```bash
- # macOS & Linux:
- git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
- # Windows (PowerShell):
- git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
- ```
- **Option D: Gezielte Installation pro Projekt**
- ```bash
- # Claude Code:
- node scripts/install.js --claude --project /pfad/zum/projekt
- # Cursor IDE:
- node scripts/install.js --cursor --project /pfad/zum/projekt
- # OpenAI Codex:
- node scripts/install.js --codex --project /pfad/zum/projekt
- ```
- **Option E: Aktualisierung via GitHub**
- ```bash
- cd ~/.gemini/config/plugins/vibes-plug
- git pull origin main
- npm test
- ```
- #### Methode 3: Plattformspezifische manuelle Konfiguration
- - **Antigravity (Google):** Nativ installiert in `~/.gemini/config/plugins/vibes-plug` mit Regeln in `rules/AGENTS.md` und MCP-Server in `mcp_config.json`.
- - **Claude Code:** `vibes-plug --claude` ausführen oder `CLAUDE.md` & `.claude/rules/` kopieren.
- - **Cursor IDE:** `vibes-plug --cursor --project .` ausführen oder `.cursorrules` & `.cursor/rules/` kopieren.
- - **OpenAI Codex:** `vibes-plug --codex` ausführen oder `CODEX.md` & `.codex/rules/` kopieren.
- - **Windsurf / Trae / Cline:** Entsprechende `.windsurfrules`, `.traerules` oder `.clinerules` in das Stammverzeichnis kopieren.
- ### 💻 Wichtigste CLI-Befehle
- - `vibes init <project-name>` — Initialisiert die 8-Phasen-Zero-To-Prod-Architektur.
- - `vibes ui` — Interaktives Terminal-TUI zur visuellen Auswahl und Installation von Skills.
- - `vibes studio [--port <n>]` — Startet das lokale Web-Studio-Dashboard (visueller 178-Skill-Explorer, Subagenten-Swarm und P1–P5 Cockpit).
- - `vibes recipe list` — Listet kuratierte Skill-Pakete auf (ai-stack, fullstack-pro, fintech-core, spec-driven-api).
- - `vibes docs [markdown|json]` — Exportiert den vollständigen 178-Skill-Katalog ins Terminal, als `CATALOG.md` oder `CATALOG.json`.
- - `vibes guard` — Führt die vollständige Sovereign Guard CI-Validierung aus (P1–P5 + Anti-Slop).
- - `vibes compile-cache` — Kompiliert deterministische KV-Cache-Präfixe (>1024 Tokens) für 75–90% Kostensenkung.
- - `vibes db:eval` — Simuliert und prüft SQL-DDL-Migrationen im Speicher auf RLS-Sicherheit.
- - `vibes ast <action>` — Führt AST-Symbolabfragen durch und berechnet den Refactoring-Blast-Radius.
- - `vibes arbitrate` — Bewertet konkurrierende Code-Entwürfe mittels Process Reward Models (PRM).
- - `vibes verify-invariants` — Mathematischer Beweis von Zustandsübergängen & SMT-LIB 2.0 Generierung für Z3.
- - `vibes swarm "<task>"` — Führt den autonomen Swarm Director aus (Fan-Out/Fan-In, Saga, Critic-Validator).
- - `vibes memory` — Lokales episodisches Gedächtnis und ultrakompakte Checkpoints (<150 Tokens).
- - `vibes mcp` — Startet den nativen Model Context Protocol (MCP v1.x) Server über stdio.
- - `vibes anti-slop` — Erkennt und eliminiert unfertigen Code, `// TODO` und leere Stubs.
- ---
- <a name="japanese"></a>
- ## 🇯🇵 日本語版 (Japanese)
- **VibesPlug Pro** へようこそ。VibesPlug は **スウォームディレクター (Swarm Director)** として機能し、178 の専門的な AI サブエージェントをオーケストレーションします。すべての最先端モデル (Gemini 4 Pro、Claude 5、GPT-5.6/O3、OpenAI Codex、DeepSeek) から最大の推論能力を引き出すように厳密に設計されています。
- ### 🚀 ユニバーサルインストールガイド (すべての IDE と LLM)
- *サポートされているプラットフォーム: Google Antigravity, Claude Code, Cursor, OpenAI Codex, Windsurf, Trae, VSCode (Cline), Kimi, Kiro。*
- #### 方法 1: CLI (NPM インストール - 推奨)
- ```bash
- npm i -g vibes-plug
- vibes-plug init
- ```
- #### 方法 2: GitHub 経由のインストール (Git Clone / NPX 直接実行 - 常に最新版)
- GitHub リポジトリから直接 VibesPlug を実行またはインストールできます。
- **オプション A: NPX を使用した直接実行 (クローン不要)**
- ```bash
- # 検出されたすべての IDE にインストーラーを実行
- npx github:roedyrustam/vibes-plug --all
- # または GitHub の Git URL からグローバルにインストール
- npm install -g git+https://github.com/roedyrustam/vibes-plug.git
- vibes-plug --all
- ```
- **オプション B: Git クローンとユニバーサルインストーラー**
- ```bash
- git clone https://github.com/roedyrustam/vibes-plug.git
- cd vibes-plug
- npm install
- npm run install-all
- ```
- **オプション C: Google Antigravity への直接クローン**
- ```bash
- # macOS & Linux:
- git clone https://github.com/roedyrustam/vibes-plug.git ~/.gemini/config/plugins/vibes-plug
- # Windows (PowerShell):
- git clone https://github.com/roedyrustam/vibes-plug.git "$HOME\.gemini\config\plugins\vibes-plug"
- ```
- **オプション D: プロジェクト別のターゲットインストール**
- ```bash
- # Claude Code:
- node scripts/install.js --claude --project /path/to/project
- # Cursor IDE:
- node scripts/install.js --cursor --project /path/to/project
- # OpenAI Codex:
- node scripts/install.js --codex --project /path/to/project
- ```
- **オプション E: GitHub 経由での最新版への更新**
- ```bash
- cd ~/.gemini/config/plugins/vibes-plug
- git pull origin main
- npm test
- ```
- #### 方法 3: プラットフォーム別手動インストール
- - **Antigravity (Google):** `~/.gemini/config/plugins/vibes-plug` にネイティブ配置、ルールは `rules/AGENTS.md`、MCP サーバーは `mcp_config.json`。
- - **Claude Code:** `vibes-plug --claude` を実行、または `CLAUDE.md` と `.claude/rules/` をプロジェクトルートにコピー。
- - **Cursor IDE:** `vibes-plug --cursor --project .` を実行、または `.cursorrules` と `.cursor/rules/` をプロジェクトルートにコピー。
- - **OpenAI Codex:** `vibes-plug --codex` を実行、または `CODEX.md` と `.codex/rules/` をプロジェクトルートにコピー。
- - **Windsurf / Trae / Cline:** それぞれのルールファイルをプロジェクトルートにコピー。
- ### 💻 主な CLI コマンド
- - `vibes init <project-name>` — 8フェーズ Zero-To-Prod 開発プロジェクトを初期化。
- - `vibes ui` — スキルを視覚的に選択してインストールするインタラクティブなターミナル TUI。
- - `vibes studio [--port <n>]` — ローカル Web Studio コックピットダッシュボードを起動 (178スキルの視覚的探索、サブエージェント、P1-P5)。
- - `vibes recipe list` — キュレーションされたスキルレシピ一覧 (ai-stack, fullstack-pro, fintech-core, spec-driven-api)。
- - `vibes docs [markdown|json]` — 178のスキル全カタログをターミナル、`CATALOG.md`、または `CATALOG.json` に出力。
- - `vibes guard` — 完全な Sovereign Guard CI パイプラインを実行 (P1–P5 + Anti-Slop)。
- - `vibes compile-cache` — 決定論的 KV-Cache プレフィックス (>1024 トークン) をコンパイルし、コストを 75-90% 削減。
- - `vibes db:eval` — インメモリで SQL DDL マイグレーションをシミュレーションし、RLS ポリシーを監査。
- - `vibes ast <action>` — AST シンボルを外科的に検索し、依存関係の影響範囲 (blast-radius) を計算。
- - `vibes arbitrate` — Process Reward Model (PRM) を用いて競合するコードドラフトを評価・仲裁。
- - `vibes verify-invariants` — 状態遷移の不変条件を形式的に証明し、Z3 用の SMT-LIB 2.0 仕様を生成。
- - `vibes swarm "<task>"` — 自律型スウォームディレクターを実行 (Fan-Out/Fan-In, Saga, Critic-Validator)。
- - `vibes memory` — クロスセッションのエピソード記憶と超コンパクトなチェックポイント (<150 トークン)。
- - `vibes mcp` — stdio 経由で 8 つの高度なツールを備えたネイティブ MCP (v1.x) サーバーを起動。
- - `vibes anti-slop` — 未完成のコード、不要なコメント、プレースホルダーを検出・排除。
- ---
- <a name="star-history"></a>
- ## 📈 Star History & Growth
- Support open-source AI innovation! Drop a ⭐ star on this repo to help it reach more developers worldwide.
- <div align="center">
- <a href="https://star-history.com/#roedyrustam/vibes-plug&Date">
- <img src="https://api.star-history.com/svg?repos=roedyrustam/vibes-plug&type=Date" alt="Star History Chart" width="100%" style="max-width: 800px; border-radius: 12px; margin-top: 10px;" />
- </a>
- </div>
- ---
- ## 🤝 Community & Contributing
- Contributions are warmly welcome! Whether you are:
- - Submitting a new AI domain skill
- - Reporting a bug or edge-case
- - Improving multilingual prompts & docs
- Check out our [Contributing Guide](CONTRIBUTING.md) to get started.
- ### 🏷️ GitHub Topics & Ecosystem Taxonomy
- `ai-agents` • `multi-agent-swarm` • `mcp-server` • `model-context-protocol` • `skill-as-a-tool` • `claude-code` • `cursor-rules` • `antigravity` • `openai-codex` • `vibe-coding` • `agentic-ai` • `reverse-engineering` • `ghidra` • `binary-analysis` • `rea` • `fullstack` • `nextjs15` • `react19` • `tailwindcss-v4` • `zero-to-prod`
- ## 📄 License
- Distributed under the [MIT License](LICENSE). Built for the global developer ecosystem.
- ---
- <div align="center">
- <sub>Engineered by <a href="https://github.com/roedyrustam">Roedy Rustam</a> & Open-Source Contributors. Empowered by Frontier AI with Human Reasoning.</sub>
- </div>
install.ps1 · Bundled script · 80 lines · 1 finding marked
- # ==============================================================================
- # Vibes-Plug Universal One-Line Installer (Windows PowerShell)
- # Usage:
- # irm https://raw.githubusercontent.com/roedyrustam/vibes-plug/main/install.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 4 on GitHub
- # ==============================================================================
- $ErrorActionPreference = 'Stop'
- Write-Host ""
- Write-Host "╔══════════════════════════════════════════════════════════╗" -ForegroundColor Cyan
- Write-Host "║ 🚀 Vibes-Plug Universal Installer (2026 Edition) ║" -ForegroundColor Cyan
- Write-Host "║ 178 Specialized Skills & Sovereign Multi-Agent Swarm ║" -ForegroundColor Cyan
- Write-Host "╚══════════════════════════════════════════════════════════╝" -ForegroundColor Cyan
- Write-Host ""
- # 1. Detect Runtime (Node.js >= 20.x or Bun >= 1.2)
- $runtime = $null
- if (Get-Command node -ErrorAction SilentlyContinue) {
- $nodeVer = (node -v).TrimStart('v')
- $major = [int]($nodeVer.Split('.')[0])
- if ($major -ge 20) {
- $runtime = 'node'
- Write-Host "✓ Detected Node.js v$nodeVer" -ForegroundColor Green
- } else {
- Write-Host "! Detected Node.js v$nodeVer (Recommended: v20.x or v22.x+ LTS)" -ForegroundColor Yellow
- $runtime = 'node'
- }
- } elseif (Get-Command bun -ErrorAction SilentlyContinue) {
- $bunVer = (bun -v)
- $runtime = 'bun'
- Write-Host "✓ Detected Bun v$bunVer" -ForegroundColor Green
- } else {
- Write-Host "✗ Error: Neither Node.js (>=20.x) nor Bun was found in PATH." -ForegroundColor Red
- Write-Host "Please install Node.js from https://nodejs.org or Bun from https://bun.sh"
- exit 1
- }
- # 2. Determine Destination
- $targetDir = Join-Path $env:USERPROFILE ".gemini\config\plugins\vibes-plug"
- Write-Host "📁 Target destination: $targetDir" -ForegroundColor Cyan
- # 3. Clone or Update
- if (Test-Path (Join-Path $targetDir ".git")) {
- Write-Host "↻ Existing installation found. Pulling latest updates..." -ForegroundColor Yellow
- git -C $targetDir pull --quiet origin main
- } else {
- Write-Host "⬇ Cloning repository from GitHub..." -ForegroundColor Green
- $parent = Split-Path $targetDir -Parent
- if (!(Test-Path $parent)) { New-Item -ItemType Directory -Path $parent -Force | Out-Null }
- git clone --depth 1 https://github.com/roedyrustam/vibes-plug.git $targetDir
- }
- # 4. Synchronize Multi-Platform Configurations
- Write-Host ""
- Write-Host "⚙ Synchronizing cross-IDE agent rules & MCP bridges..." -ForegroundColor Cyan
- Push-Location $targetDir
- try {
- & $runtime scripts/install.js --all
- } finally {
- Pop-Location
- }
- # 5. Setup Windows vibes.cmd wrapper in User AppData or local bin
- $binDir = Join-Path $env:LOCALAPPDATA "Microsoft\WindowsApps"
- $cmdWrapper = Join-Path $binDir "vibes.cmd"
- $cliTarget = Join-Path $targetDir "bin\vibes.mjs"
- $cmdContent = "@echo off`r`nnode `"$cliTarget`" %*`r`n"
- try {
- [System.IO.File]::WriteAllText($cmdWrapper, $cmdContent)
- Write-Host "✓ Created CLI wrapper at $cmdWrapper" -ForegroundColor Green
- } catch {
- Write-Host "! Could not write to WindowsApps; adding direct path recommendation." -ForegroundColor Yellow
- }
- Write-Host ""
- Write-Host "✨ Vibes-Plug successfully installed!" -ForegroundColor Green
- Write-Host "⚡ Run 'vibes help' or 'vibes studio' to launch the Studio Cockpit." -ForegroundColor White
- Write-Host "🌐 Primary Trigger active across Antigravity, Claude Code, Cursor, Codex, Windsurf, Cline, Trae, Kimi, and Kiro." -ForegroundColor Cyan
- Write-Host ""
install.sh · Bundled script · 83 lines · 1 finding marked
- #!/usr/bin/env bash
- # ==============================================================================
- # Vibes-Plug Universal One-Line Installer (Linux / macOS / WSL)
- # Usage:
- # curl -fsSL https://raw.githubusercontent.com/roedyrustam/vibes-plug/main/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 5 on GitHub
- # ==============================================================================
- set -euo pipefail
- BOLD="\033[1m"
- GREEN="\033[32m"
- CYAN="\033[36m"
- YELLOW="\033[33m"
- RED="\033[31m"
- RESET="\033[0m"
- echo -e "${BOLD}${CYAN}"
- echo "╔══════════════════════════════════════════════════════════╗"
- echo "║ 🚀 Vibes-Plug Universal Installer (2026 Edition) ║"
- echo "║ 178 Specialized Skills & Sovereign Multi-Agent Swarm ║"
- echo "╚══════════════════════════════════════════════════════════╝"
- echo -e "${RESET}"
- # 1. Detect Runtime (Node.js >= 20.x or Bun >= 1.2)
- RUNTIME=""
- if command -v node >/dev/null 2>&1; then
- NODE_VERSION=$(node -v | sed 's/v//')
- NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
- if [ "$NODE_MAJOR" -ge 20 ]; then
- RUNTIME="node"
- echo -e "${GREEN}✓ Detected Node.js v${NODE_VERSION}${RESET}"
- else
- echo -e "${YELLOW}! Detected Node.js v${NODE_VERSION} (Recommended: v20.x or v22.x+ LTS)${RESET}"
- RUNTIME="node"
- fi
- elif command -v bun >/dev/null 2>&1; then
- BUN_VERSION=$(bun -v)
- RUNTIME="bun"
- echo -e "${GREEN}✓ Detected Bun v${BUN_VERSION}${RESET}"
- else
- echo -e "${RED}✗ Error: Neither Node.js (>=20.x) nor Bun was found.${RESET}"
- echo "Please install Node.js from https://nodejs.org or Bun from https://bun.sh"
- exit 1
- fi
- # 2. Determine Target Directory
- TARGET_DIR="${HOME}/.gemini/config/plugins/vibes-plug"
- echo -e "${CYAN}📁 Target destination: ${TARGET_DIR}${RESET}"
- # 3. Clone or Update Repository
- if [ -d "${TARGET_DIR}/.git" ]; then
- echo -e "${YELLOW}↻ Existing installation found. Pulling latest updates...${RESET}"
- git -C "${TARGET_DIR}" pull --quiet origin main || git -C "${TARGET_DIR}" pull --quiet
- else
- echo -e "${GREEN}⬇ Cloning repository from GitHub...${RESET}"
- mkdir -p "$(dirname "${TARGET_DIR}")"
- git clone --depth 1 https://github.com/roedyrustam/vibes-plug.git "${TARGET_DIR}"
- fi
- # 4. Synchronize Multi-Platform Configurations
- echo -e "\n${CYAN}⚙ Synchronizing cross-IDE agent rules & MCP bridges...${RESET}"
- (cd "${TARGET_DIR}" && $RUNTIME scripts/install.js --all)
- # 5. Setup Global 'vibes' CLI Command Symlink
- BIN_DIR="${HOME}/.local/bin"
- mkdir -p "${BIN_DIR}"
- CLI_LINK="${BIN_DIR}/vibes"
- rm -f "${CLI_LINK}"
- ln -sf "${TARGET_DIR}/bin/vibes.mjs" "${CLI_LINK}"
- chmod +x "${TARGET_DIR}/bin/vibes.mjs" "${CLI_LINK}"
- echo -e "\n${GREEN}✓ Created CLI link at ${CLI_LINK}${RESET}"
- # Verify PATH
- if [[ ":$PATH:" != *":${BIN_DIR}:"* ]]; then
- echo -e "${YELLOW}ℹ Tip: Add ${BIN_DIR} to your PATH in ~/.bashrc or ~/.zshrc:${RESET}"
- echo " export PATH=\"\$HOME/.local/bin:\$PATH\""
- fi
- echo -e "\n${BOLD}${GREEN}✨ Vibes-Plug successfully installed!${RESET}"
- echo -e "⚡ Run ${BOLD}vibes help${RESET} or ${BOLD}vibes studio${RESET} to launch the Studio Cockpit."
- echo -e "🌐 Primary Trigger active across Antigravity, Claude Code, Cursor, Codex, Windsurf, Cline, Trae, Kimi, and Kiro.\n"
Version history
v4.8.011/11/2026
v4.7.011/7/2026
v4.5.010/25/2026
v4.4.310/24/2026
v4.4.210/23/2026
v4.4.110/21/2026
v4.4.010/19/2026
v4.3.010/18/2026
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.