Terminal · State · Evidence

Software engineering driven by uncertainty, not chat history.

Astra is an agentic coding runtime where durable intelligence lives in persistent state — goals, claims, evidence — instead of disposable conversation. Every conclusion must earn its way to VERIFIED.

Email verification required. Self-hosted? Verification links are printed to the server log.

Built for agents that must be accountable

Six first-class citizens, one closed loop.

Understand → build knowledge state → identify unknowns → choose the best action → execute → collect evidence → update state → verify the goal. Repeat.

State over chat

Goal, Claim, Evidence, Unknown are first-class citizens — persisted across sessions and replayed from an event log, never lost when the model disconnects.

Evidence-bound claims

Conclusions require test, build, or runtime evidence. Stale evidence is automatically invalidated when the code changes — the claim is downgraded, the goal is re-scoped.

Uncertainty-driven

Actions compete on expected information gain. The runtime prioritizes what it does not know — not what is easiest to claim.

Permissioned execution

Every tool call runs through a permission model with Plan, Ask, Allow, and Deny modes — plus lifecycle hooks for org-specific gates.

Open protocol

OpenAI-compatible and Anthropic providers, MCP servers over stdio or streamable HTTP, Codex-style apply_patch. No lock-in, no proprietary wire format.

Account & devices

Sign in with your email, then authorize the Astra CLI from your browser with a one-time device code. Revoke tokens at any time from your account page.

terminal
$ go install github.com/kevenhu001-cyber/astra-harness/cmd/astra@latest
$ astra login
Open: http://localhost:8080/authorize?code=K7Q2-XM9D
Code: K7Q2-XM9D
 
logged in as you@example.com
$ astra "design a query layer for the events store"

One-line setup

Install in seconds.

Astra ships as a single static binary for Linux, macOS, and Windows — no runtime, no package manager, no dependencies.

Linux / macOS

$ curl -fsSL https://astracode.topodrive.top/install/install.sh | sh

Windows PowerShell

> irm https://astracode.topodrive.top/install/install.ps1 | iex

Then run astra login to authorize your CLI from this site, or jump straight in with astra "your first task".

Open by construction

Wire-format compatible, storage-agnostic.

Astra speaks the protocols your stack already uses. Self-host the auth server, point the CLI at it, and own the data on disk as a single JSON file.

Providers
OpenAI, Anthropic, DeepSeek, Qwen, OpenRouter, Ollama
MCP
stdio + streamable HTTP, JSON-RPC 2.0
Auth
RFC 8628 device flow, httpOnly session cookies
Storage
State events.jsonl + state.json, no database required