Nerviq

Standardize and govern your AI coding agent setup — score, fix, and align across 8 platforms.

8 Platforms Supported

Nerviq audits, sets up, and governs AI coding agent configurations for 8 platforms:

10 Stack-Specific Languages

What Nerviq Does

Nerviq scores your AI coding agent setup from 0 to 100, finds what's missing, and fixes it — with rollback for every change.

  nerviq audit
  ═══════════════════════════════════════
  Detected: React, TypeScript, Docker

  ████████████████░░░░ 78/100

  ✅ CLAUDE.md with architecture diagram
  ✅ Hooks (PreToolUse + PostToolUse)
  ✅ Custom skills (3 skills)
  ✅ MCP servers configured

  ⚡ Top 3 Next Actions
     1. Add verification commands to CLAUDE.md
     2. Configure deny rules for dangerous operations
     3. Add path-specific rules in .claude/rules/

  Next: nerviq setup

Quick Start

npx @nerviq/cli audit              # Quick scan: score + top 3 actions
npx @nerviq/cli audit --full       # Full audit with all checks + badge
npx @nerviq/cli setup              # Generate starter-safe baseline
npx @nerviq/cli augment            # Improvement plan, no writes
npx @nerviq/cli governance         # Permission profiles + policy packs
npx @nerviq/cli benchmark          # Before/after in isolated copy

No install required. Zero dependencies.

Get Started by Role

2,431 Checks Across 96 Categories (8 Platforms × ~300 Governance Rules)

Harmony — Cross-Platform Alignment GA

Harmony detects drift between your AI coding platforms and keeps them in sync.

npx @nerviq/cli harmony-audit      # Cross-platform DX audit (0-100 harmony score)
npx @nerviq/cli harmony-sync       # Sync shared config across platforms
npx @nerviq/cli harmony-drift      # Detect drift between platform configs
npx @nerviq/cli harmony-advise     # Cross-platform improvement advice
npx @nerviq/cli harmony-watch      # Live monitoring for config drift
npx @nerviq/cli harmony-governance # Unified governance across platforms
npx @nerviq/cli harmony-add <platform>  # Add a new platform to your project

Synergy — Multi-Agent Amplification EXPERIMENTAL

Synergy analyzes how your platforms work together and finds amplification opportunities. Currently uses static routing rules — learned routing is planned for v2.0.

npx @nerviq/cli synergy-report     # Multi-agent synergy analysis

Synergy evaluates compound audit results, discovers compensation patterns (where one platform covers another's gaps), and ranks recommendations by cross-platform impact.

SDK — @nerviq/sdk BETA

Programmatic access to all Nerviq capabilities:

const { audit, harmonyAudit, synergyReport, detectPlatforms } = require('@nerviq/sdk');

const result = await audit('.', 'claude');
console.log(`Score: ${result.score}/100`);

const platforms = detectPlatforms('.');
console.log(`Active platforms: ${platforms.join(', ')}`);

const harmony = await harmonyAudit('.');
console.log(`Harmony score: ${harmony.harmonyScore}/100`);

MCP Server — nerviq serve

Nerviq ships with a built-in MCP-compatible HTTP server for integration with AI agents:

npx @nerviq/cli serve --port 3000

Endpoints:

• GET /api/health — Server health check
• GET /api/catalog — Full check catalog
• POST /api/audit — Run audit on a directory
• GET /api/harmony — Cross-platform harmony data

Plugin System — nerviq.config.js

Extend Nerviq with custom checks via a config file in your project root:

// nerviq.config.js
module.exports = {
  plugins: [
    {
      name: 'my-company-checks',
      checks: {
        internalDocs: {
          id: 'internalDocs',
          name: 'Internal docs present',
          check: (dir) => require('fs').existsSync(`${dir}/docs/internal.md`),
          impact: 'medium',
          category: 'Quality',
          fix: 'Add docs/internal.md with team-specific guidelines',
        },
      },
    },
  ],
};

See docs/plugins.md for full plugin API reference.

GitHub Action

Add Nerviq to your CI pipeline:

# .github/workflows/nerviq.yml
name: Nerviq Audit
on: [push, pull_request]

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: nerviq/nerviq@v1
        with:
          threshold: 60

The action outputs score, passed, and total for use in downstream steps. Fails the workflow if the score is below the configured threshold.

Certification

Earn a Nerviq certification badge for your project:

npx @nerviq/cli certify            # Run certification and display badge

Levels:

• Gold — Harmony score >= 80, all platforms >= 70
• Silver — Harmony score >= 60, all platforms >= 50
• Bronze — Any platform >= 40

All Commands

Options

Backed by Research

Nerviq is built on the NERVIQ knowledge engine — the largest verified catalog of AI coding agent techniques:

• 448+ research documents covering all 8 platforms
• 332+ experiments with tested, rated results
• 2,431 checks across 8 platforms (~300 unique governance rules × 8 platform adaptations), each with sourceUrl and confidence level (0.0-1.0)
• Every check is traceable to primary documentation or verified experiment
• 90-day freshness cycle: stale findings are re-verified or pruned

Safety Modes

Nerviq provides explicit safety controls so you decide what it can touch:

Every write command supports --snapshot for automatic backup before changes.

Privacy

• Zero dependencies — nothing to audit
• Runs locally — audit, setup, plan, apply, governance, benchmark all run on your machine
• Deep review is opt-in — only deep-review sends selected config for AI analysis
• AGPL-3.0 Licensed — open source

Links

• npm: @nerviq/cli
• GitHub: github.com/nerviq/nerviq
• Website: nerviq.net
• Discord: Join the community

If Nerviq helped you, consider giving it a ⭐ on GitHub — it helps others discover the project.

What Nerviq Is — and Isn't

Best for: Teams going from zero governance to a strong baseline — fast. If you're starting with AI coding agents or have a few platforms running without consistent configuration, Nerviq gets you to a governed setup quickly.

Not designed for: Deeply customized setups with 20+ skills, agent teams, and bespoke MCP integrations. If you've already built advanced agent workflows, you may not need this.

Strongest at: Agent configuration, workflow governance, repo policy hygiene, cross-platform alignment, and setup standardization.

Not a replacement for: Deep architectural review of business logic, runtime performance profiling, or security penetration testing. Nerviq focuses on how your AI coding agents are configured and governed — not on what your application code does.

Confidence levels: Every check includes a confidence score (0.0–1.0) and a sourceUrl linking to primary documentation. Checks marked heuristic are pattern-based and may produce false positives on non-standard project structures.

Feature maturity: