Skip to content
Skills Library
Programming · Automation

spawn:terminal

/spawn:terminal

Spawn a new terminal window to run CLI commands (ffmpeg, curl, python, etc.). Use for non-AI command execution.

Licence
MIT
Last repository change
21.10.2026

Assessment and security

90/ 100Class: good
Format15 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.10.2026, without references to retired models or APIs.

Licence

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

  1. Variables
  2. Instructions
  3. Red Flags - STOP and follow Cookbook
  4. Workflow
  5. Cookbook
  6. Usage
  7. When to Use spawn:agent Instead
Original SKILL.md headings · 80 lines, 374 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.