Ariava
Live Your Life. Your Agents Stay Close.
English | 简体中文
> [!WARNING]
> Ariava is early-stage. Breaking changes are expected.
## What is Ariava?
Agent loops are getting longer. An agent can run for hours on your computer — refactors, test suites, research, release notes — watching its progress like a foreman is a real waste of time; you should go do other things. When it finishes, or when it hits a decision only you can make, it'll come to you.
Ariava is an **Apple Watch-first agent companion**. The watch is the one screen that's always with you — wherever you are, notifications arrive on your wrist, and acting on them takes seconds:
- **Know when you're needed.** A tap on your wrist when an agent finishes or needs your judgment.
- **See what's happening.** Live session state — project, status, latest activity — at a glance, no laptop required.
- **Act from your wrist.** A short voice prompt is all it takes to steer your agent.
- **Privacy-friendly.** End-to-end encryption, always — the relay only forwards ciphertext.
Ariava isn't a terminal, and it isn't an agent. It's what lets you stop sitting next to them.
*Walk away from the desk — your agents will tap you when they need you.*
## Getting Started
Requirements:
- **Node.js 22+ and npm**
- **macOS**, or **Linux/WSL** with a systemd user manager
- **supported agent harness** — Pi (list keeps growing)
```bash
npx --yes ariava@latest setup
```
Install the Apple Watch app from [TestFlight](https://testflight.apple.com/join/EqhcRBp6), then pair:
```bash
ariava pair
```
## Usage
```bash
ariava status
ariava pair
ariava watches list
ariava logs
ariava upgrade
```
## Roadmap
- [x] Human Attention and Intervention
- [x] APN Notification
- [x] End-to-end encryption
- [ ] **In progress:** Session Management
- [ ] Project management
- [ ] Invoke new session
- [ ] More Harness Integration
- [ ] Summary and memory
## Architecture
```text
Apple Watch ↔ Relay ↔ Local Bridge ┬↔ Pi
├↔ DeepSeek
└↔ Codex
```
The Watch and the local Bridge exchange keys and pair through the Relay.
The Relay only forwards encrypted messages.
The Bridge gets live session states from harness plugins and keeps that state locally.
## Alerts and sessions
Two alerts:
- **Done** — a human needs to review the result.
- **Need human** — the agent needs a human to guide what to do next.
A **session** is a live projection of one conversation (name, project, status, latest activity), not a transcript. The Bridge encrypts that and sends it to the Watch. The Watch sends back only **reply** and **interrupt**.
## Identity
Host and Watch each carry **two** identities, not one:
- **Signing** — Ed25519. Proves who you are. Device IDs come from this public key.
- **Encryption** — X25519. Used with ChaCha20-Poly1305 for end-to-end encryption. The Relay only sees ciphertext.
Host keys are created by `ariava init`. Watch keys are created on the Apple Watch.
Pairing checks two different codes:
1. **Pairing code** — the Watch shows a short-lived code; run `ariava pair ` on the Host. This tells the Relay which Watch and Host to link.
2. **Safety Code** — both sides then show the same code. Confirm they match. Pairing is not done until you do. This checks that the encryption keys were not swapped in transit: the Relay forwards ciphertext, but it could still try to replace public keys. If the codes differ, cancel and pair again.
```bash
ariava identity status
ariava identity reset --confirm
```
Reset the Watch identity in the Watch app. Either reset replaces both identities on that device and clears old links; pair again after.
## Build from Source
```bash
git clone https://github.com/noyyyy/ariava.git
cd ariava
bun install --frozen-lockfile
bun run verify
```
Isolated source development (without touching an installed Bridge) is in [docs/prod-vs-dev-cli.md](docs/prod-vs-dev-cli.md).
## Contributing
Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
## Security
Report suspected vulnerabilities privately via [SECURITY.md](SECURITY.md). Never post identities, secrets, pairing material, or complete logs in a public issue.
## License
Licensed under the [Apache License, Version 2.0](LICENSE).