Stop re-explaining yourself to every AI tool.
Define who you are — stack, style, rules — once, in plain YAML. aura serves your identity to Claude, ChatGPT, Cursor, and Gemini via MCP. 100% local. No cloud. No lock-in.
pip install aura-ctx
PyPI Downloads Stars License

Highlights

Quick Start

$ pip install aura-ctx
$ aura quickstart

Step 1/5 — Scanning your machine...
✦ Detected 12 facts about your dev environment

Step 2/5 — Quick questions about you...
✦ Created writer (2 facts, 3 rules)
✦ Created work (2 facts, 0 rules)

Step 3/5 — Configuring AI tools...
✦ Claude Desktop configured
✦ Cursor configured

Step 4/5 — Security audit...
✦ All clean — no secrets detected

Step 5/5 — Starting MCP server...
✦ http://localhost:3847/mcp
Restart your AI tools — they know you now.

30 seconds. No Docker. No database. No cloud account.

Works With

Claude Desktop Streamable HTTP
Auto-configured
Cursor IDE Streamable HTTP
Auto-configured
Gemini CLI SSE
Auto-configured
ChatGPT SSE / Dev Mode
Manual setup

Any MCP-compatible client can connect to localhost:3847.

What's MCP? — An open standard that lets AI tools connect to local data sources.

Templates

14 built-in templates. Each includes facts and AI rules tailored to the profile.

frontendReact, Next.js, Tailwind
backendFastAPI, SQL, Docker
data-scientistpandas, PyTorch, Jupyter
mobileReact Native, Swift
devopsK8s, Terraform, AWS
ai-builderLangChain, RAG, agents
founderMVP, speed, product
studentLearning, step-by-step
marketerCopy, SEO, growth
designerUX, Figma, a11y
developerGeneral dev context
writerTone, style, audience
researcherMethodology, sources
workRole, company, team
$ aura create mydev -t frontend
$ aura show mydev

Features

Auto-Scan

Detects languages, frameworks, tools, projects, editor, git identity. Incremental — only re-scans what changed.

Context Packs

Scoped YAML files — developer, writer, work. Typed facts with confidence levels.

MCP Server

Full Model Context Protocol. Resources, tools, prompts. HTTP + SSE. 3-level token delivery.

Secret Scanning

Detects 30+ patterns (AWS keys, GitHub tokens, API keys). Auto-redacts before serving to LLMs.

Import / Export

Import from ChatGPT & Claude. Export to system-prompt, cursorrules, and more.

File Watcher

aura serve --watch hot-reloads when you edit a YAML pack. Zero restart.

Pack Health

Doctor detects bloat, stale facts, duplicates, secrets. Consolidation engine merges duplicates. Memory decay with TTL.

Local-First

No cloud. No database. No Docker. YAML files on your machine. You own everything.

Commands

CommandDescription
aura quickstartScan + onboard + setup + audit + serve
aura scanAuto-detect your stack
aura onboard5 questions to capture your identity
aura serveStart MCP server
aura serve --watchStart with hot-reload on YAML changes
aura setupConfigure Claude, Cursor, Gemini
aura templatesList all 14 templates
aura create <n> -t <t>Create pack from template
aura listList all packs
aura show <pack>Display a pack
aura add <p> <k> <v>Add a fact
aura doctorHealth check — bloat, stale, secrets
aura auditScan for leaked API keys and tokens
aura audit --fixAuto-redact critical secrets
aura consolidateMerge duplicates, find contradictions
aura decayRemove expired facts (type-aware TTL)
aura export -f <fmt>Export to any format
aura import -s <src>Import from ChatGPT / Claude
aura diff <a> <b>Compare two packs

Security

# Basic — localhost only
$ aura serve

# Full lockdown
$ aura serve --token s3cret --packs developer --read-only --watch

Binds to 127.0.0.1 only. Optional Bearer token auth. Scoped pack serving. Read-only mode. Secret scanning with auto-redaction at serve time. No telemetry. No analytics. No cloud.

7,800+ lines · 151 tests · 22 commands · 14 templates · MIT

$ pip install aura-ctx
$ aura quickstart

GitHub · PyPI · Contribute