gir-ai

GIR (Get It Running)

A modular Claude Code plugin ecosystem. Install only what you need — curated agents, auto-delegation, memory bank, and domain-specific tooling.

"Doom Song!"

What Is GIR?

GIR is a modular ecosystem that separates:

• Universal workflows (all projects)
• Project-specific details (your stack)
• Modular agents (opt-in only)

Drop into any project for instant Claude Code productivity.

Why Modular?

GIR is designed so you only pay the token cost for what you use. Install gir-core, then add only the spokes your project needs. No wasted context, no irrelevant tools loaded into every session.

Setup	Token Savings vs. Monolithic
Core only	~45% reduction
Core + 1 spoke	~35–40% reduction
Core + 2–3 spokes	~25–35% reduction
All 7 modules	Comparable total, but fully modular

Each module self-registers at session start. Installed modules list their tools in .gir/GIR.modules. Uninstalled modules are invisible — zero token overhead.

---

Architecture

GIR uses a hub-and-spoke model. gir-core is required and provides the foundation. Spoke plugins are optional and extend it for specific domains.

                        ┌─────────────────┐
                        │    gir-core     │  ← REQUIRED
                        │                 │
                        │  agents:        │
                        │  • feature-architect
                        │  • code-reviewer│
                        │  • debugger     │
                        │  • team-lead    │
                        │  • spec-analyst │
                        │                 │
                        │  skills + cmds  │
                        │  hooks + MCP    │
                        └────────┬────────┘
                                 │
    ┌────────────┬───────────────┼───────────────┬────────────┬────────────┐
    │            │               │               │            │            │
┌───▼───┐  ┌────▼────┐  ┌───────▼──────┐  ┌────▼────┐  ┌────▼───┐  ┌────▼───┐
│gir-web│  │gir-auto-│  │  gir-tools   │  │gir-data-│  │ gir-ai │  │ gir-qa │
│       │  │ mation  │  │              │  │  base   │  │        │  │        │
│• docs │  │         │  │ • agenthub   │  │         │  │• Gemini│  │• Code- │
│• deploy│ │ • n8n-  │  │ • subtask-   │  │• Supa-  │  │  -CLI  │  │  Rabbit│
│• ui-  │  │   builder│ │   manager    │  │  base   │  │• Codex │  │• Jules │
│  gen  │  │         │  │ • subtask    │  │  tools  │  │        │  │        │
│       │  │         │  │   skills     │  │         │  │        │  │        │
└───────┘  └─────────┘  └──────────────┘  └─────────┘  └────────┘  └────────┘

---

Token Economics

GIR is designed for zero wasted context. You only load what you use.

Setup	Context Used	Token Savings
Core only	~7-8K (3.5-4%)	45% vs. monolithic
Core + 1 spoke	~9-10K (4.5-5%)	35-40% savings
Core + 2-3 spokes	~11-14K (5-7%)	25-35% savings
All modules	~19-32K (10-16%)	Full modular ecosystem

What this means: Installing just gir-core uses less than 4% of your 200K context window, leaving 193K+ tokens for your actual code and tasks. Each additional module adds only 2-4K tokens.

If you need a module, install it. If you don't, it costs nothing.

---

Install

Step 1: Add the marketplace

claude plugin marketplace add rivit-studio/GIR

Step 2: Install core (required)

claude plugin install gir-core

Step 3: Install the modules you need

claude plugin install gir-web           # Frontend/fullstack (v0, Figma, Vercel)
claude plugin install gir-automation    # n8n workflow automation
claude plugin install gir-tools         # AgentHub + team coordination
claude plugin install gir-database      # Database management (Supabase)
claude plugin install gir-ai            # AI delegation (Gemini-CLI, Codex)
claude plugin install gir-qa            # QA & review (CodeRabbit, Jules)

Step 4: Discover modules

/gir-core:modules

---

Quick Start by Tech Stack

Next.js / React Fullstack

claude plugin install gir-core
claude plugin install gir-web         # Frontend tooling (v0, Figma, Vercel)

Then run /gir-core:init-project to scaffold CLAUDE-project.md for your stack.

Backend API

claude plugin install gir-core

Then run /gir-core:init-project to scaffold CLAUDE-project.md for your stack.

Full-Stack + Automation