UACOS

UACOS is a local-first code intelligence, context-compression, and release-gate toolkit that makes AI-assisted changes to a repository safer and cheaper — typed project memory, dependency-graph impact analysis that scopes changes before they're made, patch-scope safety gates, secret scanning, transaction rollback, an LLM cache/budget layer, and a built-in MCP server, all running locally with no cloud dependency.

Requirements

• Python 3.9+

• Optional: Ollama for local real-model evaluation

Related MCP server: Sverklo

Quick Start

python -m pip install -e .
python -m uacos.cli init --repo .
python -m uacos.cli auto --repo . --summary

Expected output:

$ python -m uacos.cli init --repo .
UACOS initialized in .
$ python -m uacos.cli auto --repo . --summary
{
  "status": "pass",
  "mode": "auto_once",
  "selected_file_count": 4,
  "compressed_tokens_est": 1650,
  "tokens_saved_est": 4702,
  "savings_percent": 74.02
}

What you get

• reports/uacos_performance_report.json with token savings: 4,702 saved tokens (74.02%)

• reports/uacos_auto_report.json for Auto Mode summary

• reports/release_gate_report.json for release readiness checks

• uacos/ package and CLI entrypoint installed via uacos

• docs/ and CHANGELOG.md for published project onboarding

Links

• User Guide

• Auto Mode

• Autopilot Mode

• Installation

• Security Model

• Troubleshooting