cli-anything-wavetone — Claude Code skill: setup and overview
cli-anything-wavetone prepares JSON manifests and opens WaveTone 2.61 for audio transcription. Built for agents handling tempo settings, labels, and audio checks on Windows.
Apache-2.0 265 installs ★ 62,125 updated 2026-09-22
npx skills add HKUDS/CLI-Anything --skill cli-anything-wavetone -a claude-codeWhat cli-anything-wavetone does
This skill bridges agent workflows with the WaveTone 2.61 desktop audio analyzer. Instead of editing raw binary files directly, an agent builds a JSON project manifest containing the audio source path, planned tempo, meter, and timeline labels.
The CLI tool exposes subcommands under project, audio, wavetone, session, and defaults. Every command accepts --json for structured output. Agents can probe track metadata before opening the GUI, log session steps, or verify the executable with wavetone doctor. Automated pipelines can start the application with --wait 1 --terminate to verify execution without leaving background processes.
The workflow depends strictly on Windows and an unzipped copy of WaveTone 2.61. Point the WAVETONE_EXE or WAVETONE_HOME environment variables to your custom path if you avoid default portable directories. Note that the generated JSON manifest is an orchestration plan: transcription and exports to WFD, MIDI, or text require the actual WaveTone application.
What it helps with
- generate JSON project manifests with tempo and label data
- inspect audio metadata prior to transcription
- launch the WaveTone 2.61 Windows GUI from agent workflows
- verify WaveTone executable availability using
doctor
Example prompts for the agent
- Create a new project project.wt.json for input.wav with tempo 120 and meter 4/4.
- Probe the audio metadata for project.wt.json before launching WaveTone.
- Add a chorus label at 64.0 seconds in project.wt.json and launch the GUI.
How to install cli-anything-wavetone
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-wavetone -a claude-code2Manually: put the files in place
~/.claude/skills/cli-anything-wavetone/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-anything-wavetone/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-wavetone -a codex2Manually: put the files in place
.agents/skills/cli-anything-wavetone/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-wavetone -a cursor2Manually: put the files in place
.cursor/skills/cli-anything-wavetone/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install HKUDS/CLI-Anything skills/cli-anything-wavetone2Manually: put the files in place
.github/skills/cli-anything-wavetone/SKILL.md1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-wavetone -a gemini-cli2Platform CLI
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-wavetoneManually: put the files in place
.devin/skills/cli-anything-wavetone/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-wavetone -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cli-anything-wavetone
How do I install cli-anything-wavetone in Claude Code?
Install it by running npx skills add HKUDS/CLI-Anything --skill cli-anything-wavetone -a claude-code. This adds the skill definition to ~/.claude/skills/cli-anything-wavetone/SKILL.md.
Does the JSON project manifest replace WaveTone WFD files?
No. The JSON manifest is an agent-facing plan that stores metadata, labels, and analysis settings. Generating WFD, MIDI, or text files requires running WaveTone itself.
What are the system requirements for cli-anything-wavetone?
It requires a Windows environment and a local copy of WaveTone 2.61. Configure WAVETONE_EXE or WAVETONE_HOME if WaveTone is not stored in its default portable directory.
Source text
SKILL.md · Apache-2.0
--- name: "cli-anything-wavetone" description: "Control WaveTone 2.61 workflows through a JSON manifest and launch the real Windows WaveTone executable." --- # cli-anything-wavetone Use this skill when an agent needs to prepare, inspect, and launch WaveTone 2.61 audio transcription workflows. ## Requirements - Windows host. - WaveTone 2.61 extracted locally. - Set `WAVETONE_EXE` to `wavetone.exe` or `WAVETONE_HOME` to the extracted WaveTone directory when the default portable path is not used. ## Core Commands All commands support the top-level `--json` flag. ```bash cli-anything-wavetone --json wavetone doctor cli-anything-wavetone --json project new input.wav -o project.wt.json cli-anything-wavetone --project project.wt.json --json audio probe cli-anything-wavetone --project project.wt.json --json project set-tempo --bpm 120 --meter 4/4 cli-anything-wavetone --project project.wt.json --json project add-label chorus --time 64.0 cli-anything-wavetone --project project.wt.json --json wavetone launch ``` ## Command Groups - `project`: create manifests, set tempo, add labels, update intended analysis settings, and attach a WFD saved from WaveTone. - `audio`: probe audio metadata before opening it in WaveTone. - `wavetone`: run `doctor`, list supported formats, or launch the real GUI. - `session`: record lightweight event logs for multi-step agent workflows. - `defaults`: show default analysis settings. ## Agent Guidance The JSON project manifest is not a WaveTone WFD file. It is an agent-facing plan for the source audio, intended analysis settings, labels, and tempo metadata. Use WaveTone itself to perform analysis and save WFD/MIDI/text/WAVE outputs. When running in automated checks, use: ```bash cli-anything-wavetone --json wavetone launch input.wav --wait 1 --terminate ``` This confirms that the real backend can be started without leaving a persistent GUI process behind.
© HKUDS · Apache-2.0 · HKUDS/CLI-Anything