background-process-run-command-sync
To run a short command and wait for the result, execute a synchronous shell command via the manager and return full output.
When & Why to Use This Skill
The background-process-run-command-sync skill empowers Claude agents to execute synchronous shell commands and capture real-time output directly within the workspace. It streamlines developer workflows by bridging the gap between AI reasoning and terminal execution, allowing for immediate verification of command results and seamless CLI automation.
Use Cases
- Environment Inspection: Quickly check system versions (e.g., node -v, python --version) or environment variables to ensure the workspace is correctly configured.
- Build and Test Automation: Run short-lived build scripts, compilers, or unit tests (like npm test or go test) and receive instant feedback to debug code changes.
- File System Operations: Perform rapid directory listings, file searches, or content inspections using standard Unix/Linux commands like ls, grep, or cat.
- Git Repository Management: Execute version control commands such as git status or git log to understand the current state of a project without leaving the agent interface.
| name | background-process-run-command-sync |
|---|---|
| description | "To run a short command and wait for the result, execute a synchronous shell command via the manager and return full output." |
Usage
Use the MCP tool dev-swarm.request to send the payload as a JSON string:
{"server_id":"backgroundProcess","tool_name":"run_command_sync","arguments":{}}
Tool Description
Runs a short-lived shell command synchronously and returns full output.
Arguments Schema
The schema below describes the arguments object in the request payload.
{
"type": "object",
"properties": {
"command": {
"type": "string"
}
},
"required": [
"command"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
Background Tasks
If the tool returns a task id, poll the task status via the MCP request tool:
{"server_id":"backgroundProcess","method":"tasks/status","params":{"task_id":"<task_id>"}}