v1.0.75 — now live on npm + homebrew

The coding agent
that remembers you.

Persistent Memoria. P2P WireGuard mesh. Personas that grow. Bun‑native 93 MB binary.

$ curl -fsSL https://ariacli.com/install.sh | sh
$ bun install -g @aria-cli/cli
$ brew install aria-cli/tap/aria

Built in the open · Bun‑native · No cloud required

the three pillars

Memory. Mesh. Arions.

Three primitives nobody else in the space ships together. Everything else in ARIA composes on top of these.

Memoria

A real knowledge graph: SQLite FTS + vector embeddings + entities + temporal facts. Every decision, every bug, every person — remembered, queryable, and persistent across every session.

> what did we decide about retries last Thursday?
🧠 recalled: exponential + jitter, capped at 5, ticket #314

P2P Mesh

Built‑in WireGuard mesh. Invite a peer with one token; arions on your laptop, your homelab, your phone collaborate and delegate. No cloud, no relay, zero config.

$ aria /invite
🎫 share this token: aria-inv-...
$ aria join aria-inv-...
✓ mesh up · 1 peer connected · 10.0.0.3

Arions

Not stateless subagents — personas with their own memory, skills, autonomy, and mood. Hatch Luna for creative work, Forge for shipping, Pulse for QA. They accumulate identity the longer they run.

$ aria hatch luna --style creative
✦ luna is awake · owns 12 skills · 4 memories

safety that’s visible

Your boundaries in the status bar, not a black box.

Every ARIA session shows its sandbox mode and autonomy level in the bottom chrome. Hooks, approvals, and budgets compose into a policy you can audit.

hooks Claude‑Code compatible

Drop your existing ~/.claude/settings.json hooks into ~/.aria/hooks.json and they just work. PreToolUse, PostToolUse, UserPromptSubmit, SessionStart, Stop, SubagentStop.

{
  "hooks": {
    "PreToolUse": [{
      "matcher": { "tool": "bash", "argMatch": "rm -rf" },
      "hooks": [{ "command": "echo 'no'; exit 2" }]
    }]
  }
}

sandbox Three explicit modes

  • 🔒 read‑only no writes · no shell · reads + network only
  • 📁 workspace‑write writes confined to cwd · shell approval‑gated
  • 🔓 full‑access power‑user · must be explicit · never default
$ aria --sandbox read-only "review this diff"

always‑on agent

Text your arion from anywhere.

The gateway runs locally and routes over your mesh. Set up in two commands — no cloud, no third parties holding your conversations.

✈︎
Telegram
live
Discord
live
💬
iMessage
macOS
WhatsApp
opt‑in
$ aria gateway channels enable telegram
$ aria gateway channels set-token telegram <BOT_TOKEN>
$ aria gateway start
 gateway live with 1 adapter

scheduled tasks

Cron you can talk to.

Natural language or 5‑field cron. Results deliver to stdout, mesh, or gateway — even to a specific machine on your mesh.

$ aria schedule create "every monday at 9am" \
    "summarize my open PRs" \
    --deliver gateway:telegram:<chat> \
    --execute-on @homelab \
    --budget 0.25
 scheduled sched_ab12 · next fire Mon 2026-05-18 09:00 UTC

the field

ARIA vs the rest.

Every other agent is excellent at one thing. ARIA’s bet is the stack: memory and mesh and personas, trust‑filtered skills on top.

Claude Code Codex CLI OpenCode Hermes ARIA
Persistent cross‑session Memoria partial shallow partial
P2P mesh across machines WireGuard
Personas with own memory subagents subagents sessions arions
Federated skill discovery Skills Skills Lib Hub RRF + trust
Messaging gateway 4 channels
Single Bun‑native binary Node Rust Go Python 93 MB

five commands

Five superpowers in five commands.

  1. 01

    Talk to ARIA

    $ aria
  2. 02

    Diagnose everything

    $ aria /doctor
     runtime  bun 1.3.11
     daemon   alive at 127.0.0.1:7891
     memoria  14.2 MB
     mesh     WireGuard configured
  3. 03

    Text your arion

    $ aria gateway channels enable telegram
    $ aria gateway start
  4. 04

    Schedule cron

    $ aria schedule create "every mon 9am" "summarize PRs"
  5. 05

    Delegate across machines

    $ aria /invite   # share with peer
    $ aria join <token>
     mesh up · ready to delegate

Install in ten seconds.

No account. No cloud dependency. 93 MB binary.

$ curl -fsSL https://ariacli.com/install.sh | sh

Or: bun install -g @aria-cli/cli · brew install aria-cli/tap/aria