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