anymousxe/axon-cli

<p align="center"<img src="docs/hero.svg" alt="AXON — intelligence at your prompt" width="100%"</p

<p align="center" <img src="https://img.shields.io/badge/Node-%E2%89%A518-5eead4?style=flat" alt="Node 18 or newer" <img src="https://img.shields.io/badge/dependencies-zero-60a5fa?style=flat" alt="Zero dependencies" <a href="LICENSE"<img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="MIT license"</a </p

A small, capable terminal companion for the Axon API. Stream a quick answer, keep a long-running conversation, attach a screenshot, or let Axon work with your files—with your permission. Linux, Windows, and macOS. One portable file. No runtime dependencies. Bring your own API key.

Axon 1.8 Flash concept film

A 24-second copper-core 3D ad, with a responsive interactive web edition and original synthesized audio. Download the 1080p film or run the interactive edition locally. The ad is independent of the CLI runtime.

v1.3 at a glance

| Feature | What you get | | --- | --- | | Permission-gated shell | Interactive tools on by default; reads/writes/commands still require approval | | Rich streamed Markdown | Code, bold, italic, strike, headings, links, lists, quotes, tables and syntax-colored fences | | Animated gradients | Truecolor hue drift and 12 fps active-only animation; plain/static fallbacks | | Tabbed inspector | Ctrl+T: session / usage / memory / tools, draft-safe keyboard navigation | | Completion | Slash commands/args, model names, efforts, image paths and tool-style path tokens | | Lock-in | Max effort, tools, up to 24 agent rounds, restored settings on exit | | Compaction | Automatic threshold + /compact; six recent turns retained; resumable summaries | | Everything retained | Thinking, images, chats/resume, memory, cost ledger, themes, dual SSE protocols |

ASCII preview (the live terminal colors the accents and animates while working):

axon > /lockin on
Lock-in ON - max effort - tools on - 24 rounds - approvals still required
[LOCKED-IN] axon-1.8-flash . max . ctx 38% . $0.0042 session
  >1[session] 2[usage] 3[memory] 4[tools]
  Refactor the parser
  Context: ~9120 / 24000 (38%)
  Lock-in: ON . 24 rounds
  Left/Right or 1-4 . q/Esc close . Ctrl+T toggle

Install

Install Node.js 18+ first (a current LTS release is recommended). The following install the versioned npm package from GitHub Releases, not the npm registry. No Git checkout, build tools, or sudo-executed installer scripts required. --allow-remote=root explicitly permits this direct download on npm 12+; older npm versions may warn about the extra option and can omit it.

Linux — Bash

npm install -g --allow-remote=root https://github.com/anymousxe/axon-cli/releases/download/v1.3.0/anymousxe-axon-cli-1.3.0.tgz

Windows — PowerShell

npm install -g --allow-remote=root https://github.com/anymousxe/axon-cli/releases/download/v1.3.0/anymousxe-axon-cli-1.3.0.tgz

Then run axon. First run opens a hidden-key wizard, validates your key with a tiny billable request, and saves it in your platform's private config directory. axon login replaces it later. If your PowerShell policy blocks npm's .ps1 shims, use npm.cmd and axon.cmd. On Linux, use a user-owned Node installation if your global npm prefix is not writable.

<details <summaryPortable single-file installation / running from source</summary

Download axon.mjs and run: