walnut-session-messaging

Solid

Talk to the user's OTHER Walnut coding sessions: discover them with `session_list`, send one a message with `session_send`, ask for a result with `expect_reply`, answer a request with `in_reply_to`, and block with `walnut wait` only when you cannot continue without the answer. Use when you need to hand off findings, tell a sibling session that shared work is ready, ask another session a question and get its answer back, or see what else is running. Works on any host that runs a Walnut daemon, inside a Walnut-launched session or a plain terminal.

AI & Automation 32 stars 8 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
51
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Talking to the user's other sessions Two operations cover everything: `session_list` finds sessions, `session_send` talks to one. Both go through `walnut tools call`, which works from any Walnut-managed session on any host and from a plain terminal. The old `walnut peers` commands were removed in 2026-08. `walnut peers` now exits with a usage error naming the replacements, so an old habit fails loudly instead of doing nothing: | Old command | Call this instead | |---|---| | `walnut peers list` | `walnut tools call session_list '{}'` | | `walnut peers send <target> <text>` | `walnut tools call session_send '{"to":"<target>","text":"..."}'` | ## Zero configuration - Inside a session Walnut launched, `walnut` is already on the PATH and uses the injected `WALNUT_AGENT_SOCKET` + `WALNUT_SESSION_ID`. - Started by hand (a plain terminal, an agent you launched yourself), `walnut` falls back to this host's own daemon socket and identifies as an external caller. Same commands, same capabilities; only the sender label differs, because there is no session to name. If `walnut` is not on your PATH, the daemon also installs it at `~/.local/bin/walnut`. ## Discover ```bash walnut tools call session_list '{}' # the user's sessions across all hosts walnut tools call session_list '{"status":"running"}' # running | idle | stopped | error ``` ## Send ```bash walnut tools call session_send '{"to":"9f3a","text":"auth fixture refactor is merged on main; rebase befor...

Details

Author
EvanZhang008
Repository
EvanZhang008/open-walnut
Created
6 months ago
Last Updated
4 days ago
Language
TypeScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

walnut-peer-sessions

Discover and message the user's other Walnut-managed coding sessions with the `walnut` CLI (peer sessions on this or other machines). Use when a session needs to hand off context, notify a sibling session that shared work is ready, or check what other sessions are running. Works on any host that runs a Walnut daemon, inside a Walnut-launched session or a plain terminal.

32 Updated 4 days ago
EvanZhang008
Code & Development Solid

walnut

Walnut is the user's personal AI for tasks, projects, memory, notes, coding sessions, and search. Use for ANY question about Walnut itself or the data it holds: server status, mode, or version; which task or session produced a given commit; what is on the user's plate; creating, updating, completing, searching, or recalling tasks, memory, and notes; starting a coding session for a task, messaging a session that is already running, and getting its answer back; handing finished work back for human review; sending the human a letter (human inbox) when work finishes or a decision is needed. Triggers: "add a task", "put that on my list", "what's on my plate", "did I write anything about X", "which task/session did X", "start a session on this", "tell that other session ...". Read this BEFORE guessing subcommands, running --help, inspecting files, or reaching for git: those guess, this gives the exact call. Works through the `walnut` CLI over Bash (the same `walnut` command works inside managed sessions on any host

32 Updated 4 days ago
EvanZhang008
AI & Automation Solid

walnut-self-knowledge

Understand Walnut's task, project, session, messaging, and lifecycle rules. Read when deciding whether to work directly, record a task, start a session for it, message a session that is already running, resolve cwd, or hand work back to the user.

32 Updated 4 days ago
EvanZhang008