What problem does it solve?
This guide helps developers extend Wave Terminal by adding new wsh commands, enabling custom CLI capabilities and backend integrations without modifying core code.
Core Features & Use Cases
- Provides a clear pattern for creating Cobra-based command files (wshcmd-*.go) with RunE logic, PreRunE, flags, and block resolution.
- Defines RPC integration via the wshrpc/wshclient interfaces, enabling commands to perform backend operations and telemetry.
- Covers documentation, testing, and onboarding steps to publish new commands for team use.
Use cases include adding new commands to automate workflows, extend CLI capabilities, and implement bespoke administrative tools.
Quick Start
Create the command file in cmd/wsh/cmd named wshcmd-[name].go, implement RunE logic and PreRunE if RPC is needed, wire it into init(), and update the in-repo documentation.