wavelength-cli

Automate Wavelength wallet daemon operations using the wavecli command line tool.

4|4|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/lightninglabs/wavelength-sdk --skill wavelength-cli-lightninglabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wavelength-cli
Source: https://github.com/lightninglabs/wavelength-sdk/tree/main/skills/wavelength-cli
Command: npx skills add https://github.com/lightninglabs/wavelength-sdk --skill wavelength-cli-lightninglabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Scripting against the Wavelength wallet daemon requires knowing wavecli's commands, flags, JSON output mode, and exit codes, and guessing from memory leads to broken automation. This Skill grounds every command in the official CLI documentation so shell scripts and automation behave predictably. ## Core Features & Use Cases - Scripted wallet operations: Build shell automation against waved using wavecli with correct flags and subcommands pulled from the docs. - Reliable parsing and error handling: Use JSON output mode instead of scraping human-readable tables, and handle the full documented set of exit codes rather than assuming 0 or 1. - MCP server exposure: Run wavecli mcp serve to expose the daemon's RPCs as tools over stdio for local MCP clients. - Use Case: You need a cron job that pays invoices through your wallet daemon. Use this Skill to fetch the correct wavecli send flags, parse the JSON response, and branch on documented exit codes. ## Quick Start Use the wavelength-cli skill to write a shell script that sends a payment with wavecli and parses the JSON output.

Frequently Asked Questions about wavelength-cli

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

FAQPage Schema
How do I script wallet operations with wavecli?

Script wavecli by enabling its JSON output mode and checking the documented exit codes for each command. Fetch the command page from the CLI docs (for example cli/send.md) to get the exact flags rather than relying on memory.

How do I parse wavecli output in shell scripts?

Parse wavecli output using its JSON output mode, never by scraping the human-readable table output. The JSON mode is documented on the CLI index page along with global flags and config file options.

What exit codes does wavecli return?

wavecli exit codes are documented on the CLI index page at wavelength.lightning.engineering/cli.md. Do not assume only 0 or 1 are possible; check the documented set and branch on each relevant code in your scripts.

Can wavecli expose wallet RPCs as MCP tools?

Yes, `wavecli mcp serve` runs a local MCP server that exposes the daemon's RPCs as tools over stdio. Details are documented at the cli/mcp.md page of the Wavelength docs.

Where do I find wavecli command flags when they are unclear?

Each wavecli command page names the RPC it invokes, so read the corresponding RPC page in the API docs for field semantics. Start from the CLI section of llms.txt to find the current command list.