aura — Portable AI Context
Description: One identity across Claude, ChatGPT, Cursor, and Gemini. Open-source CLI that makes your AI context portable via MCP.

✦ aura
Your portable AI context. One identity across every tool.
`pip install aura-ctx`

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

Command | Description
--- | ---
aura quickstart | Scan + onboard + configure + serve
aura scan | Auto-detect your stack
aura onboard | 5 questions to capture your identity
aura serve | Start MCP server
aura setup | Configure Claude, Cursor, Gemini, ChatGPT
aura list | List all packs
aura show <pack> | Display a pack
aura add <pack> <k> <v> | Add a fact
aura doctor | Health check — bloat, stale, duplicates
aura export -f <fmt> | Export to any format
aura import -s <src> | Import from ChatGPT / Claude
aura extract | LLM-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