Nerviq

The intelligent nervous system for AI coding agents — audit, align, and amplify every platform on every project.

8 Platforms Supported

Nerviq v1.0 ships with full audit, setup, governance, and benchmark support for 8 AI coding platforms:

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              # Score your project (10 seconds)
npx @nerviq/cli audit --lite       # Quick top-3 scan
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.

673 Checks Across 14 Categories

Harmony — Cross-Platform Alignment

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

Synergy — Multi-Agent Amplification

Synergy analyzes how your platforms work together and finds amplification opportunities.

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

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 CLAUDEX knowledge engine — the largest verified catalog of AI coding agent techniques:

• 315 research documents covering all 8 platforms
• 100+ experiments with tested, rated results
• 673 checks 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

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

Previously claudex-setup

Nerviq was previously published as claudex-setup. If you were using it:

# Old
npx claudex-setup

# New
npx @nerviq/cli audit

All features are preserved and expanded.