getaura 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# Aura
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Aura helps you and your coding agent follow best practices while you vibe code, so your app stays secure, tested and ready to hand off.
+
+```sh
+npx getaura init
+```
+
+`init` checks git and the GitHub CLI, asks which coding agent you use (Claude Code, Codex, Cursor or Pi), drafts your product brief, installs the Aura skill and runs your first scan.
+
+## What you get
+
+- **An Aura score** from deterministic checks across security, agent setup, foundations and structure, explained in plain language.
+- **Next steps** in priority order: `aura next`.
+- **Fixes as pull requests you approve**: `aura apply foundation` puts your brief, agent rules, skills, CI and env example in place in one PR, and `aura fix <finding>` has Aura's agent make code changes on a branch.
+- **An agent that keeps it that way**: the rules and skills Aura installs teach your coding agent your standards, and GitHub Actions re-scans every push.
+
+Ask your coding agent: "Check my Aura score and fix the most serious issue."
+
+## Privacy
+
+Scanning runs on your machine and your repo is never uploaded. Only short, redacted excerpts needed for an explanation or fix go to the Aura API, and secrets are masked before anything leaves your machine.
+
+## Commands
+
+`init`, `scan`, `next`, `apply`, `fix`, `guide`, `inventory`, `history`, `summary`, `login`, `whoami`, `config`, `check-staged`. Run `aura <command> --help` for options.