跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

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

  1. DAW Application Must Be Running: The GUI/Server application must be active before running daw-cli.
  2. UNIX Socket Path: The server listens on /tmp/daw_session.sock.
  3. Connectivity Check: Always verify connection state first before executing batch commands:
    daw-cli status
    
    If the DAW is not running, daw-cli will fail immediately with exit code 71 (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: Value line 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 CodeSymbolCauseRecommended Agent Recovery
0OKCommand completed cleanlyProceed to next step
70INVALID_ARGSMissing required flag, bad value format, or unknown subcommandCheck command syntax, required flags, and numeric value types
71DAW_NOT_RUNNINGCannot connect to /tmp/daw_session.sockPrompt user to start Stratawright DAW
72ENTITY_NOT_FOUNDTrack ID, plugin name, clip, or slot index missingRun track list or plugin list to verify exact identifiers
73ENGINE_PLAYING_LOCKEDAttempted structural edit restricted during playbackStop transport (daw-cli transport stop) before mutating topology
74RESOURCE_BUSY_USER_TOUCHDestination slot is occupied or user is dragging controlAdd --overwrite flag for plugin slots or retry after user edit
75PLUGIN_FAULTVST3/AU parameter out of bounds (0.0..1.0) or host crashVerify normalized parameter ranges
76ASSET_I_O_ERRORAudio clip path unreadable or invalid file formatCheck 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 -
阅读完整来源 ↗