daw-cli

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.