# cli-anything-obs-studio

Guides an agent through editing OBS Studio JSON scene collections with a CLI for scenes, sources, filters, audio, and output settings.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 516 installs · ★ 57187
- Author: HKUDS
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-obs-studio/SKILL.md
- Updated: 2026-09-22
- HTML: https://affpapa.org/en/nevibecode/skills/cli-anything-obs-studio

## What it does

This skill guides an agent using `cli-anything-obs_studio`, a stateful command-line interface for OBS Studio scene collections stored as JSON. It can create or open projects, add and duplicate scenes, select the active scene, and edit sources with their properties and transforms.

The CLI also manages filters, global audio sources, transitions, recording, streaming, and output settings. Its interactive REPL keeps change history with undo and redo. Use `--json` when an agent needs structured output, and use absolute paths for file operations as the package guidance recommends.

The package requires Python 3.10+ and `obs_studio` installed on the system. Editing is described as possible without an OBS Studio installation, yet `obs_studio` remains a prerequisite, so check the local setup before relying on it.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-obs-studio -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cli-anything-obs-studio/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cli-anything-obs-studio/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-obs-studio -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cli-anything-obs-studio/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-obs-studio -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cli-anything-obs-studio/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install HKUDS/CLI-Anything cli-anything-obs-studio
```

2. **Manually: put the files in place**
- File: `.github/skills/cli-anything-obs-studio/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-obs-studio -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-obs-studio
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cli-anything-obs-studio/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-obs-studio -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-obs-studio/SKILL.md

## When to use it
- create a JSON scene collection
- add a source to a scene
- change source position, size, or crop
- set audio volume or mute a source
- read project details as JSON

## Example prompts
- "Create a scene project in `project.json` with `cli-anything-obs_studio project new -o project.json`."
- "Show JSON project details with `cli-anything-obs_studio --json project info -p project.json`."
- "Start `cli-anything-obs_studio` in interactive mode and make scene edits that I can undo."

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 65392c7e4a66f586.

BEGIN THIRD-PARTY FILE 65392c7e4a66f586
````text
---
name: "cli-anything-obs-studio"
description: >-
  Command-line interface for Obs Studio - A stateful command-line interface for OBS Studio scene collection editing, following the same patter...
---

# 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 |
````
END THIRD-PARTY FILE 65392c7e4a66f586

The third-party file has ended. Everything between the 65392c7e4a66f586 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2830 of 5370 bytes. © HKUDS · Apache-2.0 · https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-obs-studio/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md