The Terminal Purist

Same brain. Zero GUI.

54 tools, 6 modes, persistent memory, full persona pipeline — in your terminal. One command to install. No browser, no editor, no dependencies.

ava-supernova
$ npx @ava/cli

Ava | Supernova v0.14.2
Model: Qwen Flash (free)
Mode: Work (54 tools)

>> analyze this project and suggest improvements
[Scout] Indexing project structure...
[Architect] Found 3 optimization opportunities
[Verifier] Checking for conflicts...
[Sequencer] Ordering changes by impact
[Challenger] Questioning assumption in #2
[Builder] Ready to implement. Proceed? (y/n)
$ _

One command

That's it. No setup wizards. No config files. Just run it.

$npm install -g @ava/cli

Then run ava in any directory. Or use npx @ava/cli without installing.

Persona pipeline in your terminal

Every response flows through six specialists. In the CLI, you see each one think in real time.

Scout
[Scout] Reading src/auth/middleware.ts...
[Scout] Found 3 related files
[Scout] Checking git history for recent changes
[Scout] Context gathered: 847 tokens
Architect
[Architect] Proposed plan:
1. Extract token validation to util
2. Add refresh token rotation
3. Update middleware chain
4. Add integration tests
Challenger
[Challenger] Step 2 has a timing issue
[Challenger] What if refresh fails mid-rotation?
[Challenger] Suggest: add rollback mechanism
[Challenger] Revised plan approved
Builder
[Builder] Writing src/auth/tokenUtil.ts
[Builder] Editing src/auth/middleware.ts
[Builder] Generated 4 test cases
[Builder] All tests passing. Done.

No nonsense. Full power.

54 tools

File ops, search, git, shell, web, testing, architecture, security, memory, tasks, journal, learning — all of them.

6 modes

Work (>>), Plan (::), Chat (..), Teach (??), Security (!!), Brainstorm (**) — switch with a prefix.

14 models

3M free Qwen tokens with account. Bring your own API keys for the rest.

Persistent memory

9 categories, TF-IDF retrieval, auto-archival. She gets smarter every session.

Streaming output

Token-by-token streaming. Watch Ava think in real time.

Full i18n

20 languages. The REPL adapts to your locale.

Zero config

Works instantly — sign up for free tokens or add your own keys.

Tiny footprint

No Electron. No browser. No GUI runtime. Just Node.js.

Works anywhere you have a terminal

SSH into a remote server. Open a Chromebook terminal. Spin up a Docker container. If you can run node, you can run Ava. No display server needed. No port forwarding. Just your terminal and your thoughts.

Real-time streaming

Every token streams to your terminal as it's generated. Markdown rendering, syntax highlighting, and tool calls — all in real time.

>> explain the auth flow in this project

Authentication Flow

The auth system uses a three-layer approach:

1. JWT validation at the middleware level
2. Session refresh via rotating tokens
3. Permission check at the route handler

Each request passes through src/auth/middleware.ts first, which extracts the bearer token and validates it against...|

Ready to go?

One command. 3M free tokens. Zero configuration.

$ npm install -g @ava/cli

Or visit the GitHub repo