The terminal client

ActionAmp from the terminal

The CLI mirrors the app's decision loop — capture, choose, do, done — as plain commands. The same Next card the web shows, the same inbox, the same logbook. Built for people who live at a prompt, and for the agents working alongside them.

Start free See pricingIncluded with Pro and Founding membership

$ actionamp now
Draft the September launch email
Project: Website relaunch
Goal: Ship the beta
Why now: Due tomorrow, and nothing is blocking it
Why it matters: Toward Ship the beta.

$ actionamp done t_7q2m --outcome "Sent for review"
Marked done.

Start with three commands

Install

A single global package. Node 18 or newer.

$ npm install -g actionamp

Log in

Your browser confirms; the CLI receives a token behind the scenes — the same flow as gh auth login. Nothing to type or paste.

$ actionamp login

Ask what's next

The one task that matters, with the reason it is on top.

$ actionamp now

The whole loop, at a prompt

Every command stands on its own, and every command takes--json. The verbs follow the app: decide, capture, organize, reflect.

Decide and do

`actionamp`	Login status and the full command reference.
`actionamp now`	The top task, with its project, goal, and why context.
`actionamp today`	What you committed to today. --done lists finished work.
`task start <id>`	Make it the focused task.
`task pause <id>`	Step away. The session is kept.
`task done <id>`	Finish it, with an optional --outcome note.
`task snooze <id>`	Not now: 1h, 3h, tomorrow, weekend, someday.
`task move <id> --to <list>`	today, upcoming, or someday.
`task sweep`	Push stale Upcoming tasks to Someday. Dry run by default.

Capture and inbox

`capture "text"`	Straight to the inbox. #project @date !priority are parsed.
`inbox list`	What is waiting to be triaged.
`inbox triage <id>`	Decide what a captured thing is, then dispatch it.
`attachment download <id>`	Save a captured image to disk.

Organize

`lens list\|switch\|current`	Scope Work, Me, or any lens you have made.
`project list\|show\|create\|add-task`	Projects and their tasks, inside a lens.
`resource add\|list\|update\|delete`	Links and notes filed under a project.
`goal list\|show\|create`	Goals in a lens.
`logbook`	Completed tasks, finished projects and goals, archived.

Reflect and account

`review week\|month`	A read-only check-in, or the finished report from a past period.
`whoami`	The logged-in account.
`login / logout`	Browser login (use --dev for a local server), or clear the token.

Capture also accepts a title, body text, a source URL, and up to four images — the same fields a phone shares to the inbox.

For scripts and agents

Pass --json to any command and you get a stable shape: parseable stdout, a non-zero exit, and errors reported as{ "error": "…" }. A script can trust what it reads.

The flag is the same everywhere — now,today, inbox list,review month — so one parsing habit covers the whole loop.

$ actionamp now --json | jq -r .task.description
Draft the September launch email

Bring your agent along

The CLI ships with seven agent skills — short, tested instructions that teach an AI harness how to run the loop with you: capture a thought, triage the inbox, ask what's next, close work cleanly, tidy up, and review the week.

actionamp skills list shows what's bundled.actionamp skills install finds every harness on the machine — pi, Claude Code, Codex, anything keeping skills under~/.agents — asks before each one, and copies the skills in, shared guardrails included.

Installs are copies, never symlinks, so they keep working anywhere. After upgrading the CLI, run the install again with--force to pick up new versions.

$ actionamp skills list
Bundled skills (…/node_modules/actionamp/skills):
  aa-capture              Capture thoughts, links, reminders, and screenshots
  aa-now                  Answer "what should I work on right now"
  aa-triage               Process inbox items into tasks, projects, or the archive
  …                       plus aa-complete, aa-review, aa-setup, aa-hygiene

$ actionamp skills install
Install 7 ActionAmp skills into Claude Code (~/.claude/skills)? [Y/n] y
Installed 7 skill(s) into Claude Code: aa-capture, aa-complete, aa-hygiene, aa-now, aa-review, aa-setup, aa-triage, _shared

Part of Pro

CLI and personal API tokens are included with Pro and Founding membership. Free accounts can't authorize the CLI or use existing tokens — upgrade under Settings → Billing, then runactionamp login again.

Start free Compare plans

The details, plainly.

Where your token lives: ~/.config/actionamp/config.json. Runactionamp logout — or delete the file — and the CLI forgets everything.
Local development: actionamp login --dev targets a locally running server. The choice is remembered; later commands need no flag.
Origin overrides: ACTIONAMP_API_URL and ACTIONAMP_WEB_URLpoint the CLI anywhere else — useful for self-hosted setups.
One lens at a time: lens switch work scopes later commands;--lens-id overrides a single call.today and reviews stay cross-lens.