Open source · MIT · Runs on your machine

Your coding agent. Your personal assistant.

Angelia turns the coding agent CLI you already know and trust into the brain of your personal assistant. It lives in your WhatsApp and Telegram, runs on your own machine, and works with your tools and your subscription.

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

Quick start View on GitHub

Alpha · macOS · Open source

In Greek myth, Hermes carried the words of the gods. His daughter Angelia carried only the message: not the wisdom, not the decision. Just the promise that what is said in one place arrives whole in another.

That is the whole job.

Why

Two ways people use it.

Turn it into a personal assistant.

Give each part of your life its own chat and its own folder: family, money, a side project. Each one gets its own instructions and memory. All on the subscription you already pay for.

Keep working away from the desk.

Ask why the build failed from the train. Approve the fix from the couch. The agent works on your machine with everything you set up. You just talk to it.

How it works

One chat, one folder.

Every chat gets its own folder and its own session. One YAML file says which is which, and the setup wizard writes it for you.

side-projectyou, Angelia

Why did last night's build fail?

The date parser test fails on the day the clocks change. The fix is one line in src/date.ts. Apply it?

Yes, and run the tests

🔐 Bash: npm test
reply yes 6b480a6f or no 6b480a6f

yes 6b480a6f

38 tests green. Pushed to fix/dst.

Install and pair.

Run the installer, pick your CLI, send the bot a message. That chat is now connected.

Point it at a folder.

The agent opens in that folder and uses what it finds there: instructions, settings, MCP servers. Exactly like in your terminal.

Talk to it.

Text, voice notes, photos, files. Before anything risky, the agent asks you in the chat.

profiles:
  coding:   { cwd: ~/agents/coding, permission_mode: acceptEdits, shell: true }
  family:   { cwd: ~/agents/family, permission_mode: acceptEdits }
  research: { cwd: ~/agents/research, effort: high }

routes:
  - { platform: telegram, chat: 111111111,      profile: coding }
  - { platform: whatsapp, chat: "1203…@g.us",   profile: family, owners: ["1555…"] }
  - { platform: telegram, chat: 222222222,      profile: research }
# angelia init writes the first route. With onboarding on, a new chat adds its own.

What it does today

Built for chat, not a terminal.

Every chat remembers

Each chat keeps its own session, even after a restart. /new starts fresh.

Quiet in groups

It answers only when mentioned, and only to people you allow. Strangers get nothing.

You approve risky steps

Before a risky command, the chat asks. You reply yes or no. No reply means no.

Voice notes and files

Send a voice note, a photo or a PDF. The agent can answer with a voice note too.

New group, new assistant

Turn onboarding on, then mention the bot in a new group. It sets up its own folder and asks what the group is for.

Scheduled check-ins

A morning summary, a weekly report. Your OS runs the schedule; the answer lands in the chat.

Scriptable

angelia send posts to any of your chats from a script. angelia turn asks the agent.

No surprise bills

API keys are kept out of the agent's environment, so no chat can switch it to a per-token bill.

By design

Not another AI assistant.

Other assistants ask you to learn a new agent, with its own model, skills and memory. Angelia does not add a brain. It gives the one you already know a phone, a schedule and a place for each part of your life.

No second model.Angelia runs no AI of its own. Not even for speech.
No middleman.Your machine, your chat app, your CLI's own provider. No Angelia server, no telemetry.
No new bill.Your CLI, your account, your subscription.
Nothing to relearn.Skills, MCP servers and memory stay in your CLI.
Plain files.One YAML file. The wizard only writes what you could write by hand.
Open source.MIT license. Read every line.

Backends

Works with the CLI you use.

Supported today: Claude Code and Grok Build. Coming soon: Codex, pi and OpenCode. Every CLI plugs into the same interface.

CLI	Status	Speed
Claude Code `backend: claude-code`	today	One warm process per chat. One to two seconds a turn.
Grok Build `backend: grok`	today	One warm process per chat. Three to six seconds a turn.
Codex, pi, OpenCode	coming soon	Same interface.

You already have the brain. Give it a chat.

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

Every release is signed. Key SHA256:74hZgwt/ABiUQz6C9A1r7hpHZtCRq1KfC1KvvCR1ys0