Agent skill

cli-anything-obs_studio

Command-line interface for Obs Studio - A stateful command-line interface for OBS Studio scene collection editing, following the same patter...

View SKILL.md on GitHub Repository
Stars 30,283
Forks 2,902

Install this agent skill to your Project

npx add-skill https://github.com/HKUDS/CLI-Anything/tree/main/obs-studio/agent-harness/cli_anything/obs_studio/skills

SKILL.md

cli-anything-obs_studio

A stateful command-line interface for OBS Studio scene collection editing, following the same patterns as the Blender CLI harness. Uses a JSON scene collection format. No OBS installation required for editing.

Installation

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

bash
pip install cli-anything-obs_studio

Prerequisites:

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

Usage

Basic Commands

bash
# Show help
cli-anything-obs_studio --help

# Start interactive REPL mode
cli-anything-obs_studio

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

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

REPL Mode

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

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

Command Groups

Project

Project management commands.

Command Description
new Create a new OBS scene collection
open Open an existing project
save Save the current project
info Show project information
json Print raw project JSON

Scene Group

Scene management commands.

Command Description
add Add a new scene
remove Remove a scene by index
duplicate Duplicate a scene
set-active Set the active scene
list List all scenes

Source Group

Source management commands.

Command Description
add Add a source to a scene
remove Remove a source by index
duplicate Duplicate a source
set Set a source property (name, visible, locked, opacity, rotation)
transform Transform a source (position, size, crop, rotation)
list List all sources in a scene

Filter Group

Filter management commands.

Command Description
add Add a filter to a source
remove Remove a filter from a source
set Set a filter parameter
list List all filters on a source
list-available List all available filter types

Audio Group

Audio management commands.

Command Description
add Add a global audio source
remove Remove a global audio source
volume Set volume for an audio source (0.0-3.0)
mute Mute an audio source
unmute Unmute an audio source
monitor Set audio monitoring type
list List all audio sources

Transition Group

Transition management commands.

Command Description
add Add a transition
remove Remove a transition
set-active Set the active transition
duration Set transition duration in milliseconds
list List all transitions

Output Group

Output/streaming/recording configuration.

Command Description
streaming Configure streaming settings
recording Configure recording settings
settings Configure output settings
info Show current output configuration
presets List available encoding presets

Session

Session management commands.

Command Description
status Show session status
undo Undo the last operation
redo Redo the last undone operation
history Show undo history

Examples

Create a New Project

Create a new obs_studio project file.

bash
cli-anything-obs_studio project new -o myproject.json
# Or with JSON output for programmatic use
cli-anything-obs_studio --json project new -o myproject.json

Interactive REPL Session

Start an interactive session with undo/redo support.

bash
cli-anything-obs_studio
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation

State Management

The CLI maintains session state with:

  • Undo/Redo: Up to 50 levels of history
  • Project persistence: Save/load project state as JSON
  • Session tracking: Track modifications and changes

Output Formats

All commands support dual output modes:

  • Human-readable (default): Tables, colors, formatted text
  • Machine-readable (--json flag): Structured JSON for agent consumption
bash
# Human output
cli-anything-obs_studio project info -p project.json

# JSON output for agents
cli-anything-obs_studio --json project info -p project.json

For AI Agents

When using this CLI programmatically:

  1. Always use --json flag for parseable output
  2. Check return codes - 0 for success, non-zero for errors
  3. Parse stderr for error messages on failure
  4. Use absolute paths for all file operations
  5. Verify outputs exist after export operations

More Information

  • Full documentation: See README.md in the package
  • Test coverage: See TEST.md in the package
  • Methodology: See HARNESS.md in the cli-anything-plugin

Version

1.0.0

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

HKUDS/CLI-Anything

cli-anything-sts2

Command-line interface for Slay the Spire 2 - Control the real game through a local bridge mod HTTP API. Reads normalized game state and sends action commands for combat, navigation, rewards, and menu management.

30,283 2,902
Explore
HKUDS/CLI-Anything

musescore

CLI for music notation — transpose, export PDF/audio/MIDI, extract parts, manage instruments

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-videocaptioner

AI-powered video captioning — transcribe speech, optimize/translate subtitles, burn into video with beautiful customizable styles (ASS outline or rounded background). Free ASR and translation included.

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-openscreen

Command-line interface for Openscreen — a screen recording editor. A stateful CLI for editing screen recordings with zoom, speed ramps, trim, crop, annotations, and polished exports. Built on the Openscreen JSON project format with ffmpeg as the rendering backend. Designed for AI agents and power users who need programmatic video editing.

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-adguardhome

Command-line interface for AdGuard Home - Network-wide ad blocking and DNS management via AdGuard Home REST API. Designed for AI agents and power users who need to manage filtering, DNS rewrites, clients, DHCP, and query logs without a GUI.

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-intelwatch

Zero friction. Full context. Competitive intelligence, M&A due diligence, and OSINT directly from your terminal. Uses Node.js/npx.

30,283 2,902
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results