terminal-ops

Execute workspace-scoped Bash or PowerShell commands for file inspection and text search.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/pycode4micro/bushserver --skill terminal-ops-pycode4micro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-ops
Source: https://github.com/pycode4micro/bushserver/tree/main/src/bushserver/seeds/skills/package/terminal-ops
Command: npx skills add https://github.com/pycode4micro/bushserver --skill terminal-ops-pycode4micro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Terminal-ops helps you inspect and manipulate a local project by running ordinary, workspace-scoped shell operations when no domain-specific skill fits.

Core Features & Use Cases

  • Guided Shell Operations: Choose Bash or PowerShell explicitly and run narrow commands for the next local step.
  • Read-First Workflow: Use read-only inspection and search references before making filesystem changes.
  • Workspace-Safe Mutations: Create, move, copy, and delete with guardrails around target paths to avoid unsafe deletion patterns.
  • Background Service Management: Start long-running commands, then check status/logs and stop them using the companion tools.
  • Progressive Tool Disclosure Support: Use the appropriate category reference map for the next action (read-only, search, filesystem, dev workflows, background services).

Quick Start

Ask the skill to list the project’s top-level structure and then search for the string "BUSH_DATA_DIR" within the repository using the appropriate shell and safe search rules.

Frequently Asked Questions about terminal-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely run local shell commands to inspect and modify project files?

To safely run local shell commands, you can use a workspace-scoped terminal operation skill that executes explicit Bash or PowerShell syntax. It targets filesystem mutations with guardrails to prevent unsafe deletions while inspecting or changing project files.

What is the best way to search for specific text strings within a local repository?

The best way to search for specific text strings within a local repository is using a read-first workflow with guided shell operations. This approach applies safe search rules via explicit Bash or PowerShell commands before making any filesystem changes.

Can I manage background services and long-running commands using terminal operations?

Yes, you can manage background services using terminal operations that start long-running commands. The skill supports checking status and logs, and stopping these background commands through companion tools for controlled lifecycle management.

Does this terminal operations approach support both Bash and PowerShell environments?

Yes, this terminal operations approach supports both Bash and PowerShell environments. You must explicitly choose your shell and provide narrow, single-command syntax per step to ensure workspace-safe execution for your local development workflow.

What are the limitations of using workspace-scoped shell commands for development workflows?

Limitations of workspace-scoped shell commands include the exclusion of domain expertise tasks, browser browsing, binary parsing, validation, and desktop GUI control. Mutations are strictly workspace-scoped, and you must provide exact syntax without subagent delegation.