syrax-audit

Official command-line tool for Syrax Analyzer, the technical auditor and SEO SaaS. Audit your web applications locally for HTML structure, technical SEO, security, AEO, and accessibility issues.

It automatically generates copy-pasteable repair prompts and native rules files for Cursor, OpenCode, OpenChamber, Windsurf, Cline, Aider, and other AI coding assistants to fix detected errors autonomously.

🚀 Quick Start

Run the auditor on any web project directly without installing any package globally:

npx syrax-audit@latest

🧙‍♂️ Interactive Setup Wizard

The first time you execute the command in a new project, syrax-audit launches an interactive configuration menu in your terminal:

1. API Key: Setup your Premium API Key (automatically saved to .env).
2. Git Hooks: Automatically install Husky pre-push/pre-commit hooks to block commits with critical errors.
3. Execution & AI Autofix: Performs the audit and allows you to select which errors to patch.

🛠️ Key Features

• Universal Dev Server & Real-time Port Detection: Scans your package.json scripts, Django (manage.py), Laravel (artisan), Go (go.mod), Rust (Cargo.toml), and extracts local ports in real-time.
• Local Production Audits: Avoids development HMR/Vite false positives by compiling and launching a local production preview (pnpm run build + pnpm run preview) automatically.
• Interactive Issue Selector (Multiselect): Interactively check/uncheck individual issues via arrow keys and Spacebar to decide exactly which errors to patch.
• AI Autofix Integration: Generates native rules files (.cursorrules, .windsurfrules, .clinerules, copilot-instructions.md) for Cursor, Windsurf, OpenCode, OpenChamber, Codex, Kiro, Minimax, or executes autonomous CLI agents (Claude Code, Aider, agy) directly.
• Git Hook & CI integration: Prevent deployments with errors by executing syrax-audit --ci in your pre-push or pre-commit scripts.

📖 CLI Options & Flags

| Flag / Parameter | Description | | :--- | :--- | | --ci | Runs the CLI in Continuous Integration mode (non-interactive). Exits with code 1 if the audit fails. | | --category <name> | Runs only a specific audit category (e.g., seo, security, performance, accessibility). | | --format <json\|text> | Changes the console output format (defaults to interactive text formatting). | | --help | Outputs the list of available commands and flags. |

📄 Documentation

For full step-by-step guides and integrations:

• 🇬🇧 English CLI Guide
• 🇪🇸 Guía del CLI en Español