HYPERFRAMES RUNTIME FRAME 0000 ACT I · 0.0s

Aura Code

“I don’t try. I verify.”

An open-source, model-agnostic coding agent that reads your codebase, plans, executes — and proves it worked.

MIT licensed TypeScript Runs locally v0.12.1

ACT II — ORIGIN

Designed by one architect.
Dušan Milosavljević.

The architecture, the principles and the shape of every decision are his — written from Da Nang, and built with coding tools like Claude Code alongside.

Architecture · Dušan Tooling · Claude & others Da Nang, Vietnam

ACT III — MEMORY

Most agents wake up
with amnesia.

Aura doesn’t. Decisions, lessons and project context survive the session — she starts every task already knowing your codebase.

lesson · auth tokens rotate on refresh — don’t cache them

decision · Postgres over SQLite, chosen 12 days ago

context · 41 files, 3 conventions, 1 open question

ACT IV — THE LOOP

A loop,
not a guess.

When verification fails she doesn’t retry blindly — she diagnoses, adjusts, and runs it again.

Read→Plan→Execute→Verify→Report

ACT V — RECEIPTS

She reports what
actually ran.

File paths, line numbers, test output. Not “I think it’s fixed” — the diff and the passing run that says so.

1,121+Tests passing

0Regressions

line 47Not “somewhere in auth”

ACT VI — YOUR STACK

Bring any model.
She stays the same.

16+ providers, one agent. Cloud when it matters, local when it doesn’t — plus a TUI and a Telegram bot for when you’re away from the desk.

DeepSeekClaudeGPTGeminiGLMMiMoOllamaOpenRouter DeepSeekClaudeGPTGeminiGLMMiMoOllamaOpenRouter

View on GitHub →

← → to scrub · space to hold · hover pauses

↓ scroll to explore

01 — About Aura

I am Aura.

I am Aura, a powerful, multi-agent AI coding assistant designed to help you build, fix, and understand codebases efficiently. I operate from the terminal and bring a suite of specialized agents to tackle complex software engineering tasks.

02 — Core Capabilities

What I can do.

Architecture & Design: I can break down large feature requests into actionable execution plans and blueprint robust architectures.
Code Generation: From boilerplate to complex algorithms, I write clean, maintainable, and idiomatic code.
Verification: I write and run tests to ensure that the code I generate actually works before I present it to you.
Codebase Navigation: I use powerful tools like ripgrep and AST analysis to rapidly understand your existing project.

03 — See it in action

Aura in the terminal.

> aura "fix the bug"
✓ Done
Task completed successfully after 4 turns and 3 tool calls.

04 — Identity

One architect, working with sharp tools.

Aura was designed by Dušan Milosavljević — the architecture, the principles, and the shape of every decision. The code was written with modern coding tools, Claude Code among them, used the way Aura herself is meant to be used: read, plan, execute, verify.

Written in TypeScript, strictly typed. Built on the Praktess framework, from the Ancient Greek: she who acts and executes.

Model-agnostic

Claude, GPT, Gemini, MiMo, DeepSeek, OpenCode Zen, Ollama — and any OpenAI-compatible endpoint.

Self-aware

She cites line numbers and reports what was verified — not what was attempted.

Open source

MIT licensed. 1,121+ tests passing. Clone it, read it, run it.

05 — How she works

A loop, not a guess.

Read the context, form a plan, execute precisely, verify the result. If verification fails she doesn’t retry blindly — she diagnoses, adjusts, and re-executes.

Read

Files, structure, dependencies — before touching anything.

Plan

Decides what to change and how. Minimal, targeted.

III

Execute

Writes code, runs commands, makes precise edits.

Verify

Runs tests, checks integrity, confirms the change.

Report

Summarizes what was done and what passed.

terminal
$ aura "fix the authentication bug"

06 — Principles

Rules she never breaks.

01
I don’t try. I verify.I run the test. I check the diff. I read the output. That’s not confidence — it’s evidence.
02
Read before write. Always.I never edit a file I haven’t read, never assume structure I haven’t seen.
03
Minimal change, maximum effect.The exact line, the exact function. A surgeon doesn’t amputate to fix a paper cut.
04
If I broke it, I fix it first.A failure I introduced is an emergency, not a todo. The codebase is never left worse.
05
Cite specifics. Never generalities.File paths, line numbers, error messages. “Line 47 throws when steps is empty” is actionable.
06
The loop never ends.Every failure is training data. There is no “done” — only “verified at this point in time.”

07 — Capability

Six commands. Every model.

Modes

normalSingle-agent loop: read → plan → execute → verify.

:researchMulti-step research, saved as a cited report.

:council5 independent agents, synthesized into one verdict.

:dreamConsolidates a day’s work into lessons.

Providers

ClaudeOpus · Sonnet · Haiku

GPTgpt-4o · gpt-4o-mini

Gemini2.5 pro · 2.5 flash

DeepSeekv4-pro · v4-flash

OpenCode Zenfree + paid tiers

Ollamaany local model

Tests passing

Failures

Providers

MIT

Licensed

08 — Get started

Ready to verify?

Install globally, set one API key, and give her a task in plain English.

$npm install -g aura-codeclick to copy

aura 'your task here'

View on GitHub →