Skip to content
cccskills
FreePublished on GitHub

nd

Drive the running notedeck from the command line via the `nd` CLI (crates/nd_cli) — list its tools and call any of them over its local socket, or spawn a Dave session, e.g. open a headway card or agentium session in the window, open the review queue, or read board data. Use when the user wants to open something in notedeck from a shell, script the app, or see which tools the running notedeck offers — e.g. "open this card in notedeck", "what tools does notedeck have", "call open".

The English summary is being prepared. Showing the original description.

damus-io/notedeck317 stars(GitHub 317 + cccskills 0)

Run score Not tested

See how to install

Files included (1)

  • SKILL.md3.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

nd: notedeck's tools from a shell

nd talks to the running notedeck over its per-user socket (notedeck_ipc::socket_path(), overridden by $NOTEDECK_SOCKET). Every run fetches the tool list from the app, so it always matches what's running and there's nothing to keep in sync. Source: crates/nd_cli.

Running it

cargo run -q -p nd_cli -- tools          # or the built target/debug/nd

Commands

  • nd tools [--json] [<pattern>] — every tool, grouped by category, marked data/ui and ro (read-only). A pattern filters by name, title or description (smart-case regex).
  • nd tools <name> — one tool's description and its arguments.
  • nd call <name> [key=value…] — call a tool. Values are coerced by the tool's schema (string, number, true/false, JSON for object/array). A wrong or missing key fails before anything is sent, listing the arguments. A tool whose only required argument is a string takes it bare: nd call open agentium:<word-id>. --json '<object>' or --json-file <path|-> passes the arguments as one object instead.
  • nd mcp [--ui] [--read-only] — a stdio MCP server: tools/list and tools/call go to the socket, one connection each, so it can start before notedeck. Only data tools are exposed unless --ui; --read-only keeps only tools that change nothing. A hidden tool can't be called by name. Register it with claude mcp add notedeck -- nd mcp.
  • nd spawn [--json] [<dir>] — open a Dave session in <dir> (default the current directory, resolved and checked locally) and focus it, starting Dave if it isn't open. Prints Spawned session <id>, or the bare id with --json. It calls dave_spawn_session; agentium spawn is the relay one for other hosts.
  • nd --version — nd's version, and the running notedeck's.
  • nd <cmd> --help, nd help options — per-command pages, exit codes.

Examples

nd call open headway:notedeck/balcony-warm-action
nd call open agentium:evolve-rule-carry
nd call open reference=agentium:evolve-rule-carry msg="rebase onto master"
nd call headway_open_review_queue
nd call headway_show_card --json '{"card":"headway:notedeck/balcony-warm-action"}'

Output and exit codes

  • Data prints as JSON on stdout (indented on a terminal, one line in a pipe), exit 0.
  • A UI tool that acted on the window prints nothing, exit 0.
  • A tool error goes to stderr, exit 1 (also for a bad command line).
  • No notedeck listening: notedeck isn't running (no socket at …), exit 2.

A headless notedeck (--headless) refuses UI tools whose answer is a window action. Tests must point NOTEDECK_SOCKET at a short temp path (a Unix socket path must fit in ~100 bytes), never the user's real socket.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agentium

Free

Query and control Dave agentic sessions from the command line via the `agentium` CLI (crates/agentium_cli), and find your OWN session's agentium: reference. Use when an agent running inside a Dave session needs its own ref (e.g. for a headway done-comment), to list sibling sessions, or to pull another session's detail or full conversation transcript — e.g. "what's my agentium ref", "list the running agent sessions", "show sessions in this cwd", "read session X's transcript".

The English summary is being prepared. Showing the original description.

damus-io/notedeck317Updated Oct 19, 2026

cashflow

Free

Categorize jb55's personal finance ledger from the command line via the `cashflow` CLI (crates/cashflow_cli) — burn down the uncategorized ("unknown") transactions with rules, overrides, splits and transfer links, previewing every write first. Use when asked to categorize transactions, clear the triage queue, add or fix a categorization rule, link transfers between own accounts, or review what an agent session categorized — e.g. "categorize my amex rows", "burn down the unknowns", "why is this charge in expenses:unknown", "undo what that session did".

The English summary is being prepared. Showing the original description.

damus-io/notedeck317Updated Oct 19, 2026

ff-worktrees

Free

Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits. Use when the user wants to sync/update their worktree branches to latest master — e.g. "/ff-worktrees", "ff all worktrees to github/master", "fast-forward the worktrees".

The English summary is being prepared. Showing the original description.

damus-io/notedeck317Updated Oct 19, 2026

handoff

Free

Hand off to a fresh Dave session — ask the user what to work on next, spawn a new session in the current worktree, and send it the task as its first message. Use when the user wants to delegate the next unit of work to a brand-new agentic session rather than continue in this one — e.g. "/handoff", "hand this off", "spawn a session to do X next", "start a fresh session on the next task". `/handoff autowork <task>` also branches the new session off the `autowork` branch and has it land its commit there.

The English summary is being prepared. Showing the original description.

damus-io/notedeck317Updated Oct 19, 2026

headway

Free

Read and edit a Headway kanban board from the command line via the `headway` CLI (crates/headway_cli). Use when the user wants to view the board, add/move/edit/archive cards, or shuffle work between columns like Backlog, Todo, In Progress, In Review, and Done — e.g. "move X to done", "show the board", "add a card to todo".

The English summary is being prepared. Showing the original description.

damus-io/notedeck317Updated Oct 19, 2026

notebook

Free

Read and edit a notebook canvas from the command line via the `notebook` CLI (crates/notebook_cli). Use when the user wants to view the canvas, add/move/edit/recolor/delete nodes, connect or disconnect edges, restack, seed, or rename the canvas — e.g. "show the notebook", "add a node", "move that node", "connect these two nodes".

The English summary is being prepared. Showing the original description.

damus-io/notedeck317Updated Oct 19, 2026

See all skills by damus-io

Report a problem with this skill