cli-anything-audacity

A stateful command-line interface for audio editing, following the same patterns as the GIMP and Blender CLIs in this repo.

Installation

This CLI is installed as part of the cli-anything-audacity package:

pip install cli-anything-audacity

Prerequisites:

• Python 3.10+
• audacity must be installed on your system

Usage

Basic Commands

# Show help
cli-anything-audacity --help

# Start interactive REPL mode
cli-anything-audacity

# Create a new project
cli-anything-audacity project new -o project.json

# Run with JSON output (for agent consumption)
cli-anything-audacity --json project info -p project.json

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

cli-anything-audacity
# Enter commands interactively with tab-completion and history

Command Groups

Project

Project management commands.

Command	Description
new	Create a new project
open	Open an existing project
save	Save the current project
info	Show project information
settings	View or update project settings
json	Print raw project JSON

Track

Track management commands.

Command	Description
add	Add a new track
remove	Remove a track by index
list	List all tracks
set	Set a track property (name, mute, solo, volume, pan)

Clip

Clip management commands.

Command	Description
import	Probe/import an audio file (show metadata)
add	Add an audio clip to a track
remove	Remove a clip from a track
trim	Trim a clip's start and/or end
split	Split a clip at a given time position
move	Move a clip to a new start time
list	List clips on a track

Effect Group

Effect management commands.