Command reference
Every actovia command and option.
Every command takes -h, --help; actovia -V prints the version.
actovia status
The desktop app on this machine at a glance: version, lock, phones, keys, updates
actovia status [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia doctor
Check the desktop app and the CLI on this machine, and say how to fix what is wrong
actovia doctor [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia open
Launch the Actovia desktop app
actovia openactovia app
The Actovia desktop app on this machine: check, update, open, quit, restart
actovia appactovia app check
Say whether a newer Actovia is out
actovia app check [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia app update
Install the newest Actovia (macOS; quits and reopens it, asking for the app-lock PIN)
actovia app updateactovia app open
Launch the Actovia desktop app
actovia app openactovia app quit
Quit Actovia (asks for the app-lock PIN)
actovia app quitactovia app restart
Quit Actovia and start it again (asks for the app-lock PIN)
actovia app restartactovia update
Update the Actovia CLI to the newest version
actovia update [options]| Option | Description |
|---|---|
--check | only report whether an update is available, install nothing |
actovia pair
Pair a phone with the Actovia running on this machine (shows a QR code; asks for the app-lock PIN)
actovia pair [options]| Option | Description |
|---|---|
--invert | draw the QR code for a light terminal background |
actovia devices
List the phones paired with this machine's Actovia (asks for the app-lock PIN)
actovia devices [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia devices revoke
Unpair a device: it can no longer reach this computer
actovia devices revoke <id>actovia lock
Lock the desktop app now (asks for the app-lock PIN)
actovia lockactovia backup
List the desktop app's database backups
actovia backup [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia backup create
Back up the database now
actovia backup create [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia tasks
List Philharmonic's scheduled tasks
actovia tasks [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia quota
Show what Claude Code and Codex last reported of your plan quota
actovia quota [options]| Option | Description |
|---|---|
--json | machine-readable output |
actovia usage
How many tokens the models have used: recent days, all time, top models
actovia usage [options]| Option | Description |
|---|---|
--days <n> | how many recent days to total |
--json | machine-readable output |
actovia logs
Print the desktop app's log (Settings → Logger), oldest first
actovia logs [options]| Option | Description |
|---|---|
-n, --lines <n> | how many of the newest lines (at most 500) |
-f, --follow | keep printing new lines as they come |
--level <level> | that level and above: debug, info, warn, error |
--scope <name> | one scope only, e.g. app or kernel |
--trace <id> | one trace only (a request, a job) |
-q, --query <words> | the Logger search syntax: words, -word, scope:, trace: |
--date <YYYY-MM-DD> | another day's log |
--json | one JSON record per line |
actovia skills
Browse and manage skills.sh skills
actovia skillsactovia skills search
Search skills.sh
actovia skills search [options] <query>| Option | Description |
|---|---|
--json | output JSON instead of a formatted list |
actovia skills install
Install a skill by id (e.g. vercel-labs/skills/find-skills)
actovia skills install [options] <id>| Option | Description |
|---|---|
--json | output JSON instead of a formatted message |
actovia skills list
List installed skills
actovia skills list [options]| Option | Description |
|---|---|
--json | output JSON instead of a formatted list |
actovia skills uninstall
Uninstall a skill
actovia skills uninstall [options] <slug>| Option | Description |
|---|---|
--json | output JSON instead of a formatted message |