Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (aresfixer) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
AresFixer
🔱 Repository Intelligence & AI Agent Governance System
Empowering AI agents to understand, navigate, and safely modify any codebase.
Website • Dashboard • Documentation
What is AresFixer?
AresFixer is a repository intelligence and AI agent governance system that operates as an auxiliary layer on top of any software project.
| Capability | Description |
|---|---|
| 🔍 Reflection Index | Structural analysis of code (classes, functions, schemas, routes, imports) |
| 📊 Delta Intelligence | Change detection and impact analysis |
| 📋 Staleness Tracking | Detect outdated documentation and config drift |
| 🧠 Operational Memory | Command history with success/failure context |
| 🛡️ Agent Governance | Policies, workflows, checklists, and prompts for AI agents |
| 🔌 MCP Server | Model Context Protocol integration for AI IDEs |
| 🔒 License Management | Per-project licensing with online verification |
Installation
npm install -g aresfixerVerify the installation:
aresfixer --version
aresfixer doctorGetting Started
1. Authenticate
aresfixer loginOpens your browser for Google SSO authentication. Credentials are stored securely in your home directory.
2. Activate a License
aresfixer activateActivates a license for the current project. Each plan has a limit of simultaneous active projects.
3. Initialize Your Project
aresfixer initScaffolds the AresFixer governance and intelligence layer in your project. Run in any git repository.
4. Run the Analysis Pipeline
aresfixer rebuildRuns the full analysis pipeline: reflection indexing, change detection, impact analysis, staleness tracking, validation, and more.
5. Connect Your AI IDE
aresfixer mcp installAuto-configures the MCP server for VS Code, Cursor, or any MCP-compatible IDE. Your AI agent will have access to all AresFixer intelligence.
CLI Reference
Authentication & License
| Command | Description | Example |
|---|---|---|
aresfixer login |
Authenticate via browser (Google SSO) | aresfixer login |
aresfixer logout |
Remove stored credentials | aresfixer logout |
aresfixer whoami |
Show current authenticated user | aresfixer whoami |
aresfixer activate |
Activate license for current project | aresfixer activate |
aresfixer deactivate |
Revoke license, free up project slot | aresfixer deactivate |
aresfixer licenses |
List all your active licenses | aresfixer licenses |
aresfixer verify |
Verify license status online | aresfixer verify |
Project Setup & Management
| Command | Description | Example |
|---|---|---|
aresfixer init |
Scaffold AresFixer in your project | aresfixer init |
aresfixer init --force |
Re-initialize, overwrite existing files | aresfixer init --force |
aresfixer doctor |
Check environment health (Node, Git, npm) | aresfixer doctor |
aresfixer profile |
Detect project technology stack | aresfixer profile |
aresfixer update |
Update AresFixer scripts to latest | aresfixer update |
aresfixer update --dry-run |
Preview update without applying | aresfixer update --dry-run |
Analysis & Intelligence
| Command | Description | Example |
|---|---|---|
aresfixer rebuild |
Run full analysis pipeline | aresfixer rebuild |
aresfixer sync |
Smart sync (auto-detect changed files) | aresfixer sync |
aresfixer sync --zone agent |
Sync only a specific zone | aresfixer sync --zone code |
aresfixer sync --pending |
Process pending watcher changes | aresfixer sync --pending |
Available zones for --zone: agent, config, schema, code, infra, full
Validation & Quality
| Command | Description | Example |
|---|---|---|
aresfixer validate |
Run all validation checks | aresfixer validate |
aresfixer validate --refs |
Validate cross-references in .agent/ files | aresfixer validate --refs |
aresfixer validate --configs |
Validate configuration files | aresfixer validate --configs |
aresfixer validate --naming |
Validate file naming conventions | aresfixer validate --naming |
aresfixer gaps |
Detect missing governance files | aresfixer gaps |
MCP Server (AI IDE Integration)
| Command | Description | Example |
|---|---|---|
aresfixer mcp install |
Install MCP server in your IDE | aresfixer mcp install |
aresfixer mcp uninstall |
Remove MCP server from IDE | aresfixer mcp uninstall |
aresfixer mcp test |
Test MCP server connectivity | aresfixer mcp test |
Background Watcher
| Command | Description | Example |
|---|---|---|
aresfixer watcher start |
Start background file watcher | aresfixer watcher start |
aresfixer watcher stop |
Stop background file watcher | aresfixer watcher stop |
aresfixer watcher status |
Check watcher status | aresfixer watcher status |
aresfixer watcher pause |
Pause watcher during batch edits | aresfixer watcher pause |
aresfixer watcher resume |
Resume paused watcher | aresfixer watcher resume |
Self-Test
| Command | Description | Example |
|---|---|---|
aresfixer test |
Run positive test suite | aresfixer test |
aresfixer test --negative |
Run negative/edge-case tests | aresfixer test --negative |
Usage Examples
Daily Workflow
# Start your day — sync any changes since last session
aresfixer sync
# After making code changes — run targeted analysis
aresfixer sync --zone code
# Before committing — validate everything
aresfixer validate
# Check for governance gaps
aresfixer gapsFull Project Analysis
# First time or major changes — run everything
aresfixer rebuild
# Check what technologies were detected
aresfixer profileTeam Setup
# New team member joins — setup is simple
npm install -g aresfixer
aresfixer login
aresfixer activate
aresfixer mcp install
aresfixer rebuildLicense Management
# Check your current licenses
aresfixer licenses
# Verify license is valid and online
aresfixer verify
# Moving to a new project? Free up a slot
aresfixer deactivate
# Activate in the new project
cd /path/to/new-project
aresfixer activateMCP Server — AI IDE Integration
AresFixer exposes its full intelligence layer to AI agents via the Model Context Protocol (MCP) standard.
Once installed, your AI agent can:
- Search the codebase reflection index (classes, functions, schemas, routes)
- Analyze change impact and delta intelligence
- Read governance files, policies, and checklists
- Run pipeline stages and validation checks
- Track operational memory and predict failures
Supported IDEs
| IDE | Support |
|---|---|
| VS Code | ✅ Auto-configured |
| Cursor | ✅ Auto-configured |
| Windsurf | ✅ Auto-configured |
| Any MCP-compatible IDE | ✅ Manual setup |
License Plans
AresFixer offers tiered plans to fit your needs:
| Feature | Free | Pro | Enterprise |
|---|---|---|---|
| Projects | 1 | 10 | Unlimited |
| Commands | All | All | All |
| MCP Server | ✅ | ✅ | ✅ |
| Online Verification | ✅ | ✅ | ✅ |
| Offline Grace Period | 7 days | 14 days | 30 days |
| Team Members | 1 | 10 | Unlimited |
| Priority Support | — | ✅ | ✅ |
| Custom Governance | — | — | ✅ |
No feature restrictions — all CLI commands and MCP capabilities are available on every plan. Plans differ in project limits, team size, and support level.
Visit aresfixer.ai for plan details and pricing.
Environment Variables
| Variable | Description | Default |
|---|---|---|
ARESFIXER_ENV |
Override environment detection (dev, build, ci) |
Auto-detected |
ARESFIXER_AUTH_URL |
Override authentication server URL | app.aresfixer.ai |
Project Compatibility
AresFixer adapts automatically to any project type:
| Project Type | Support |
|---|---|
| NestJS + Prisma | ✅ Full |
| Next.js / React | ✅ Full |
| Python / Django | ✅ Reflection + Delta + Memory |
| Generic Node.js | ✅ Full |
| Any other | ✅ Core features (auto-detect) |
System Requirements
| Requirement | Version |
|---|---|
| Node.js | ≥ 18 |
| npm | ≥ 8 |
| Git | Any recent version |
| OS | Windows, macOS, Linux |
Troubleshooting
Common Issues
| Issue | Solution |
|---|---|
aresfixer: command not found |
Run npm install -g aresfixer |
Not logged in |
Run aresfixer login |
No active license |
Run aresfixer activate |
License limit reached |
Run aresfixer deactivate in another project first |
| MCP not connecting | Run aresfixer mcp test to diagnose |
doctor shows failures |
Install missing dependencies (Node.js ≥ 18, Git) |
Getting Help
# Built-in help
aresfixer --help
aresfixer <command> --help
# Environment check
aresfixer doctor
# License status
aresfixer verifyLinks
- 🌐 Website: aresfixer.ai
- 📊 Dashboard: app.aresfixer.ai
- 📖 Documentation: aresfixer.ai/docs
- 🐛 Issues: GitHub Issues
- 💬 Support: support@aresfixer.ai