Skip to content

wayglass session share

Freeze the current intent’s context and print a URL to continue it elsewhere.

Records an append-only snapshot of the intent in the Worker: goal, reason, declared and changed paths, decisions and approvals so far, overlaps, its audit history, your handoff notes, and the fork head the Worker reads from Artifacts. HEAD must already be pushed. Anyone logged in to the same Worker can continue it with ‘wayglass session fork <url>’; nobody receives this fork’s write token.

Terminal window
wayglass session share [flags]
Terminal window
wayglass session share --note "Limiter works; lockout tests still missing"
wayglass session share --notes-file HANDOFF.md --json
git log -3 --format=%B | wayglass session share --notes-file -
Flag Default Description
--intent string intent to share (default: this checkout’s current intent)
--note string handoff note for the next agent (repeatable; joined by blank lines)
--notes-file string read handoff notes from a file (‘-’ for stdin)
Flag Default Description
--json print a JSON envelope for agents (no colour, prompts or spinners)

Exit codes and the --json envelope are the same for every command; see For agents.