Quickstart

Install, authenticate, dive. About four minutes if your package manager is having a good day.

1. Install the CLI

The CLI is the whole product minus the pretty parts. Everything the desktop app can do, it can do, and it is the only client that runs on a machine with no window server.

$ brew install vivaocean/tap/viva
$ viva --version
viva 3.4.1 (darwin/arm64)

On Linux, curl -fsSL https://get.vivaocean.example/cli | sh. On Windows, winget install VivaOcean.CLI.

2. Authenticate

The login command opens a browser once and writes a token to ~/.config/viva/credentials. The token is scoped to your user and can be revoked from the account screen without touching the others.

$ viva login
Opening https://app.vivaocean.example/cli-auth ...
Signed in as rosa@example.com (Cartography, 14 people)

3. Your first dive

A dive needs a depth and nothing else. The three depths are shallow, mid and deep, and they are twenty-five, fifty and ninety minutes.

$ viva dive deep --note "rewriting the tiler"
Down to 90m. Surfacing at 15:42.
Reachable by: escalation path only (3 people).

$ viva status
depth       deep
elapsed     00:12:31
remaining   01:17:29
held        4 messages, 1 mention

viva surface ends the dive early and releases everything that was held. Nothing is ever discarded; a dive delays messages, it does not eat them.

4. Bring the team

The Shoal appears as soon as a second person on your team dives. There is nothing to configure and no channel to create.

$ viva invite rosa@example.com kit@example.com
2 invitations sent.

$ viva shoal
kit      deep     47m left    "compiler bug"
ines     shallow   8m left
you      surfaced

Reference

Dives and depth, the configuration file, the CLI, and how depth maps to who can reach you.
The Shoal API, four endpoints and one webhook.

Dives and depth Back to features

VivaOcean is a fictional product. This site exists to show a theme, and every number on it was made up to fill a layout.