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