# Aura

> Aura is a semantic meta-layer for Git that tracks architectural intent and AST-level logic changes in codebases, providing safety and traceability for AI-generated code.

Aura is a semantic version control meta-layer that sits on top of your existing Git workflow to track Architectural Intent rather than raw text diffs. It grafts onto your local repository and uses AST (Abstract Syntax Tree) analysis to mathematically verify whether code logic has changed, making it purpose-built for teams using AI coding agents at scale. Aura does not replace Git — you keep your commits, branches, and push workflow — but gains AI-specific superpowers like surgical rewinding, hallucination isolation, and deep structural safety checks.

- **Semantic Time Machine** — *Surgical Rewind & Amnesia Protocol* lets you swap individual AST nodes and wipe bad AI-generated code from the LLM's chat context without causing massive merge conflicts.
- **Immutable Identity via Structural Skeleton Hashing** — *Prevents the Git renaming death spiral* by mathematically preserving logic identity regardless of symbol renames.
- **Wave Execution / Isolated Orchestration** — *Spins up fresh, isolated LLM contexts sequentially* to prevent context rot and guarantee hallucination-free generation across multi-file refactors.
- **Deep AST Traversal (The Gatekeeper)** — *Uses tree-sitter to mathematically prove* whether forbidden logic exists and instantly projects the blast radius of any change.
- **Zero-Trust Workspaces (Sovereign Vault)** — *Dynamically strips proprietary algorithms* from contractor workspaces and replaces them with type-safe logic stubs.
- **Architectural Deviation Blocking** — *Hard blocks merges* when AST analysis detects removal of verified security paths (e.g., missing `requireAuth()` calls), with manual override required.
- **Continuous DVR** — *Tracks every save-level logic decision* so when an AI hallucinates at minute 12, you can recover the good code from minute 1 without losing context.
- **Warn-and-Annotate Principle** — *Non-blocking by default* for architectural shifts; hard blocks reserved for plaintext secrets and forbidden production dependencies configured by the team.

To get started, install Aura via the one-line shell script (`curl -fsSL https://auravcs.com/install.sh | bash`) and run it inside any existing Git repository. Aura begins tracking semantic changes immediately without requiring any changes to your existing Git workflow.

## Features
- Semantic AST tracking over Git
- Architectural Intent recording
- Surgical Rewind & Amnesia Protocol
- Structural Skeleton Hashing for immutable identity
- Wave Execution isolated LLM orchestration
- Deep tree-sitter AST traversal
- Zero-Trust Sovereign Vault workspaces
- Architectural deviation merge blocking
- Continuous DVR for save-level logic history
- Blast radius projection
- Plaintext secret detection
- Warn-and-annotate mode for non-critical shifts

## Integrations
Git

## Platforms
LINUX, MACOS, WINDOWS

## Pricing
Open Source

## Version
0.2.0-alpha

## Links
- Website: https://auravcs.com
- Documentation: https://auravcs.com/docs
- Repository: https://github.com/Naridon-Inc/aura
- EveryDev.ai: https://www.everydev.ai/tools/aura-vcs