Summarizes an Audionaut project: tempo, tracks, clips with positions/durations and their audio files. Set raw=true for the full persistence JSON instead of the summary.

Creates a new empty Audionaut project (.audium package) with one track. Fails if the path already exists.

Imports one or more audio files into the project at the given position and saves it. Note: importing creates a new track holding the files.

Renders the project offline to a WAV file (no audio device needed). Pass region to bounce a single region instead - always dry, without any clip's gains or fades.

Runs Essentia audio analysis (segment boundaries, beats, BPM) on the project's audio files - or one standalone audio file - and caches the results next to the project for auto_edit/assemble to use. Fails with essentia_unavailable in builds without Essentia.

Segments a clip on a track using cached analysis results (run analyze first). Splits the clip into musically-aligned regions.

Builds an arrangement of the given duration from the project's regions, sequentially or at random (requires regions - e.g. from auto_edit).

Splits the clip under the given timeline position into two on every track that has one there (the GUI's Split command). Fails with nothing_to_split when no clip spans the position.

Creates a named region from a timeline range on every track whose clip fully contains it (the GUI's Create Region command). The arrangement itself is unchanged.

Renames a region and/or retrims its source-relative range (clamped to the source audio). Clips have no length of their own, so a retrim affects every clip using the region.

Removes the clip at a timeline position (one clip; ambiguity across tracks needs track), or every placement of a named region. delete_region also drops the region itself unless other clips use it.

Moves one clip to a new timeline position and/or onto another track. Address it by position (at) or region name; the address must match exactly one clip. to_track takes a track id, or "new" to create a track for it; without to the clip keeps its position. Give at least one of to and to_track.

Creates a new clip from an existing named region at a timeline position, on the track that owns the region (track only disambiguates same-named regions).

Deletes every region that has no clip on the timeline (the GUI's Delete Unused Regions). The audio files stay in the package.

Sets the addressed clip's gain - linear by default, dB with db=true - on every destination channel, or one channel. The address (at or region) must match exactly one clip.

Sets a clip's playback speed (ratio 0.25-4, 2.0 = double speed, half as long). The mode picks how: repitch (default, varispeed - pitch and length change together) or stretch (pitch-preserving time-stretch). Mode can also be changed on its own. lockTempo ties the clip to the project tempo (speed = project tempo / clip tempo, following tempo changes); the clip tempo is detected by beat tracking or given with tempo, which implies the lock.

Splits a clip into Drums/Bass/Other/Vocals tracks with the Demucs (htdemucs) source separator, aligned with the source clip. Slow: minutes for a full song, CPU only. Needs the model weights, which the Audionaut app downloads once (Settings > Separation); fails with model_missing until then, and with demucs_unavailable in builds without Demucs.

Sets the addressed clip's fade lengths, ramp offsets (0 clears; offsets may be negative to reach outside the clip) and curve exponents (0.1-4, 0.5 = equal power). Values are clamped against each other within the clip. The address must match exactly one clip.

Removes a whole track from the project, including its channels, clips and regions. Track ids are positions in the track list, so the ids of the tracks below shift up by one. The audio files stay in the package.

Removes one channel (0-based) from a track, like deleting a channel strip in the GUI. Channel mappings and per-channel clip gains shift down; the audio files stay in the package.

Sends a feature request to the Audionaut maintainer as a GitHub issue. Use it when a task needs something the other tools cannot do: a missing verb or option, a limit that got in the way, or a workflow that took a clumsy workaround. Say what the user was trying to achieve and why the current tools fall short - that context is what makes the request actionable. Tell the user you are sending it; include their name or e-mail only if they offered it. If nothing could be sent, the reply carries a prefilled issue link to hand to the user.

Reports a bug in Audionaut to the maintainer as a GitHub issue. Use it when a tool misbehaves: an error that should not happen, a wrong or inconsistent result, a crash, or a project left in a bad state. Quote the exact tool call and error text - the CLI's code and message - and say what you expected instead; that is what makes the report reproducible. Never include the audio itself, and keep file paths to what is needed. Tell the user you are sending it; include their name or e-mail only if they offered it. If nothing could be sent, the reply carries a prefilled issue link to hand to the user.