Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Implementation Status

At-a-glance view of wai’s implemented commands and their relation to formal change proposals tracked in openspec/.


Commands

CommandDescription
wai initInitialize wai in any directory
wai tutorialRun the interactive quickstart tutorial
wai statusProject overview and next-step suggestions
wai primeOrient the session; detect resume state
wai closeCapture session state and signal pending resume
wai handoff create <project>Generate a handoff document explicitly
wai showInspect projects, areas, and resources
wai lsList all wai workspaces under a root
wai newCreate projects, areas, and resources
wai addAdd research, plans, designs, and reviews
wai searchFull-text artifact search with tag filtering
wai timelineChronological artifact view across projects
wai whyAsk the LLM oracle about design decisions
wai reflectSynthesize project patterns into CLAUDE.md
wai syncPull remote artifact updates
wai moveRelocate projects and areas
wai importImport existing AI tool configs (.claude/, .cursorrules)
wai phaseShow, advance, or set the current project phase
wai doctorDiagnose and repair workspace health
wai wayCheck and scaffold repository best practices
wai configInspect workspace configuration
wai resourceManage skills, rules, and context resources
wai pluginEnable and disable workspace plugins
wai pipelineRun structured multi-step research workflows
wai projectSession-scope a project (WAI_PROJECT env var)
wai trace(Planned) Import session traces from agent tools

For the authoritative list run wai --help.


Change Proposals

Formal changes are tracked in openspec/changes/. Each entry links a capability to the reasoning that motivated it. Status values come from openspec list; task counts from tasks.md in each change directory.

ChangeStatusRelated Commands
add-cross-tool-trace-ingestionIn progress (0/10)wai trace, wai reflect
add-artifact-integrityCompletewai pipeline lock/verify, wai doctor
add-project-resolutionCompletewai project use, wai ls

Run openspec list for the full list including archived changes.


Capability Specs

Stable capabilities have formal specs in openspec/specs/. These define the expected behavior independently of any single change.

Run openspec list --specs to see current specs.


Release History

Releases follow calendar versioning (vYYYY.M.N). See the GitHub Releases page for the full changelog.