Avvarre
Avvarre
Loading 650+ rules...

An ecosystem for

agentic dev.

Avvarre
terminal
$
Star on GitHubSponsorFuture →
PythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngularPythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngularPythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngularPythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngularPythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngularPythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngularPythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngularPythonJavaScriptTypeScriptJavaGoC++KotlinShellSwiftObjective-CC#DartRHTMLCSSMarkdownJSONXMLVimscriptLispAngular
01 / LONG-TERM AI MEMORY

AI Context that Survives the Chat Window.

Avvarre pairs version-controlled .avvarre/ state files with a fast, long-term memory.db SQLite vector engine—enabling hybrid RRF search, 180-day retention sweeps, and privacy redaction across chats and team handoffs.

Git-Versioned Repo Memory

.avvarre/ directory
REPO STATE

Stores current session target states, active task checklists, team conventions, and project context directly inside your Git tree—ensuring branch switches and team handoffs carry instant agent context.

.avvarre/context.mdProject purpose, architecture, and tech stack signature
.avvarre/conventions.mdCustom styling rules, error classes, and coding patterns
.avvarre/tasks.mdCompressed Task Protocol ([x], [/], [ ]) for AI handoffs
.avvarre/session-log.mdCross-developer session summary & pending targets

SQLite Long-Term Store

memory.db (node:sqlite WAL)
VECTOR STORE

High-performance long-term memory engine running locally with zero cloud dependencies. Combines FTS5 full-text search, 384d vector embeddings (`Xenova/all-MiniLM-L6-v2`), and exponential time decay.

FTS5 + Vector Hybrid
RRF k=60 Fusion
Deduplication Engine
5m Window + 0.92 Cosine
Time Decay Multiplier
69d Half-Life exp(-0.01)
Retention Sweep
180d Low Strength Clean
Supports AVVARRE_LIGHT=1 for offline/low-RAM CI environments (skips vector model, uses FTS5-only BM25).
02 / AST GRAPH, SCORING & MCP ENGINE

The Avvarre Architecture.

Recursive CTE Engine

Calculate Blast Radius Before the Commit.

Tree-sitter parses 15 languages into SQLite dependency graphs, tracing upstream caller impact instantly.

AST Dependency Query ResultSQLite CTE: < 4ms
Depth Hops
5 Hops
Impacted Files
14 Files
Risk Multiplier
4.8 (High)
$ avvarre query --blast-radius src/auth/jwt.ts
✓ Edge Resolution: IMPORTS_FROM, CALLS, INHERITS
✓ Safety Index: Verified. 0 circular dependency cycles detected.
03 / MONOREPO & AIRGAPPED ENGINE

Scale from Single Scripts to Massive Monorepos.

Avvarre resolves localized package contexts across monorepos, auto-detects stack signatures to fetch curated skills, and runs in airgapped CI/CD runners with AVVARRE_LIGHT=1 mode.

MONOREPO PACKAGE RESOLUTION TREE:

Localized Context: apps/web

Manifest: package.json | Stack: Next.js 16 + TypeScript + Tailwind
ISOLATED MEMORY SANDBOX

Avvarre dynamically resolves root workspace heuristics vs localized package .avvarre/ states—preventing cross-package context pollution in TurboRepo, Nx, Lerna, and Cargo monorepos.

AUTOMATICALLY LOADED SKILL BUNDLES:
nextjs-agent-rules react-19-conventions typescript-strict
PACKAGE CONTEXT & TASK FILES:
apps/web/.avvarre/context.md
SSR hydration, React Server Components architecture
apps/web/.avvarre/conventions.md
Strict UI component naming & Vanilla CSS rules
apps/web/.avvarre/tasks.md
Active web client checklist & handoff state
AVVA
RRE

Consistencymatters.
Keepcontextaligned.

Avvarre acts as a local source of truth. It tracks context, conventions, and tasks directly in git so that your AI assistant stays aligned with your standards.

Ready to upgrade your AI context?

Get started with Avvarre in seconds. No complex configurations needed.

$ npx -y avvarre@latest install