---
slug: "ariava-pi-extension"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/noyyyy/ariava@main/README.md"
repo: "https://github.com/noyyyy/ariava"
source_file: "README.md"
branch: "main"
---
<p align="center">
  <img src="https://raw.githubusercontent.com/noyyyy/ariava/main/ariava.png" alt="Ariava" width="160" height="160">
</p>

<h1 align="center">Ariava</h1>

<p align="center"><strong>Live Your Life. Your Agents Stay Close.</strong></p>

<p align="center">
  <a href="https://www.npmjs.com/package/ariava"><img src="https://img.shields.io/npm/v/ariava?style=flat-square&label=npm" alt="npm version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="Apache 2.0 license"></a>
  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%2FWSL-lightgrey?style=flat-square" alt="macOS and Linux/WSL">
  <img src="https://img.shields.io/badge/Pi-supported-7c3aed?style=flat-square" alt="Pi supported">
</p>

> [!WARNING]
> Ariava is early-stage. Breaking changes are expected.

## Roadmap

- [x] Human Attention and Intervention
- [x] APN Notification
- [ ] **In progress:** Smart Alert
- [ ] **In progress:** Session Management
- [ ] End-to-end encryption
- [ ] Project management
- [ ] Invoke a new Pi session
- [ ] Codex/Claude Code/Cursor integration
- [ ] Summary and memory

## Getting Started

### Requirements

- Node.js and npm
- macOS, or Linux/WSL with a reachable systemd user service manager
- [Pi](https://pi.dev/) when selecting the Pi adapter

The shortest first-run path is:

```bash
npx --yes ariava@latest setup
```

Fresh production setup uses `https://ariava-relay.noyx.io`. Follow the prompts to set up the Bridge and optionally install the Pi extension; run `/reload` in an open Pi session after installation.

Pair your Watch separately:

```bash
ariava pair <PAIRING_CODE>
```

For manual setup:

```bash
npm install --global ariava
ariava init
ariava service install
ariava service status
ariava install pi
ariava doctor
```
## Usage

Check the Host, pair with a valid pairing code, inspect linked devices, or view service logs:

```bash
ariava status
ariava pair <PAIRING_CODE>
ariava watches list
ariava logs
```

The command surface is intentionally narrow. Ariava does not expose arbitrary shell execution, unrestricted input, a remote terminal, or a transcript browser.

## Build from Source

Requirements: [Bun](https://bun.sh/) and Node.js.

```bash
git clone https://github.com/noyyyy/ariava.git
cd ariava
bun install --frozen-lockfile
bun run verify
```

### Isolated source development profile

Use the fixed `dev` profile when an installed Ariava Bridge is already running. It keeps source-development configuration, identity, state, discovery, and logs under `~/.config/ariava-dev`, and uses the loopback Agent Adapter on `127.0.0.1:7273`; the installed profile remains under `~/.config/ariava` on port `7272`.

```bash
# Create or reuse the isolated dev configuration and Host identity
bun run dev:init

# Run the source Bridge in the foreground
bun run dev:bridge

# In another terminal, run Pi with only the source Ariava extension
bun run dev:pi -- <pi args...>

# Inspect paths, Host ID, Relay URL, and Adapter status (secret redacted)
bun run dev:status
```

`dev:pi` launches `pi --no-extensions -e <source-extension>`, so other automatically discovered Pi extensions are intentionally disabled in that process. These commands do not install or modify a launchd/systemd service, do not replace the globally installed Ariava Pi extension, and do not read or write the installed Ariava profile.

## Contributing

Contributions are welcome. Read [CONTRIBUTING.md](https://github.com/noyyyy/ariava/blob/HEAD/CONTRIBUTING.md) before opening a pull request, and include the validation you performed.

## Security

Report suspected vulnerabilities privately by following [SECURITY.md](https://github.com/noyyyy/ariava/blob/HEAD/SECURITY.md). Never post identities, adapter secrets, configuration files, pairing material, or complete logs in a public issue.

## License

Licensed under the [Apache License, Version 2.0](https://github.com/noyyyy/ariava/tree/HEAD/LICENSE).