Garuda

Garuda

AI can write the code. Garuda makes sure the change respects your system.

Change control for AI-written code.

Leading an engineering team? The business case in two minutes →

▶ Watch the dashboard demo video

---

What is this?

You let an AI assistant (Claude Code, Cursor, Codex…) change your code. It works. The tests pass. But did it quietly skip your service layer, break a rule your team agreed on last year, or change a number your finance team relies on?

Your assistant is good at writing code. It does not automatically know every decision your team made, every part of the system that depends on the code, or every rule that has to stay true.

Garuda is a safety check that sits between your AI assistant and your codebase:

1. Before the assistant edits something, Garuda tells it who depends on that code and which rules apply.
2. After the edit, Garuda checks the change against your rules and says allow, warn, review or block, with plain instructions for fixing it.
3. Saved decisions are sealed into a tamper-evident log, so you can prove later what was checked and when.

Know the impact. Enforce the rules. Keep the evidence.

Works with Go, Python, TypeScript, and Java (Beta), with more languages on the way.

One change, start to finish

Say your assistant is asked to add a feature to the payment handler.

1. It asks Garuda first. Garuda replies: "12 other things depend on this. It is high-risk code. Rule: the payment handler must not talk to the database directly."
2. The assistant makes its edit. In a hurry, it calls the database straight from the handler.
3. Garuda checks the change. It sees the broken rule, says BLOCK, and tells the assistant exactly what to move and where.
4. The assistant fixes it. The second check says ALLOW.
5. The result is saved. You get a receipt you can look up later.

Garuda also separates problems this change introduced from problems that were already there. You are not asked to clean up years of old code before you can move forward. You only answer for what is new.

It reads Go with the compiler's full type checker (go/types), and its Beta Python, TypeScript, and Java analyzers resolve cross-file imports (__init__.py, barrel index.ts, tsconfig.json @/* paths, JAVA_IMPORT package/static imports), import aliases, type annotations (Optional[T], Promise , CompletableFuture ), constructor fields (self.attr / private readonly / Spring @Autowired DI), interface implementations, inheritance (super()), and return-type method calls at 0.95 confidence with exact file and line evidence (see What Garuda does not do).

---

Take the tour (about 10 minutes)

1. Install it · *3 minutes*

git clone https://github.com/myshra777-ai/garuda.git

cd garuda ./setup.sh

setup.sh starts a local PostgreSQL database, builds the tools into bin/, and starts the dashboard. It prints your login at the end. On Windows use setup.ps1.

Just want to look first? npx garuda-guard demo runs the demo below with no database (needs Node 18 or newer). Prefer to let an AI assistant do it? Copy a prompt for ChatGPT, Claude, Codex or Cursor.

Prefer one line? curl -fsSL https://raw.githubusercontent.com/myshra777-ai/garuda/main/install.sh | bash does the same. (As with any installer you pipe into a shell, read it first.)

2. Watch it catch three planted bugs · *1 minute*

./bin/garuda demo

This builds a tiny fake payments service with three problems planted on purpose, runs Garuda's analyzer on it, and lists the problems Garuda is built to catch. It needs no database:

You'll see each problem, the exact file and line, and a short "how to fix it" an AI assistant can follow. The service and its three problems are made up for the demo, and the demo lists them rather than detecting them. To see real detection on real code, finish step 1 and run garuda check in step 4. On Windows, run .\bin\garuda.exe demo.

3. Open the dashboard · *2 minutes*

Go to http://localhost:8080/login and sign in with the login setup.sh printed.

The dashboard's front page walks you through five steps. Here is what each part gives you:

Add your own project. Click New Workspace, paste a GitHub link or a folder path, and Garuda reads the code for you.

See your system without the spaghetti. Instead of one giant tangled graph, Garuda shows the small neighbourhood around the thing you care about: who calls it, and what it calls.

Turn written decisions into enforced rules. Drop in your design docs or decision records (ADRs). Garuda pulls out the "must" and "must not" lines and links them to the code they talk about. No docs yet? It drafts a rulebook from your code for you to approve.

Spot numbers that disagree. When two teams calculate the same metric differently, or one query divides by 1e7 and another by 1e8, Garuda helps you line up the two versions, shows the formulas it found in the code, and asks a human to decide which one is right. It does not guess.

Learn the signals. Every badge has one fixed meaning:

4. Point it at your own code · *3 minutes*

cd /path/to/your/project

/path/to/garuda/bin/garuda init . --wizard # five short questions /path/to/garuda/bin/garuda rulebook generate # drafts rules from your code /path/to/garuda/bin/garuda check . --diff HEAD # checks what you just changed

Not sure which rules to start with? Pick a ready-made set: garuda init . --template layered (also hexagonal, microservices, no-circular-imports, financial, zero-trust-auth, ai-agent-safety, pii-gdpr-hipaa, idempotent-mutations, or all). They live in policies/templates/.

Coming from ArchUnit, Dependency-Cruiser or Import Linter? garuda import --from archunit --input converts your existing rules.

If something looks off, run ./bin/garuda doctor. It checks your database, migrations and hooks and tells you what is wrong.

---

Plug it into your AI assistant

garuda init sets this up automatically for Claude Code, Claude Desktop and Cursor. To install it as a plugin instead:

The plugin needs the garuda-mcp program and a database, so do step 1 above first.

What your assistant gets: 54 tools (41 read-only, 13 that can change state) and 6 skills, short playbooks that tell it when to use them:

Check every pull request

Your assistant's good behaviour is a request. A pull request check is a rule. Add the GitHub Action and every pull request gets a verdict:

• the verdict (ALLOW, WARN, REVIEW or BLOCK) and a receipt hash in the run summary, with a one-line command to reproduce it on your machine;
• a BLOCK fails the check;
• with the ready-made workflow, .github/workflows/garuda-gate.yml, you also get a verdict comment on the pull request and findings in GitHub's Security tab;
• optional Slack or Teams alerts through garuda check --notify-slack / --notify-teams.

Copy a ready-to-paste snippet from docs/GITHUB_MARKETPLACE_STRATEGY.md, or use action.yml directly.

One more step makes it real: in your repository go to Settings → Rules (or Branches), and make the Garuda check a required status check. Until you do, a failing check is only a warning that people can merge past.

---

What Garuda does