Install

agent-presence runs on macOS and Linux (Windows is not supported) and needs Node.js 22 or newer. Credentials live in Keychain on macOS and libsecret on Linux.

Global install

pnpm

pnpm add -g @rivus/agent-presence
agent-presence setup

npm

npm i -g @rivus/agent-presence
agent-presence setup

bun

bun add -g @rivus/agent-presence
agent-presence setup

setup is the only thing you run. It installs the hooks for every supported agent and links your signature.

Without a global install

pnpm

pnpm dlx @rivus/agent-presence@latest setup

npm

npx --yes --registry=https://registry.npmjs.org @rivus/agent-presence@latest setup

bun

bunx @rivus/agent-presence@latest setup

For agent environments that launch hooks with a restricted PATH, install hooks with absolute paths:

agent-presence setup --hook-command absolute

The default provider is magic-builder, so the first setup runs the QR login (storing the slot credential) and prompts for a Magic-Builder token. See Providers for the alternative that needs no token.