# Up/Actions — kennisbank (volledig) Alle mogelijkheden van Up/Actions, per thema. Bron: https://actions.upscailed.nl/docs --- # Aan de slag > Account aanmaken, je eerste workspace en je eerste actie, in een paar minuten. Up/Actions is een AI-native actie-engine: één plek voor alles wat je nog wilt doen. Je vangt acties, plant ze, volgt ze op en vinkt ze af, via de web-app, de CLI, de REST API of je AI-assistent (MCP). Deze gids brengt je in een paar minuten op gang. ## 1. Account en eerste workspace Ga naar [actions.upscailed.nl](https://actions.upscailed.nl) en meld je aan met e-mail of Google. Bij je eerste login maakt Up/Actions automatisch een persoonlijke workspace aan. Een **workspace** is een afgeschermde ruimte met eigen acties, statussen en leden, bijvoorbeeld per bedrijf of project. Meer daarover in [Workspaces](/docs/workspaces). ## 2. Je eerste actie Klik op **+ Nieuwe actie** (of druk op `N`), typ een titel en druk op Enter. De rest voeg je later toe: een deadline, prioriteit, status of subtaken. Zie [Acties](/docs/acties). ## 3. Je dag overzien De weergave **Vandaag** houdt zichzelf schoon: achterstallig bovenaan, dan vandaag, en een blik op de komende twee weken. Wat je afvinkt, verdwijnt om middernacht, zodat je elke ochtend fris begint. ## 4. Sneller werken vanaf de command line Wil je vanuit je terminal, scripts of een agent werken? Installeer de CLI en beheer je acties met commando's: ```bash actions add "Offerte nakijken" -w Werk -p high -d 2026-07-15 actions today ``` Zie [De CLI](/docs/cli). ## Volgende stappen - [Acties](/docs/acties) — deadlines, prioriteiten, statussen, subtaken - [Projecten & tijdlijn](/docs/projecten) - [Samenwerken & delen](/docs/samenwerken) - [REST API](/docs/api) en [AI & MCP](/docs/mcp) --- # Workspaces > Een afgeschermde ruimte per bedrijf of project, met eigen acties, statussen en leden. Een workspace is een aparte ruimte met eigen acties, statussen, labels en leden. Handig om persoonlijk en zakelijk gescheiden te houden, of om per bedrijf of project te werken. Elke actie hoort bij precies één workspace. ## Aanmaken en wisselen In de web-app maak je een workspace via de switcher linksboven. Met de CLI: ```bash actions workspaces # toon je workspaces actions workspaces add "Klant X" # nieuwe workspace ``` Kies bovenin **Alle workspaces** voor een totaaloverzicht, of zoom in op één workspace. ## Eigen vs. gast - **Eigen workspace**: een workspace die jij hebt aangemaakt (jij bent eigenaar). - **Gast-workspace**: een workspace van iemand anders waar je in bent uitgenodigd. Je plan bepaalt hoeveel van elk je mag hebben (zie [Tiers & prijzen](/docs/tiers)). Delen en uitnodigen is een Premium-functie, zie [Samenwerken & delen](/docs/samenwerken). ## Statussen en labels per workspace Statussen (van `inbox` tot `done`) en labels zijn per workspace instelbaar, zodat elke ruimte bij je werkwijze past. De standaardstatussen zijn: inbox, todo, doing, waiting, blocked, review, done, cancelled. ## Een actie naar een andere workspace verplaatsen ```bash actions move a1b2c3d4 -w "Klant X" ``` --- # Tiers & prijzen > Gratis, Pro en Premium, met de verschillen in workspaces, projecten, inzichten en de API/CLI/MCP-koppeling. Up/Actions kent drie tiers. Jaarlijks betalen = tien maanden (twee maanden korting). Vroege gebruikers houden Premium levenslang gratis. ## Overzicht | | Gratis | Pro (€5/mnd) | Premium (€7/mnd) | |---|---|---|---| | Acties, deadlines, prioriteiten, subtaken | ✓ | ✓ | ✓ | | Terugkerende acties | ✓ | ✓ | ✓ | | Eigen workspaces | 1 | 5 | onbeperkt | | Gast-workspaces | 1 | onbeperkt | onbeperkt | | Projecten & tijdlijn | — | ✓ | ✓ | | Projectsjablonen | — | ✓ | ✓ | | Inzichten-dashboard | — | ✓ | ✓ | | Samenwerken & delen | — | — | ✓ | | Multi-eigenaar, delegeren, "wacht op" | — | — | ✓ | | API-sleutels + CLI + MCP | — | — | ✓ | ## Wat betekent dit - **Gratis** is voor persoonlijk gebruik: onbeperkt acties in één eigen workspace, plus gast zijn bij één ander. - **Pro** voegt projecten, tijdlijn, sjablonen, het inzichten-dashboard en meer workspaces toe. - **Premium** ontgrendelt samenwerken én de developer/agent-kant: API-sleutels, de [CLI](/docs/cli) en de [MCP-koppeling](/docs/mcp). Delen (mensen uitnodigen in een workspace) is een Premium-functie. Zie [Samenwerken & delen](/docs/samenwerken). Volledige uitleg en de actuele prijzen staan op [/pricing](https://actions.upscailed.nl/pricing). --- # Acties > Deadlines, geplande datum, prioriteiten, statussen, subtaken en geschiedenis, de kern van Up/Actions. Een actie is de kernentiteit: iets wat je nog wilt doen. Elke actie heeft een titel en kan een deadline, een geplande datum, een prioriteit, een status, subtaken en labels hebben. Acties kunnen door jou, je AI, een API-call of een webhook zijn aangemaakt. ## Deadline vs. geplande datum - **Deadline** (`dueDate`): wanneer iets áf moet. Verlopen deadlines kleuren amber en staan bovenaan in Vandaag. - **Geplande datum** (`plannedDate`): wanneer je het wilt dóen. Optioneel; je zet het aan in de instellingen als je met twee datums wilt werken. ## Prioriteit Vier niveaus: `low`, `normal`, `high`, `urgent`. Lijsten sorteren op wat nu telt. ## Statussen Standaard: `inbox`, `todo`, `doing`, `waiting`, `blocked`, `review`, `done`, `cancelled`. Per workspace aanpasbaar. Afvinken zet de status op done; heropenen draait dat terug. ## Subtaken Splits een actie in stappen die je los afvinkt, herordent en toewijst. Een subtaak verwijst met `parentId` naar zijn hoofdactie. ```bash actions add "Bijlage toevoegen" --parent a1b2c3d4 actions subtasks a1b2c3d4 ``` ## Voorbeelden ```bash # Aanmaken met deadline, prioriteit en workspace actions add "Jaarrekening indienen" -w "Fit In Finance" -p urgent -d 2026-07-31 # Wijzigen (status, deadline, titel, ...) actions edit a1b2c3d4 --status doing --due 2026-08-01 # Afvinken en weer heropenen actions done a1b2c3d4 actions reopen a1b2c3d4 # Details opvragen actions get a1b2c3d4 ``` Zie ook [Terugkerende acties](/docs/terugkerend) en [Projecten & tijdlijn](/docs/projecten). ## Geschiedenis Elke wijziging (status, deadline, eigenaar, ...) wordt vastgelegd met wie en wanneer, zodat je altijd kunt terugzien hoe een actie is verlopen. --- # Terugkerende acties > Van dagelijks tot de laatste werkdag van de maand, met de keuze tussen 'op schema' en 'na afronden'. Terugkerende acties regelen zichzelf: vink af, en het volgende exemplaar staat klaar met de juiste datum. Geen opstapeling van gemiste kopieën. ## Frequenties `daily`, `weekdays`, `weekly`, `biweekly`, `monthly`, `monthly_last_day`, `monthly_last_workday`, `quarterly`, `yearly`, en `custom` (eigen weekdagen, bijvoorbeeld maandag/woensdag/vrijdag). ## Twee modi - **Op schema** (`schedule`): de volgende keer is een vaste kalenderdatum, gerekend vanaf de oorspronkelijke datum. - **Na afronden** (`after_completion`): de volgende keer wordt geteld vanaf het moment dat je afvinkt. Voorbeeld: een wekelijkse actie "op schema" die je op dinsdag afvinkt terwijl 'ie voor maandag stond, komt volgende week weer op maandag. Dezelfde actie "na afronden" komt een week ná dinsdag terug. ## Overzicht De weergave **Terugkerend** toont al je actieve herhalingen. Datumberekening gebeurt volledig in UTC, zodat zomer- en wintertijd niets verschuiven. --- # Projecten & tijdlijn > Maak van een actie een project en plan de subtaken op een tijdlijn die je versleept (Pro). Sommige dingen zijn groter dan een vinkje. Zet een actie met één klik om naar een project en plan de stappen op een tijdlijn. Alleen projecten verschijnen op de tijdlijn, zodat die schoon blijft. Projecten & tijdlijn zit in **Pro** en hoger. ## Acties zijn geen projecten Kleine dingen blijven gewoon acties. Wordt iets een traject, dan maak je er een project van (`isProject`). Je kunt het ook weer terugzetten naar een gewone actie. ## De tijdlijn (Gantt) Weken horizontaal, je projecten en subtaken verticaal. Pak een balk en sleep 'm naar de juiste week, of rek 'm op aan de randen. Nog niet gepland? Dan ligt er al een gestreepte balk klaar. Stoplicht-kleuren tonen in één blik wat af is (groen), achterloopt (amber) of bezig is (blauw). ## In- en uitklappen Klap een project in voor de hoofdlijn met voortgang (X/Y), of uit voor alle subtaken in jouw volgorde. Elke subtaak heeft een eigen status, datum en eigenaar. Zie ook [Sjablonen](/docs/sjablonen) om vaste trajecten in één klik neer te zetten. --- # Inzichten > Zie in één blik of je voor of achter ligt, met streaks, doorstroom en een activiteiten-heatmap (Pro). Het inzichten-dashboard vat je werk samen: hoeveel er open staat, hoeveel je afrondt, en of je op schema ligt. Beschikbaar vanaf **Pro**. ## Wat je ziet - **KPI's**: open acties, deze week afgerond, afrondpercentage, gemiddelde leeftijd van open acties, achterstallig. - **Winning streak**: hoeveel dagen op rij je iets afrondt. - **In/uit per week**: nieuw aangemaakt versus afgerond. - **Activiteiten-heatmap**: per dag hoe actief je was. - **Backlog per status** en **per workspace**. ## Via de CLI ```bash actions insights actions insights --json # voor scripts of dashboards ``` De onderliggende cijfers (`completedAt`, `createdAt`) worden altijd vastgelegd, zodat je later ook terug in de tijd kunt kijken. --- # Samenwerken & delen > Deel workspaces met leden en kijkers, wijs acties toe en delegeer, met uitnodigingen per e-mail (Premium). Deel een of meer workspaces met anderen en werk samen zonder ruis. Samenwerken en uitnodigen is een **Premium**-functie. ## Rollen Per persoon kies je een rol: - **Lid** (`member`): mag meewerken (acties aanmaken, bewerken, afvinken). - **Kijker** (`viewer`): mag alleen bekijken; alle schrijfacties zijn geblokkeerd. De eigenaar van een workspace beheert de leden en uitnodigingen. ## Uitnodigen Nodig iemand uit via e-mail. De uitgenodigde krijgt een link, logt in (of maakt een account) en accepteert de uitnodiging; pas dan krijgt hij toegang. Je beheert leden en openstaande uitnodigingen onder **Instellingen → Workspaces & delen**. ## Toewijzen en delegeren Wijs een actie toe aan een of meerdere eigenaren, of gebruik status `waiting` met "wacht op" om aan te geven dat je op iemand anders wacht. Zo zie je altijd wie aan zet is. ## Gast-limiet Op Gratis kun je bij maximaal één gedeelde workspace gast zijn; een tweede uitnodiging vraagt om upgraden. Zie [Tiers & prijzen](/docs/tiers). --- # Sjablonen > Leg een vast traject één keer vast en zet het voortaan in één klik op de tijdlijn (Pro). Doe je iets vaker volgens hetzelfde stramien, een onboarding, een evenement, een migratie? Leg het één keer vast als sjabloon en zet het voortaan in één klik neer. Sjablonen zitten in **Pro** en hoger. ## Een sjabloon maken Twee manieren: - Bouw het in de editor: subtaken plus de week-spanne per stap. - Of wijs een bestaand project aan dat al goed staat en sla het op als sjabloon. Sjablonen werken met **relatieve weken**: week 0 is de startweek, de rest telt daarvandaan. ## Een sjabloon toepassen Kies het sjabloon bij **+ Nieuw project** en alles staat er: het project met alle subtaken, op de juiste weken vanaf jouw startweek. Daarna sleep je bij wat anders moet. Zie [Projecten & tijdlijn](/docs/projecten) voor de tijdlijn zelf. --- # De CLI installeren en gebruiken > Je acties vanaf de command line. Stap voor stap installeren, inloggen en alle commando's met voorbeelden. 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: ```bash node cli/actions.mjs today ``` Of als globaal `actions`-commando: ```bash cd cli && npm link # of: npm i -g . actions today ``` ## Stap 3 — API-sleutel aanmaken Maak een sleutel aan op [/instellingen/api-sleutels](https://actions.upscailed.nl/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 ```bash 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 [velden] titel/status/deadline/prioriteit wijzigen actions move -w WS actie naar een andere workspace actions done afvinken actions reopen heropenen actions get details van één actie actions subtasks subtaken van een actie actions rm [-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 ```bash # 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](/docs/api). --- # REST API > Endpoints, API-sleutels en scopes om je eigen integraties, scripts en agents op je acties te bouwen (Premium). Up/Actions is API-first: dezelfde REST API die de web-app gebruikt, staat open voor je eigen tools. De CLI en de MCP-server draaien er bovenop. API-sleutels zitten in **Premium**. ## Authenticatie Elke call gaat met een Bearer-token in de `Authorization`-header: ```bash curl https://actions.upscailed.nl/api/actions?view=today \ -H "Authorization: Bearer ff_xxx" ``` Maak sleutels aan op [/instellingen/api-sleutels](https://actions.upscailed.nl/instellingen/api-sleutels). Een sleutel is aan één workspace gebonden of aan **alle** workspaces (`all`). ## Scopes Elke sleutel heeft scopes; elke service-functie checkt de juiste scope (least-privilege): `actions:read`, `actions:write`, `actions:complete`, `actions:assign`, `actions:delete`, `workspaces:read`, `workspaces:write`, `ai:execute`, `webhooks:manage`. Geef een agent niet meer dan nodig, bijvoorbeeld een read-only sleutel voor monitoring. ## Endpoints ``` GET /api/actions?view=today lijst (view + filters) POST /api/actions actie aanmaken GET /api/actions/{id} één actie PATCH /api/actions/{id} velden wijzigen DELETE /api/actions/{id} verwijderen POST /api/actions/{id}/complete afvinken POST /api/actions/{id}/reopen heropenen GET /api/actions/{id}/subtasks subtaken POST /api/actions/resolve korte-id-prefix → volledige actie(s) GET /api/workspaces workspaces POST /api/workspaces workspace aanmaken GET /api/insights KPI's / streak / backlog ``` Views: `today`, `tomorrow`, `upcoming`, `overdue`, `inbox`, `mine`, `unassigned`, `without-deadline`, `waiting`, `delegated`, `archive`, `all`. ## Voorbeelden ```bash # Actie aanmaken curl -X POST https://actions.upscailed.nl/api/actions \ -H "Authorization: Bearer ff_xxx" \ -H "Content-Type: application/json" \ -d '{"title":"Contract nakijken","priority":"high","dueDate":"2026-07-20","workspaceId":"ws_..."}' # Afvinken curl -X POST https://actions.upscailed.nl/api/actions/ACTIE_ID/complete \ -H "Authorization: Bearer ff_xxx" ``` Een `all`-sleutel kan cross-workspace schrijven door `workspaceId` in de body mee te geven. ## Liever een commando? Voor dagelijks gebruik en agents is de [CLI](/docs/cli) prettiger dan losse curl-calls; die wrapt precies deze endpoints. --- # AI & MCP > Koppel je acties aan Claude via MCP, zodat je AI-assistent je dag plant en acties bijwerkt (Premium). Up/Actions is AI-native: via het Model Context Protocol (MCP) praat je AI-assistent rechtstreeks met je acties. Vraag om je dag te plannen, acties aan te maken of bij te werken, en houd zelf de regie. MCP zit in **Premium**. ## Twee koppelingen - **Streamable HTTP** (voor Claude Code en eigen clients): `https://actions-mcp.upscailed.nl/mcp` - **stdio** (lokaal per chat-sessie) Beide praten met dezelfde REST API via je Bearer-sleutel; de scopes bepalen wat de AI mag. ## Koppelen in Claude Code ```bash claude mcp add --transport http actions \ https://actions-mcp.upscailed.nl/mcp \ --header "Authorization: Bearer ff_xxx" ``` Daarna kun je vragen als "lijst mijn acties voor vandaag" of "maak deze vijf acties aan in Fit In Finance". ## Wat de AI kan Negen tools (workspaces tonen/aanmaken, acties lijsten/ophalen/aanmaken/wijzigen/afvinken/heropenen/verwijderen) en drie read-only bronnen: `actions://today`, `actions://workspaces`, `actions://insights`. ## MCP of CLI? - **MCP** is ideaal in de chat-context (Claude Desktop, Claude Code). - De [CLI](/docs/cli) is robuuster voor scripts, cron en agents die via een shell werken: geen persistente verbinding om te babysitten. Ze delen dezelfde client en API, dus je kunt beide naast elkaar gebruiken. Zie ook [Agent-first](/docs/agent-first). --- # Agent-first & llms.txt > Hoe agents Up/Actions leren kennen en aansturen, via de CLI, de API, MCP en een machine-leesbare kennisbank. Up/Actions is agent-native ontworpen: een agent is een eersteklas gebruiker, niet iets wat achteraf is aangeplakt. Mens én agent werken op dezelfde bron van waarheid. ## Één kern, vier voordeuren Onder de web-UI, de REST API, de CLI en de MCP-server zit dezelfde service-laag met dezelfde regels. Wat je via de ene ingang doet, geldt overal. Een actie kan van een mens, een AI, een API-call of een webhook komen; het `source`-veld weet waar 'ie vandaan komt. ## Least-privilege voor agents Geef een agent een [API-sleutel](/docs/api) met precies de scopes die het nodig heeft. Een monitoring-agent krijgt read-only; een uitvoerende agent krijgt schrijfrechten. Een workspace-gebonden sleutel blijft in z'n workspace. ## Deze kennisbank is machine-leesbaar Zodat een agent Up/Actions zonder mens kan leren kennen: - **[llms.txt](/llms.txt)** — een gecureerde index (llmstxt.org-standaard) met links naar alle thema's. - **[llms-full.txt](/llms-full.txt)** — de volledige kennisbank als één markdown-bestand, in één fetch. ```bash # Een agent leert de hele app kennen met één commando curl https://actions.upscailed.nl/llms-full.txt ``` ## Praktisch: een agent-fleet op Up/Actions De meest robuuste route voor geautomatiseerde agents is de [CLI](/docs/cli) in een shell-stap: geen verbinding om te babysitten, platte leesbare output, en `--json` voor machine-verwerking. ```bash # Voorbeeld: een agent haalt achterstallige acties op en handelt ze af actions overdue --json | jouw-agent-script ``` Zo wordt Up/Actions het gedeelde takenbord waar jij, je team én je agents dezelfde acties aansturen.