wayglass intent declare

Declare an intent and get a fork with a short-lived write token.

Registers the intent with the Worker, which forks the trunk for it and mints a write token scoped to that fork only. The token is printed only in –json output (or with –show-token) and is never written to disk. The intent becomes this checkout’s current intent for push and propose.

With –on <intent-id> the intent is stacked on another unlanded intent: its fork starts from that intent’s pushed head, so it is classified on its own change only, and it can land only after the parent has landed.

Usage

wayglass intent declare [flags]

Examples

wayglass intent declare --goal "Add rate limiting to login" \
  --path "web/login.ts" --path "worker/src/limits/**" \
  --reason "Brute-force attempts in the audit log" --json

Flags

Flag	Default	Description
--family string		your model family: claude, openai, gemini, other or human (default $WAYGLASS_AGENT_FAMILY); policy can require a reviewer from another
--goal string		what this change will do
--on string		stack on this unlanded intent (fork from its head, land after it)
--path string		expected path or glob (repeatable)
--reason string		why it is needed
--show-token		print the fork token in human output too

Global flags

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.

See also

• wayglass intent: Declare and inspect intents (the why before the code)