walnut-self-knowledge

Solid

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.

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

Install

View on GitHub

Quality Score: 85/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

# Walnut self-knowledge Use the current tool schema for exact arguments. This skill explains decisions, not parameter tables. ## Choose the work path - Do quick, simple work directly when the user did not ask to track it. - Use `task_create` when the user wants a record and nothing should start yet. - Use `task_create` then `session_start` for complex or long-running work that should begin now. - Use `session_send` for work that is already running, including work someone else started. - If work may already exist, search first. Reuse only after finding an explicit task ID. Never merge by a similar title. ## Start and continue work safely - New work: `task_create` records it, then `session_start` opens its session and sends the first message. Pass cwd, host, engine, model, or mode only when you know they differ from the defaults. - Already-tracked work: `session_start` with the task ID. A task holds one live session, so a task that is already running answers a conflict carrying the live session ID. That is the signal to switch to `session_send`, not to retry. - Already-running work: `session_send` addressed by session ID, task ID, or a unique title substring. A task with nothing running answers a conflict telling you to start one. - A successful start is accepted asynchronously. It means Walnut recorded and queued the start, not that the coding process has already finished. - To get a result back, add `expect_reply` on either op and keep working. The answer, or Walnut's no...

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

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-console-ops

Operating the Walnut web UI (localhost:3456) via Playwright MCP tools — understanding the UI layout, chatting with main agent, interacting with sessions, monitoring status changes. Use when asked to test, verify, or interact with the Walnut web console as a human user would.

32 Updated 4 days ago
EvanZhang008
AI & Automation Solid

walnut-session-messaging

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.

32 Updated 4 days ago
EvanZhang008