Astra is a persistent intelligence layer that lives in your terminal and understands your entire codebase — permanently.
Every other tool forgets you the moment you close the terminal. Astra never does.
It builds a living semantic graph of your codebase, remembers every decision ever made, traces bugs through time, protects your security, onboards your team, and gets smarter with every single commit. Free. Forever. Offline.
$ astra "why did we switch from REST to GraphQL in the user service?"
▸ In March you merged PR #47 — over-fetching issues on mobile.
Decision made by @sarah. Still 2 places using the old REST path.
Want me to clean those up?- System 2 Reasoning — dedicated thought loop that architects solutions before executing
- Search-Repair Loop — automatically searches for current syntax when uncertain
- Vibe Switching — modular personas (Architect, Brutal, Nigerian Pidgin, Doge)
- Mass Migration Engine — translates entire codebases between languages idiomatically
- Semantic Cleanup — post-migration engine that auto-detects and fixes structural drift
- Project Scaffolding — generates consistent boilerplates for your entire team
- Security Hunter — scans every file for secrets, SQL injection, unencrypted HTTP
- Semantic Bisect (
:bisect) — finds the exact commit that introduced a bug using natural language
- Distributed Task Manager — syncs team tasks across machines via a hidden git branch
- Productivity Metrics — tracks developer velocity, time per task, AI prompt history
- Cloud Sync — optional real-time sync via Supabase
- Onboarding Manager — acts as a programming tutor for junior developers
- Learning Phases — sets up structured learning paths and unlocks new levels via AI code review
- Predictive Refactoring — forecasts hot files, technical debt, and cross-language drift
- Semantic Cartographer (
:graph) — generates a full GraphViz dependency map of your codebase - Health Dashboard — live scores for Code Quality, Test Health, Security Surface, Team Velocity
- MCP Support — native bridge for Cursor and Claude Desktop
- Context Injection — auto-writes
.cursorrulesso AI editors know what you're working on - Watch Mode — real-time monitoring that triggers checks as you type
- Git Hook Sentry — blocks commits that lower health scores or introduce security risks
# Install via script (recommended)
curl -fsSL https://astra.sh/install | sh
# Or with Cargo
cargo install astra-cli
# Verify installation
astra --versionSupported platforms: macOS · Linux · Windows (WSL)
# Navigate to your project
cd your-project
# Initialize Astra
astra init
# Index your codebase
astra :index
# Check codebase health
astra :health
# Ask anything
astra "what is the most dangerous file in this codebase"
# Time travel debug
astra :bisect "when did the payment bug get introduced"
# Capture a bug, tie it to Git evidence, and queue a verified fix
astra :fix-bug "checkout returns 500 when the card is expired"
astra :issues
astra :issue astra-issue-<id>
# Migrate to another language
astra migrate --from typescript --to rustAstra can be the persistent project brain while multiple coding agents act as workers. Configure all three project-scoped MCP clients in one step:
:cowork init
Then queue work without launching it accidentally:
:delegate codex implement OAuth login with tests
:delegate claude review the checkout architecture
:delegate cursor build the settings UI
:jobs
To explicitly launch an installed headless worker CLI, use :dispatch:
:dispatch codex fix the flaky authentication tests
Workers share compact context, durable project decisions, job state, changed-file reports, and verification evidence through Astra MCP. Source files and full chat transcripts are not copied into memory.
Use :fix-bug when the input is a bug report rather than a known file edit. Astra records the report under .astra/issues, captures the current Git HEAD and branch, finds likely files and recent commit evidence, and creates a cowork job with a hard reproduction gate. No production file is changed during intake. A Codex, Claude Code, Cursor, or other MCP worker must first create a failing regression test or replay command, then implement and verify the fix. Use :issue <id> or the astra_issue_status MCP tool to inspect the evidence and worker state.
Astra works out of the box with Ollama (no API key needed). For cloud models, add your key:
# Use Ollama locally (free, offline, recommended)
astra config set model ollama/deepseek-coder
# Or bring your own key
astra config set api-key YOUR_GROQ_KEY
astra config set api-key YOUR_OPENAI_KEY
# Set your vibe
astra vibe nigerian-pidgin
astra vibe brutal
astra vibe architect╔══════════════════════════════════════════════════════╗
║ CODEBASE HEALTH REPORT ║
╠══════════════════════════════════════════════════════╣
║ Code Quality 99/100 ██████████ ━ ║
║ Security Surface 90/100 ██████████ ▲ (+12) ║
║ Cross-Lang Drift 75/100 ███████░░░ ▲ (+75) ║
║ Test Health 4/100 ░░░░░░░░░░ ━ ║
║ Git Health 42/100 ████░░░░░░ ▼ (-8) ║
║ Team Velocity 0/100 ░░░░░░░░░░ ━ ║
╠══════════════════════════════════════════════════════╣
║ TOP FIXES THIS WEEK ║
╠══════════════════════════════════════════════════════╣
║ 1. 6,681 uncommitted changes — commit or stash ║
║ 2. Test coverage critical — only 4/100 ║
║ 3. Low commit frequency — commit smaller, more often║
╚══════════════════════════════════════════════════════╝
| Language | Migration | Analysis | Security |
|---|---|---|---|
| TypeScript | ✅ | ✅ | ✅ |
| JavaScript | ✅ | ✅ | ✅ |
| Rust | ✅ | ✅ | ✅ |
| Go | ✅ | ✅ | ✅ |
| Python | ✅ | ✅ | ✅ |
| Java | ✅ | ✅ | ✅ |
| Kotlin | 🔜 | ✅ | ✅ |
"Every other AI tool is a smart stranger. Astra is the colleague who's been there since day one."
Astra doesn't write your code. It understands it. The distinction matters.
Writing code is easy. Understanding why it exists, what it connects to, what it will break, who built it, and what it will look like in six months — that's hard. That's what Astra does.
Astra is open source and contributions are welcome.
git clone https://github.com/ciphrnotfound/astra
cd astra
cargo build
cargo testSee CONTRIBUTING.md for guidelines.
- Core CLI + conversational interface
- Codebase indexing + language detection
- Cross-language migration engine
- Semantic memory system
- Health dashboard
- Time travel debugging (
:bisect) - Security hunter
- Team task OS
- MCP integration
- Vibe/persona system
- Cross-repo intelligence
- Global machine-wide graph
- Codebase simulation
- Astra Cloud dashboard
- VS Code extension
MIT © ciphr
Built with ❤️ and Rust · astra.sh