Walnut

Documentation

Agent skills

Walnut ships project agent skills so Cursor, Claude Code, and other IDEs can build apps from a walnut new tree without extra setup.

One-minute path

walnut new HelloApp
cd HelloApp
# Open this folder in Cursor or Claude Code — skills are already under:
#   .cursor/skills/   and   .claude/skills/
walnut skills list

Existing apps created before this layout:

cd MyApp
walnut skills install          # copy skills + write AGENTS.md if missing
# optional: rm -rf .agent-skills   # legacy path; no longer used

What gets installed

PathRole
AGENTS.mdAlways-on brief for agents that read project instructions
.cursor/rules/walnut.mdcCursor always-apply reminder
.cursor/skills/<name>/SKILL.mdCursor project skills
.claude/skills/<name>/SKILL.mdClaude Code project skills (identical copies)

walnut skills install overwrites skill directories (CLI-owned). It writes AGENTS.md only if missing unless you pass --force. Use --skills-only to skip AGENTS.md and the Cursor rule.

Catalog

SkillWhen to use
walnut-devEveryday check / test / simulator / device / hot reload
walnut-debugLive TEA console: p model, dispatch, time travel
walnut-testHost JIT walnut test suites
walnut-languageTEA / List / String / Attr pitfalls
walnut-diagnosticsReading WN#### compiler diagnostics
walnut-uiViews, floatBottom, glass, screenshot-verify UI
walnut-effectsCmd / Sub / Port / host registration
walnut-screenshotsApp Store captures under store/

Commands

walnut skills install [dir] [--skills-only] [--force] [--runtime PATH]
walnut skills list [dir] [--runtime PATH]

Limits

  • Skills teach app workflows.
  • Discovery depends on the IDE: Cursor loads .cursor/skills/; Claude Code loads .claude/skills/; Codex-style agents typically read AGENTS.md.
  • Refresh after upgrading the CLI so new skills appear in older apps.