Your portable AI context. One identity across every tool.
pip install aura-ctx
PyPI Stars License

The Problem

Every AI tool builds a separate picture of who you are. Claude knows your stack. ChatGPT knows your preferences. Cursor reads your code. None of them share context. None of them let you export it.

aura scans your machine, builds your identity as structured YAML, and serves it to every MCP-compatible tool. One command. 30 seconds.

Quick Start

$ pip install aura-ctx
$ aura quickstart

✦ Scanning your machine...
Found: TypeScript, Python, Next.js, FastAPI, Cursor, Node.js
Projects: aura, kipedia, hotepia
✦ Pack saved: developer (12 facts)

✦ Starting MCP server on localhost:3847
Serving 3 context packs
Claude Desktop ✓ Cursor ✓ Gemini CLI ✓

That's it. Open any AI tool. It already knows you.

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 aura's server at localhost:3847.

Features

Auto-Scan

Detects languages, frameworks, tools, projects, editor, git identity from your machine.

Context Packs

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

MCP Server

Full Model Context Protocol server. Resources, tools, prompts. HTTP + SSE.

Import / Export

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

Deep Extraction

Extract facts from conversations using a local LLM via Ollama. Data never leaves your machine.

Pack Doctor

Detects bloat, stale facts, duplicates, missing rules. Health score 0–100.

Security

Token auth, scoped serving, read-only mode. Localhost only. No telemetry.

Local-First

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

Commands

CommandDescription
aura quickstartScan + onboard + configure + serve
aura scanAuto-detect your stack
aura onboard5 questions to capture your identity
aura serveStart MCP server
aura setupConfigure Claude, Cursor, Gemini, ChatGPT
aura listList all packs
aura show <pack>Display a pack
aura add <pack> <k> <v>Add a fact
aura doctorHealth check — bloat, stale, duplicates
aura export -f <fmt>Export to any format
aura import -s <src>Import from ChatGPT / Claude
aura extractLLM-based fact extraction
aura diff <a> <b>Compare two packs

Security

# Basic — localhost only
$ aura serve

# Token auth + read-only + scoped
$ aura serve --token s3cret --packs developer --read-only

Binds to 127.0.0.1 only. Optional Bearer token auth. Scoped pack serving. Read-only mode. AURA_TOKEN env var. No telemetry. No analytics. No cloud. Your files, your machine, your rules.

$ pip install aura-ctx
$ aura quickstart

GitHub · PyPI