forge-aura 0.1.0

Aura — local-first, model-agnostic AI software development environment

Aura

Aura is a local-first, model-agnostic AI software development environment. It runs as a daemon on your machine, indexes a project, and surfaces grounded answers and code changes through the Aura VS Code extension (and a secondary browser surface at http://localhost:<port>/).

This package (forge-aura) is the daemon and CLI. The user-facing local surface is the Aura VS Code extension (aura.aura-vscode), installed separately from the Visual Studio Code Marketplace.

Status

Pre-1.0. The bridge-layer contract (the path from install to a real natural-language code change in VS Code) is the current bar; see the project's acceptance-gate spec for what's proven end-to-end. APIs, presets, and surfaces may change between minor versions.

Install

pipx install forge-aura

Then install the Aura extension from the Visual Studio Code Marketplace, open a folder in VS Code, and let onboarding configure your provider keys and routing preset.

Quick start

aura serve --daemon         # start the local daemon
aura status                 # show daemon + project state
aura stop                   # stop the daemon cleanly

In VS Code, open the Aura activity-bar view to reach the project picker; first-run takes you through onboarding (provider keys + routing preset) before any project is shown.

Local-first by design

• API keys are stored in your user state directory (mode 0600), never in YAML, never echoed back.
• No telemetry by default. No team server. No cloud Brain.
• Deleting your local state directory leaves your project a perfectly valid repo; Aura can re-bootstrap it from the open flow.

Requires

• Python 3.11+ (3.12 recommended)
• A configured frontier-provider key for at least one of the supported routing presets (balanced, dev_default)

License

See LICENSE in the source distribution.