aura — Your portable AI identity
Description: Stop re-explaining yourself to every AI tool. Define your identity once in YAML, serve it to Claude, ChatGPT, Cursor, and Gemini via MCP. Open source.

✦ aura
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`

## Highlights

- 30-second setup — scan, onboard, configure, serve in one command
- 14 templates — frontend, backend, data-scientist, founder, student, and more
- Cross-tool — Claude, ChatGPT, Cursor, Gemini, any MCP client
- Smart token delivery — 3 levels so AI tools only load what they need
- Secret scanning — catches leaked API keys before they reach an LLM
- File watcher — hot-reload when you edit a YAML pack
- No cloud, no telemetry — YAML on your machine, fully editable

## 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.

`frontend`React, Next.js, Tailwind
`backend`FastAPI, SQL, Docker
`data-scientist`pandas, PyTorch, Jupyter
`mobile`React Native, Swift
`devops`K8s, Terraform, AWS
`ai-builder`LangChain, RAG, agents
`founder`MVP, speed, product
`student`Learning, step-by-step
`marketer`Copy, SEO, growth
`designer`UX, Figma, a11y
`developer`General dev context
`writer`Tone, style, audience
`researcher`Methodology, sources
`work`Role, 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

Command | Description
--- | ---
aura quickstart | Scan + onboard + setup + audit + serve
aura scan | Auto-detect your stack
aura onboard | 5 questions to capture your identity
aura serve | Start MCP server
aura serve --watch | Start with hot-reload on YAML changes
aura setup | Configure Claude, Cursor, Gemini
aura templates | List all 14 templates
aura create <n> -t <t> | Create pack from template
aura list | List all packs
aura show <pack> | Display a pack
aura add <p> <k> <v> | Add a fact
aura doctor | Health check — bloat, stale, secrets
aura audit | Scan for leaked API keys and tokens
aura audit --fix | Auto-redact critical secrets
aura consolidate | Merge duplicates, find contradictions
aura decay | Remove 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