damus-io/notedeck / .claude/skills/nd
nd
VerifiedDrive 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".
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, markeddata/uiandro(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/listandtools/callgo to the socket, one connection each, so it can start before notedeck. Only data tools are exposed unless--ui;--read-onlykeeps only tools that change nothing. A hidden tool can't be called by name. Register it withclaude 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. PrintsSpawned session <id>, or the bare id with--json. It callsdave_spawn_session;agentium spawnis 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |