videocut-skill 0.1.0

Shared local runtime for the VideoCut paid skill

VideoCut Skill Runtime

VideoCut Skill Runtime is the local CLI used by the public VideoCut paid skill. It keeps hosted rendering, account binding, and point deduction on the VideoCut server, while giving technical users a local command for login, submit, wait, and download.

This package is published on PyPI as videocut-skill.

PyPI publishing is prepared but still waiting on Trusted Publisher setup in PyPI. Until the first PyPI release is live, install from GitHub with:

python3 -m pip install --user --break-system-packages pipx && python3 -m pipx install "git+https://github.com/maxiusi3/videocut-skill-runtime.git"

Requirements

• Python 3.10+
• pipx
• A VideoCut account with available points

Install

python3 -m pip install --user --break-system-packages pipx && python3 -m pipx install videocut-skill

If videocut-skill is not found after installation, run python3 -m pipx ensurepath, reopen your shell, and retry.

First Login

Claude Code:

videocut-skill login --host claude_code --base-url https://<your-videocut-host>

Codex:

videocut-skill login --host codex --base-url https://<your-videocut-host>

The CLI opens a browser window to complete VideoCut account binding and then stores a local client token.

Common Commands

Submit a task asynchronously:

videocut-skill generate "/path/to/task-directory" --host claude_code --base-url https://<your-videocut-host>

Wait for completion and download automatically:

videocut-skill generate "/path/to/task-directory" --host claude_code --base-url https://<your-videocut-host> --wait

Check job status:

videocut-skill status 123 --host claude_code --base-url https://<your-videocut-host>

Download a finished result:

videocut-skill download 123 --host claude_code --base-url https://<your-videocut-host> --output ./final.mp4

Supported Task Layouts

Script mode:

task-directory/
  script/main.txt
  clip/
    001.mp4
    002.mp4

Scriptless mode:

task-directory/
  001.mp4
  002.mov

Update

python3 -m pipx upgrade videocut-skill || python3 -m pipx install videocut-skill

Uninstall

pipx uninstall videocut-skill