免费在 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".

中文简介正在准备中。当前显示原文说明。

damus-io/notedeck星标 317(GitHub 317 + cccskills 0)

实测评分未实测

查看安装方法

包含的文件（1）

SKILL.md3.2 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

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.

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

agentium

免费

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".

中文简介正在准备中。当前显示原文说明。