Solvix Documentation

Fast, deterministic code intelligence for real repositories.

Solvix profiles the repository, ranks what matters, groups repeated signals into themes, and can optionally add AI explanation on top without putting AI in the critical path.

Get Started Open Guides

Windows

winget install Solvix.Solvix

Recommended global install for Windows users.

macOS

brew tap celpha2svx/solvix
brew install solvix

Recommended install for macOS once the tap is live.

Linux / Cloud

curl -fsSL https://github.com/celpha2svx/solvix/releases/latest/download/install.sh | sh

Recommended install for Linux, cloud servers, and generic Unix environments.

Quick Start

Common commands

solvix doctor
solvix analyze app.py
solvix analyze src --project
solvix analyze src --project --json --output report.json
solvix analyze src --project --ai-mode assist

Solvix is designed to be fast by default.

  • Deterministic analysis runs without API keys.
  • AI overlay is optional and post-processing only.
  • Use solvix doctor first if you want to confirm parser health.

Guides

Operational docs in this repo

Architecture Release Operations CLI UX and Release Readiness Smoke Tests Winget Readiness Project Intelligence Stage 1 Project Intelligence Stage 2 Project Intelligence Stage 3 Project Intelligence Stage 4 Project Intelligence Stage 5

AI Overlay

Optional, grounded, and failure-safe

The deterministic engine does not require an API key.

To enable the optional AI overlay:

export OPENAI_API_KEY="sk-..."
solvix analyze . --project --ai-mode assist
  • AI runs after deterministic analysis.
  • AI receives compressed structured inputs only.
  • If AI fails, deterministic reporting still succeeds.