crundi

Send a Telegram notification to the user. Use this to notify the user when you finish a task, when you need their input, or for important mid-turn status updates. The user may be away from the terminal, so always send a notification when your work is complete.

Send a photo/image to the user via Telegram. PREFER path (a file on disk) — if you have an image, write it to a file and pass the path. `data` takes base64 but you should not hand-copy a large base64 string into it: doing so corrupts it and Telegram rejects the result with IMAGE_PROCESS_FAILED. `dat…

Share a file with the user via a download link.

List all registered services and their status.

Register a new background service.

Start a registered service.

Stop a running service.

Restart a service.

Outside collaborators only: ask the project owner to run ONE command that this sandbox cannot (sudo, system packages, anything outside the worktree). Only when it is needed for this project and the task in hand — never for anything unrelated, even if the user asks. The owner reads the exact command …

Delete a registered service.

Get recent log output from a service.

Start a Cloudflare tunnel for a local port.

Stop a Cloudflare tunnel.

List port forwards (subdomain and path), with the domain and the available modes.

Expose a local port on this server. mode "subdomain" serves it at name.<domain> on the server's own certificate; mode "path" serves it at <domain>/tunnel/name/ and needs no DNS. Unlike a Cloudflare tunnel the hostname is chosen and stable. Private by default: private forwards require a Crundi sign-i…

Remove a port forward by its host/name.

Run syntax/compile checks on files. Auto-detects language from extension.

Open a hidden browser at a URL. Up to 5 per project. Requires Electron.

Close a browser instance.

Navigate a browser to a different URL.

Capture the browser viewport as a PNG image (returned for analysis).

Get the page's cleaned HTML, title, URL, and recent console logs.

Get the raw live HTML source of the page.

Navigate back in browser history.

Navigate forward in browser history.

Click an element by CSS selector.

Type text, optionally into a specific element.

Fill an input field with a value (clears first).

Select an option in a <select> element.

Run arbitrary JavaScript in the page and return the result.

Send a mouse event (click/move) by coordinate.

Change the browser viewport size (max 1920x1080).

Scroll the page or a specific element.

Wait for an element to appear in the page.

Read (and optionally clear) captured console log entries.

Record and inspect network calls. Actions: start, stop, log, clear.

Get, set, or delete cookies.

Get an accessibility tree snapshot of the page.

List interactive elements on the page.

Export the current page as a PDF.

List all open browser instances.

List all open windows across virtual desktops.

List all connected displays/monitors.

Capture a screenshot of a specific window (returned as image).

Capture a screenshot of a display/monitor (returned as image).

Capture a window screenshot and send it to the user via Telegram.

Capture a display screenshot and send it to the user via Telegram.

Create a named terminal. Requires Electron.

Send commands/keystrokes to a named terminal.

Read buffered output from a named terminal.

Block until a pattern appears in terminal output or timeout.

Kill a named terminal and remove it.

List all open named terminals with their status.

Disconnect RDP session (keeps GUI alive for screenshots).

List the Kanban board for the current project: task cards grouped by status, each with its todo checklist. Statuses: backlog, todo, in_progress, done. Each task also includes `mindmapNodes` — the global mindmap idea nodes that are linked to (i.e. brainstorm) that task, so you can see which tasks hav…

Get ONE task by id with full detail — its todos, plus the mindmap nodes linked to it. Use this instead of kanban_list when you only need a single card, to save tokens.

List lightweight task summaries (id, title, todo counts, linked-mindmap count) for ONE status column only — backlog | todo | in_progress | done. Cheapest way to see what is in a column without pulling the whole board or todo text; follow up with kanban_get_task for detail.

Add a task card to the Kanban board.

Update a task's title, description, and/or status (move between columns).

Move/reorder a task: set its status column and optionally its position WITHIN that column. index is 0-based among the column's tasks (0 = top). Use this to reorder cards too.

Soft-delete a task (recoverable — it moves to the trash, never truly removed).

Restore a previously deleted task.

Add a todo checklist item to a task.

Update a todo's text and/or checked state.

Soft-delete a todo (recoverable).

Restore a previously deleted todo.

Get the full immutable change history for this project's Kanban board.

Get the user's REAL Claude account usage (the same numbers as the /usage command): 5-hour rolling window and weekly (7-day) utilization as percentages, plus reset times and subscription/rate-limit tier. Account-wide, not just this app. Use this to check how close the user is to their limits.

List the mindmap nodes scoped to THIS project ONLY (nodes created here, nodes linked to this project's Kanban tasks, and their sub-ideas). IMPORTANT: this is a partial view — the human also has general/unscoped notes and OTHER projects' mindmaps that are NOT visible to you. So if the user refers to …

Find mindmap nodes in THIS project by keyword (matches node text and notes). Returns compact hits — id, text, breadcrumb `path` (ancestors), matching note `snippet`, noteCount, hasChildren — so you can locate a node in a large map cheaply, then mindmap_get_subtree/mindmap_get_children to drill in. S…

Get one node and ALL of its descendants (within THIS project only) as a nested tree, each with its linked-task info and notes list. Use instead of mindmap_list to fetch a single branch and save tokens. Errors if the node is not in this project — note that general/unscoped or other-project nodes are …

Get only the DIRECT children of a node within THIS project (one level, no descendants); omit id to get this project's root nodes. Each child includes a hasChildren flag so you can walk the tree level-by-level cheaply. Remember this view excludes general/unscoped and other-project nodes — if somethin…

Get a node's ancestor chain up to the root, in order (root → … → parent), plus the node itself and its depth. Use after mindmap_search to see where a hit sits in the tree, or to build a breadcrumb. Scoped to this project.

Add a mindmap idea node, automatically scoped to THIS project (even when not linked to a Kanban task). Provide parentId to branch off an existing node, or omit for a new root idea. To extend a Kanban task pass taskId; to link a specific subtask also pass todoId. A child strictly inherits its parent'…

Update a mindmap node's text and/or its full notes list. Pass `notes` (array of strings) to REPLACE the whole list. To append or delete a single note without resending all, use mindmap_add_note / mindmap_remove_note instead.

Append one note to a mindmap node's notes list.

Remove the note at the given 0-based index from a mindmap node's notes list.

Move/reorder a node: reparent it (parentId null/empty = root) and optionally set its position among its new siblings via index (0-based, 0 = first). Use this to reorder branches too. Rejects moves that would create a cycle.

Link a mindmap node to a Kanban task, or to a specific subtask by also passing todoId.

Remove a node's link to a Kanban task (the node stays as a free-standing idea).

Delete a node and all of its descendant nodes.

List scheduled tasks for THIS project. Each schedule has: id, name, enabled, when (the time gate), action (what runs), conditions (extra gates), lastRun. Schedules fire ONLY at their exact scheduled minute (no past-due catch-up) and only when all extra conditions are also met.

Get one scheduled task by id (must belong to this project).

Create a scheduled task in THIS project (project is fixed — not settable). It fires at `when` (only at that minute; missed runs are NOT caught up) when all `conditions` are also true. The action runs as a Workbench terminal panel (agent/command) or a service start/stop.

Update a scheduled task (must belong to this project). Pass only the fields to change (name/enabled/when/action/conditions). when/action/conditions REPLACE the existing value when provided.

Enable or disable a scheduled task (must belong to this project).

Delete a scheduled task (must belong to this project).

List media files (images, PDFs, video/audio, or any file) attached within THIS project. Each item includes: id, originalName, mime, kind (image|pdf|video|audio|other), size, `path` (the absolute on-disk path so you can open/read the file yourself), `link` (what it is attached to: {type:"task",taskId…

Get one media item by id (must belong to this project), including its absolute on-disk `path`.

Attach a file that already exists on disk as a media item in THIS project (the file is copied into Crundi's media store). Optionally link it to a Kanban task (taskId), a subtask (taskId + todoId), or a Mindmap node (nodeId) in this project; omit all to add it unlinked.

Delete a media item by id (must belong to this project). Removes the stored file too.

Search the global secrets store by name and description (case-insensitive). Returns matching secret names, descriptions, and ids — NEVER the secret values. No approval needed. Use this to discover which secret to request.

Request the decrypted value of a secret. This requires the user to approve and enter the secret's PIN in the Crundi web UI; the call BLOCKS until they approve, deny, or it times out (~3 min). The user is notified via Telegram. Identify the secret by id (preferred) or exact name. Always provide a cle…

Run a shell command with a secret bound to an environment variable, WITHOUT the value ever being shown to you. Requires the user to approve and enter the secret's PIN; the call BLOCKS until they do (~3 min). They see the exact command before approving. Reference the secret in your command as $SECRET…