add-wshcmd

Scaffold and implement wsh commands in Wave Terminal with RPC integration.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/lihonghuacgk/waveterm --skill add-wshcmd-lihonghuacgk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-wshcmd
Source: https://github.com/lihonghuacgk/waveterm/tree/main/.kilocode/skills/add-wshcmd
Command: npx skills add https://github.com/lihonghuacgk/waveterm --skill add-wshcmd-lihonghuacgk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers integrating new functionality into Wave Terminal often lack a single-source blueprint for adding new wsh commands, ensuring consistent structure, naming, and RPC wiring.

Core Features & Use Cases

  • Provides a complete, repeatable template for creating wshcmd-[commandname].go files with Use, Short, Long, Args, RunE, and optional PreRunE and RPC interactions.
  • Demonstrates how to wire up block resolution, wshclient RPC calls, and metadata updates via CommandSetMetaData, including examples like settitle and version patterns.
  • Includes documentation scaffolding guidance and multi-level command structures (subcommands) to support scalable CLI development.

Quick Start

Create a new wsh command by following the file naming, command structure, and RPC patterns described in this guide.

Frequently Asked Questions about add-wshcmd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new wsh command to Wave Terminal?

To add a new wsh command to Wave Terminal, you scaffold a wshcmd-[commandname].go file implementing the command structure with Use, Short, Long, Args, and RunE frontmatter, then wire up block resolution and RPC calls to finalize the CLI integration.

What is the required file structure for wsh commands in Wave Terminal?

The required wsh command file structure includes frontmatter fields like Use, Short, Long, Args, and RunE, alongside optional PreRunE and RPC interactions. It also specifies block argument resolution, command patterns, and flags for scalable multi-level subcommand development.

How does RPC integration work when creating custom Wave Terminal commands?

RPC integration for custom Wave Terminal commands involves wiring wshclient RPC calls and updating metadata via CommandSetMetaData. This connects the command execution logic to the terminal backend, enabling patterns similar to settitle and version implementations.

Can I create multi-level subcommands for the wsh CLI in Wave Terminal?

Yes, you can create multi-level subcommands for the wsh CLI in Wave Terminal. The scaffolding guide provides templates for establishing parent and child command structures, supporting scalable CLI development with consistent naming and documentation.

What do I need to set up before scaffolding a wsh command?

Before scaffolding a wsh command, you need a Wave Terminal development environment and familiarity with Go. You should understand the wshclient RPC architecture and block resolution concepts to correctly implement the command patterns and metadata updates.

Does scaffolding a new wsh command include documentation and testing guidance?

Yes, scaffolding a new wsh command includes documentation and testing guidance. The blueprint covers the full lifecycle from file naming and command structure to RPC integration and documentation scaffolding, ensuring consistent structure across the CLI.