Reference on Arivu

API Reference

Mon, 15 Jun 2026 00:00:00 +0000

The Go application serves its API under /api. This page is a route overview; the application repository at the pinned release is the source of truth for request and response fields.

Authentication Audiences

Web uses HTTP-only cookies and CSRF protection for browser mutations.
CLI uses bearer tokens from /api/auth/cli/login.
Extension uses audience-scoped tokens issued through an authenticated web session.

Tokens cannot cross audience boundaries. Every owned query and mutation is scoped to the authenticated user.

Keyboard Shortcuts

Fri, 20 Feb 2026 00:00:00 +0000

Arivu relies on familiar browser controls and a small set of verified application shortcuts. It does not override print, find, or general page navigation keys.

Global

Keys	Action
`Cmd/Ctrl + K`	Open the command palette for navigation, Capture, Search / Ask, and contextual actions
`Escape`	Close the active dialog, menu, or annotation composer and restore focus where applicable
`Tab` / `Shift + Tab`	Move through interactive controls and trapped dialog focus

Inbox Triage

When focus is inside an Inbox item card and not in a form field:

Command Line Interface

Wed, 08 Jul 2026 00:00:00 +0000

The same Go binary serves the app and provides CLI commands. CLI sessions use their own bearer-token audience and cannot be reused as browser or extension sessions.

Build and Run

git clone https://github.com/glnarayanan/arivu.git
cd arivu
go build -trimpath -ldflags="-s -w" -o arivu ./cmd/arivu
./arivu version
./arivu serve -addr 127.0.0.1:8080 -db arivu.sqlite3

Open http://127.0.0.1:8080/auth and create an account before CLI login.

Log In

./arivu login \
  --api http://127.0.0.1:8080/api \
  --email you@example.com \
  --password your-password

The CLI stores its API URL and tokens in the local user configuration directory. ARIVU_API supplies a default URL when --api is omitted.