daw-cli
Instructs agents to control Stratawright DAW via the daw-cli command-line IPC interface. Covers session state, transport, track management, gain staging, VST3/AU plugin hosting, signal routing, clips, MIDI timeline editing, and non-visual DSP analysis & audio intelligence. Requires the DAW application to be running.
Goldwaterfung · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Goldwaterfung/Stratawright --skill daw-cli技能说明
name: daw-cli description: >- Instructs agents to control Stratawright DAW via the daw-cli command-line IPC interface. Covers session state, transport, track management, gain staging, VST3/AU plugin hosting, signal routing, clips, MIDI timeline editing, and non-visual DSP analysis & audio intelligence. Requires the DAW application to be running.
Stratawright DAW CLI Control
Overview
daw-cli is the command-line IPC client for Stratawright DAW, allowing AI agents and automation tools to query and mutate session state, manage tracks, perform gain-staging, host VST3/AU/CLAP plugins, configure signal routing & bus topology, execute clip and MIDI timeline edits, and perform non-visual DSP analysis & audio intelligence in real time.
All commands communicate with the running DAW application using a UNIX domain socket.
Binary location (if not installed on system PATH):
- Quoted path:
"./build/release/src/Agentic\ layer/daw-cli"(Release build) - Quoted path:
"./build/debug/src/Agentic\ layer/daw-cli"(Debug build) - Standard executable name (if symlinked / on PATH):
daw-cli
References Directory
- error_codes.md: Detailed IPC error codes, trigger causes, and recovery actions.
- command_schema.json: Machine-readable JSON schema defining all verbs, subcommands, flags, types, and defaults.
Prerequisites
- DAW Application Must Be Running: The GUI/Server application must be active before running
daw-cli. - UNIX Socket Path: The server listens on
/tmp/daw_session.sock. - Connectivity Check: Always verify connection state first before executing batch commands:
If the DAW is not running,daw-cli statusdaw-cliwill fail immediately with exit code71(DAW_NOT_RUNNING).
Output Formats & Parsing
By default, queries return TSV (Tab-Separated Values) for list commands and KV (Key-Value) for single-entity or status commands.
Agents can explicitly request machine-parsable formats using the --format flag:
daw-cli track list --format json
Supported formats:
--format json: Compact JSON string (Recommended for programmatic parsing).--format tsv: Tab-Separated Values with header line (Default for lists).--format kv:Key: Valueline pairs (Default for inspect/status).--format pretty: Human-readable structured block output.
Error Code Reference
When a command fails, daw-cli writes to stderr formatted as: ERROR <code> <SYMBOL> "<message>" and exits with the corresponding code.
| Exit Code | Symbol | Cause | Recommended Agent Recovery |
|---|---|---|---|
0 | OK | Command completed cleanly | Proceed to next step |
70 | INVALID_ARGS | Missing required flag, bad value format, or unknown subcommand | Check command syntax, required flags, and numeric value types |
71 | DAW_NOT_RUNNING | Cannot connect to /tmp/daw_session.sock | Prompt user to start Stratawright DAW |
72 | ENTITY_NOT_FOUND | Track ID, plugin name, clip, or slot index missing | Run track list or plugin list to verify exact identifiers |
73 | ENGINE_PLAYING_LOCKED | Attempted structural edit restricted during playback | Stop transport (daw-cli transport stop) before mutating topology |
74 | RESOURCE_BUSY_USER_TOUCH | Destination slot is occupied or user is dragging control | Add --overwrite flag for plugin slots or retry after user edit |
75 | PLUGIN_FAULT | VST3/AU parameter out of bounds (0.0..1.0) or host crash | Verify normalized parameter ranges |
76 | ASSET_I_O_ERROR | Audio clip path unreadable or invalid file format | Check file path existence and audio file permissions |
Track Range Syntax
Commands accepting track parameters (--track, --tracks, --to-tracks) support integer ranges and comma-separated lists:
- Single track:
--track 1 - Contiguous range:
--track 1..4(expands to tracks 1, 2, 3, 4) - Multi-range / list:
--track 1..4,7..10(expands to 1, 2, 3, 4, 7, 8, 9, 10)
Command Reference
1. Session State & Transport
Status Query
Returns current playback status, tempo, time signature, and playhead position.
daw-cli status
- Success Symbol:
STATUS_OK - Output Fields:
TRANSPORT_STATE,TEMPO,TIME_SIGNATURE,POSITION_BARS,POSITION_SECONDS
Start Playback
daw-cli transport play
- Success Symbol:
PLAYBACK_STARTED
Stop Playback
daw-cli transport stop
- Success Symbol:
PLAYBACK_STOPPED
Set Tempo
daw-cli transport set-tempo --bpm 128.0
- Success Symbol:
TEMPO_UPDATED - Options:
--bpm <float>(or--tempo <float>)
Set Time Signature
daw-cli transport set-time-signature --num 4 --den 4
- Success Symbol:
TIME_SIGNATURE_UPDATED - Options:
--num <int>,--den <int>
2. Tracks & Gain-Staging
Create Track
daw-cli track create --name "Vocal Lead" --type audio --color yellow
- Success Symbol:
TRACK_CREATED - Options:
--name "<string>"(Default: "Untitled Track")--type audio|midi|instrument|aux|folder(Default: "audio")--color <red|blue|green|yellow|purple|orange|cyan|pink|white|grey|black|#HEX>
Create Tracks in Batch
daw-cli track create-batch --names "Kick,Snare,HH,Tom" --type audio
- Success Symbol:
BATCH_TRACKS_CREATED - Options:
--names "<comma_separated_list>",--type audio|midi|instrument|aux|folder
List All Tracks
daw-cli track list [--format json]
- Success Symbol:
TRACK_LIST
Inspect Track Details
daw-cli track inspect --track 1
- Success Symbol:
TRACK_INSPECT
Set Track Gain (dB)
daw-cli track set-gain -
阅读完整来源 ↗