De CLI installeren en gebruiken

De actions-CLI is een dunne, dependency-vrije schil om de Up/Actions REST API: dezelfde endpoints en Bearer-auth als de MCP-server, maar als shell-commando. Ideaal voor de terminal, scripts, cron/CI en agents die via een shell werken, zonder persistente verbinding. De CLI zit in het Premium-plan (API-sleutels).

Stap 1 — Node

Je hebt Node 18 of hoger nodig. Check met node -v.

Stap 2 — Installeren

De CLI leeft in de repo onder cli/. Zonder installatie meteen te gebruiken:

node cli/actions.mjs today

Of als globaal actions-commando:

cd cli && npm link      # of: npm i -g .
actions today

Stap 3 — API-sleutel aanmaken

Maak een sleutel aan op /instellingen/api-sleutels en kies de scopes (alleen lezen, of lezen + schrijven). De sleutel (ff_...) wordt één keer getoond, bewaar 'm veilig.

Stap 4 — Inloggen

actions login          # vraagt interactief om je sleutel

De sleutel komt in ~/.config/actions/config.json (chmod 600). Alternatief via omgevingsvariabelen ACTIONS_API_KEY en ACTIONS_API_URL. Gebruik --key alleen bewust in CI of tijdelijke scripts, anders belandt de sleutel in je shell-history.

Commando's

actions today                         acties voor vandaag
actions tomorrow                      acties voor morgen
actions upcoming                      komende acties
actions overdue                       achterstallige acties
actions mine                          acties toegewezen aan jou
actions archive                       afgeronde/gearchiveerde acties
actions ls [--view V] [-w WS] [-n N]  lijst (view: today/overdue/inbox/upcoming/
                                      mine/unassigned/without-deadline/waiting/
                                      archive/all)
actions add "Titel" [-d 2026-07-10]
    [--planned 2026-07-09]
    [-p urgent|high|normal|low] [-s todo] [-w WS] [--desc "..."]
    [--parent id]                     nieuwe actie (of subtaak met --parent)
actions edit <id> [velden]            titel/status/deadline/prioriteit wijzigen
actions move <id> -w WS               actie naar een andere workspace
actions done <id>                     afvinken
actions reopen <id>                   heropenen
actions get <id>                      details van één actie
actions subtasks <id>                 subtaken van een actie
actions rm <id> [-y]                  verwijderen
actions workspaces [add "Naam"]       workspaces tonen of aanmaken
actions insights                      KPI's / streak / backlog
actions api [METHOD] /api/path [json] raw API-call voor scripts en agents

Lijst-filters: --status, --priority, --assignee, --workspace, --limit. Overal --json voor machine-output.

Id's mogen als korte prefix (#a1b2c3d4). Volledige UUID's gaan direct naar de API; korte prefixes worden server-side opgelost, ook voor subtaken en archief.

Voorbeelden

# Snel iets vastleggen in een workspace
actions add "Debiteuren herinneren" -w "Fit In Finance" -p high -d 2026-07-15

# Wat staat er vandaag open in één workspace?
actions today -w "Fit In Finance"

# Achterstallig, als JSON, voor een script
actions overdue --json

# Een actie afronden via een korte prefix
actions done a1b2c3d4

# Raw call voor een agent (elke endpoint bereikbaar)
actions api GET "/api/actions?view=overdue"

Onder de motorkap

De CLI praat met dezelfde REST API als de web-app en de MCP-server. De scopes van je sleutel bepalen wat 'ie mag: een workspace-gebonden sleutel blijft in z'n workspace, een all-sleutel ziet alles. De web-app blijft de bron van waarheid. Zie REST API.