Spawn a new terminal window to run CLI commands (ffmpeg, curl, python, etc.). Use for non-AI command execution.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Spawn a new terminal window to run CLI commands (ffmpeg, curl, python, etc.). Use for non-AI command execution.
Purpose
Spawn a new terminal window to execute CLI commands. This skill is for generic command execution, NOT for spawning AI agents. For AI agents, use the spawn:agent skill instead.
Variables
Variable
Default
Description
LOG_TO_FILE
false
Write full terminal output to debug file
CAPTURE
false
Block and return output directly
Instructions
MANDATORY - You MUST follow the Workflow steps below in order. Do not skip steps.
Identify the CLI command the user wants to run
Run <command> --help first to verify syntax and options
Execute the command in a new terminal using fork_terminal()
Red Flags - STOP and follow Cookbook
If you're about to:
Execute a command without checking its --help first
Assume you know the command syntax
Skip the --help step "because it's simple"
Spawn an AI agent (use spawn:agent instead)
STOP -> Run <command> --help first -> Review output -> Then proceed
Workflow
MANDATORY CHECKPOINTS - Verify each before proceeding:
Understand the user's request
VERIFY: This is a CLI command, NOT an AI agent request
READ: '../agent/fork_terminal.py' to understand the tooling
Follow the Cookbook: Read './cookbook/cli-command.md'
CHECKPOINT: Ran <command> --help and reviewed options