spawn:terminal
/spawn:terminal
Spawn a new terminal window to run CLI commands (ffmpeg, curl, python, etc.). Use for non-AI command execution.
- Author
- Consiliency ↗
- Repository
- treesitter-chunker ↗
- Licence
- MIT
- Last repository change
- 21.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 21.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Spawn a new terminal window to run CLI commands (ffmpeg, curl, python, etc.). Use for non-AI command execution.
Original author description
Spawn a new terminal window to run CLI commands (ffmpeg, curl, python, etc.). Use for non-AI command execution.
How it works
- Variables
- Instructions
- Red Flags - STOP and follow Cookbook
- Workflow
- Cookbook
- Usage
- When to Use spawn:agent Instead
SKILL.md preview
---
name: spawn:terminal
description: "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.
1. Identify the CLI command the user wants to run
2. Run `<command> --help` first to verify syntax and options
3. 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:
1. [ ] Understand the user's request
2. [ ] **VERIFY**: This is a CLI command, NOT an AI agent request
3. [ ] READ: '../agent/fork_terminal.py' to understand the tooling
4. [ ] Follow the Cookbook: Read './cookbook/cli-command.md'
5. [ ] **CHECKPOINT**: Ran `<command> --help` and reviewed options
6. [ ] Execute fork_terminal(command, log_to_file=False, log_agent_output=False)
## Cookbook
### CLI Commands
- IF: User requests any non-AI CLI command (ffmpeg, curl, python, npm, etc.)
- THEN: Read and execute './cookbook/cli-command.md'
- Examples:
- "Create a new terminal to run ffmpeg"
- "Spawn terminal with curl"
- "Fork a terminal to run python script.py"
- "New terminal: npm run build"
## Usage
The `fork_terminal()` function is located at `../agent/fork_terminal.py`:
```python
from spawn.agent.fork_terminal import fork_terminal
# Simple command execution (no output capture)
fork_terminal("npm run build")
# With debug output capture
file_path = fork_terminal("ffmpeg -i video.mp4 output.gif", log_to_file=True)
# Blocking capture (waits for completion)
output = fork_terminal("python script.py", capture=True, log_to_file=True)
```
## When to Use spawn:agent Instead
If the user mentions any of these, use `spawn:agent`:
- Claude, Claude Code
- Codex, OpenAI
- Gemini, Google
- Cursor
- OpenCode
- Copilot, GitHub Copilot
- "AI agent", "coding agent", "spawn agent"
Files in this package (2)
- SKILL.md 3 KB
- cookbook/cli-command.md 1 KB
Versions
The database has no other skills named spawn:terminal.
Database snapshot: 13.11.2026 · package version 4186b85c3c74 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100python-cli-ops
CLI application patterns for Python. Triggers on: cli, command line, typer, click, argparse, terminal, rich, console, terminal ui. - 91add-wshcmd
Guide for adding new wsh commands to Wave Terminal. Use when implementing new CLI commands, adding command-line functionality, or extending the wsh command interface. - 90host-code-execution
Guide safe use of code_execution_remote for shell-backed execution on the connected A0 CLI host. Use when the user asks for their computer, local terminal, CLI host, remote shell, not Docker, or host-side Python/Node/terminal commands. - 100cli
CLI application design: argument conventions, output streams, exit codes, configuration hierarchy, interactive modes, and terminal UX. Invoke whenever task involves any interaction with command-line tools or terminal applications — building, reviewing, debugging, or designing CLI interfaces. - 100windsurf-terminal-ai
Execute leverage AI-assisted terminal commands and debugging. Activate when users mention "terminal help", "command suggestion", "debug terminal", "shell assistance", or "cli help". Handles AI-enhanced terminal operations. Use when working with windsurf terminal ai… - 95tarn-api-testing
Write, run, debug, and iterate on API tests using Tarn — a CLI-first API testing tool with .tarn.yaml files and structured JSON output. Use when: writing API tests, running tarn commands, debugging test failures, generating tests from OpenAPI specs or curl commands, setting up…