{"id":48351199,"url":"https://github.com/solanticai/vibe-guard","last_synced_at":"2026-04-07T11:00:52.142Z","repository":{"id":348464166,"uuid":"1198206747","full_name":"solanticai/vibe-guard","owner":"solanticai","description":"AI coding guardrails framework. Runtime-enforced quality controls for Claude Code, Cursor, Codex, and more.","archived":false,"fork":false,"pushed_at":"2026-04-06T08:58:32.000Z","size":737,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-06T10:10:48.851Z","etag":null,"topics":["ai","claude-code","code-quality","codex","cursor","developer-tools","guardrails","hooks","linter","typescript"],"latest_commit_sha":null,"homepage":"https://vguard.dev/docs","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solanticai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"solanticai"}},"created_at":"2026-04-01T07:58:21.000Z","updated_at":"2026-04-06T08:54:14.000Z","dependencies_parsed_at":"2026-04-07T11:00:47.161Z","dependency_job_id":null,"html_url":"https://github.com/solanticai/vibe-guard","commit_stats":null,"previous_names":["solanticai/vibecheck","solanticai/vibe-guard"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/solanticai/vibe-guard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanticai%2Fvibe-guard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanticai%2Fvibe-guard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanticai%2Fvibe-guard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanticai%2Fvibe-guard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solanticai","download_url":"https://codeload.github.com/solanticai/vibe-guard/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanticai%2Fvibe-guard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31509941,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-code","code-quality","codex","cursor","developer-tools","guardrails","hooks","linter","typescript"],"created_at":"2026-04-05T09:03:26.439Z","updated_at":"2026-04-07T11:00:52.117Z","avatar_url":"https://github.com/solanticai.png","language":"TypeScript","funding_links":["https://github.com/sponsors/solanticai"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# VGuard\n\n**AI coding guardrails that actually enforce.**\n\n[![npm version](https://img.shields.io/npm/v/@solanticai/vguard?color=2563EB\u0026label=npm)](https://www.npmjs.com/package/@solanticai/vguard)\n[![npm downloads](https://img.shields.io/npm/dm/@solanticai/vguard?color=2563EB)](https://www.npmjs.com/package/@solanticai/vguard)\n[![license](https://img.shields.io/github/license/solanticai/vibe-guard?color=2563EB)](LICENSE)\n[![CI](https://img.shields.io/github/actions/workflow/status/solanticai/vibe-guard/ci.yml?label=CI\u0026color=16A34A)](https://github.com/solanticai/vibe-guard/actions)\n[![node](https://img.shields.io/badge/node-%3E%3D20-16A34A)](package.json)\n\n\u003c/div\u003e\n\n---\n\nAI coding tools write code fast, but they also introduce security vulnerabilities, break project conventions, and push to protected branches. VGuard sits between the AI tool and your codebase, checking every proposed change before it happens. Bad changes get blocked with a clear explanation and a suggested fix. Good changes pass through without friction.\n\n\u003cimg src=\"docs/assets/architecture-flow.svg\" alt=\"VGuard architecture flow: Developer Prompt → AI Agent → VGuard → Pass or Block\" width=\"100%\" /\u003e\n\n## Quick Start\n\n```bash\nnpm install -D @solanticai/vguard\nnpx vguard init\n```\n\nAnswer four questions and you have working guardrails. The init wizard detects your framework, asks which AI tools you use, and generates everything. See the full [Getting Started](https://vguard.dev/docs/getting-started) guide.\n\n## Features\n\n**Runtime Enforcement** — Claude Code hooks run before every tool call. VGuard inspects the proposed change, evaluates it against your rules, and blocks anything that violates them. The AI agent sees exactly what went wrong and how to fix it. [Adapter docs →](https://vguard.dev/docs/adapters/claude-code)\n\n**Advisory Guidance** — Cursor, Codex, and OpenCode don't support runtime hooks, so VGuard generates configuration files that teach the AI your project's rules before it starts writing. [Agent setup →](https://vguard.dev/docs/agent-setup)\n\n**Smart Detection** — Edit rules only flag problems that are newly introduced. Pre-existing issues in the file are left alone so you can adopt guardrails incrementally without fixing every legacy violation first. [Rules overview →](https://vguard.dev/docs/rules/overview)\n\n## Rule Layers\n\n\u003cimg src=\"docs/assets/rule-layers.svg\" alt=\"Five rule layers: Security, Quality, Workflow, Custom, Analytics\" width=\"100%\" /\u003e\n\n### Rules — 25 built-in\n\n| Category     | Count | Examples                                                              | Docs                                                     |\n| ------------ | ----: | --------------------------------------------------------------------- | -------------------------------------------------------- |\n| **Security** |     7 | branch-protection, secret-detection, prompt-injection, rls-required   | [security rules](https://vguard.dev/docs/rules/security) |\n| **Quality**  |    11 | import-aliases, naming-conventions, hallucination-guard, dead-exports | [quality rules](https://vguard.dev/docs/rules/quality)   |\n| **Workflow** |     7 | commit-conventions, pr-reminder, migration-safety, changelog-reminder | [workflow rules](https://vguard.dev/docs/rules/workflow) |\n\n### Presets — 14 ecosystem presets\n\nnextjs-15 · react-19 · typescript-strict · supabase · tailwind · django · fastapi · laravel · wordpress · react-native · astro · sveltekit · python-strict · go\n\n[Browse all presets →](https://vguard.dev/docs/presets)\n\n### Agent Support\n\n\u003cimg src=\"docs/assets/agent-support.svg\" alt=\"Agent support: Claude Code (runtime), Cursor/Codex/OpenCode (advisory), GitHub Actions (CI)\" width=\"100%\" /\u003e\n\n## Documentation\n\n| Section                                                     | Description                                   |\n| ----------------------------------------------------------- | --------------------------------------------- |\n| [Getting Started](https://vguard.dev/docs/getting-started)  | Install, init wizard, first run               |\n| [Configuration](https://vguard.dev/docs/configuration)      | `vguard.config.ts` reference                  |\n| [CLI](https://vguard.dev/docs/cli)                          | `init`, `add`, `remove`, `generate`, `doctor` |\n| [Rules](https://vguard.dev/docs/rules/overview)             | All built-in rules with examples              |\n| [Presets](https://vguard.dev/docs/presets)                  | Framework-specific rule bundles               |\n| [Agent Setup](https://vguard.dev/docs/agent-setup)          | Per-agent adapter configuration               |\n| [Custom Rules](https://vguard.dev/docs/guides/custom-rules) | Write your own guardrails                     |\n| [Troubleshooting](https://vguard.dev/docs/troubleshooting)  | Common issues and fixes                       |\n\n## VGuard Cloud\n\n[VGuard Cloud](https://vguard.dev) gives your team a dashboard for AI coding activity — which rules fire most, who's triggering blocks, and how conventions drift over time. Set up drift alerts, connect webhooks, and export analytics. Free tier available for small teams.\n\n[Cloud docs →](https://vguard.dev/docs/cloud-integration) · [Sign up →](https://vguard.dev)\n\n## Sponsors\n\nThis project is maintained by [Solantic AI](https://github.com/solanticai) and funded by our sponsors.\n\n[Become a sponsor →](https://github.com/sponsors/solanticai)\n\n### Featured Sponsors\n\n\u003c!-- readme-sponsors-featured --\u003e\u003c!-- readme-sponsors-featured --\u003e\n\n### All Sponsors\n\n\u003c!-- readme-sponsors-all --\u003e\u003c!-- readme-sponsors-all --\u003e\n\n## Community\n\n- [GitHub Discussions](https://github.com/solanticai/vibe-guard/discussions)\n- [Contributing](CONTRIBUTING.md)\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [Security Policy](SECURITY.md)\n- [Changelog](CHANGELOG.md)\n\n## License\n\n[Apache 2.0](LICENSE) — Solantic AI\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolanticai%2Fvibe-guard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolanticai%2Fvibe-guard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolanticai%2Fvibe-guard/lists"}