background-process-get-process-output

To read logs from a managed background process, fetch recent output (head or tail) for a process so you can inspect its stdout/stderr.

⭐6stars🔀3forks📁View on GitHub🕐Updated Jan 7, 2026

When & Why to Use This Skill

This Claude skill enables seamless log inspection for managed background processes by fetching real-time stdout and stderr output. It allows developers and system administrators to retrieve specific segments of process logs, such as the beginning (head) or the end (tail), facilitating efficient remote debugging and process health monitoring directly within the AI interface.

Use Cases

  • Troubleshooting failed background tasks: Quickly retrieve the last few lines of error logs (tail) to identify why a process crashed or hung.
  • Verifying service initialization: Inspect the initial output (head) of a newly started background process to ensure all configurations and dependencies loaded correctly.
  • Real-time status tracking: Monitor the progress of long-running data processing jobs or migrations by periodically checking the latest log entries.
  • Audit and Compliance: Capture specific log snapshots from background services for documentation or security review purposes.
namebackground-process-get-process-output
description"To read logs from a managed background process, fetch recent output (head or tail) for a process so you can inspect its stdout/stderr."

Usage

Use the MCP tool dev-swarm.request to send the payload as a JSON string:

{"server_id":"backgroundProcess","tool_name":"get_process_output","arguments":{}}

Tool Description

Gets the recent output for a background process. Can specify head or tail.

Arguments Schema

The schema below describes the arguments object in the request payload.

{
  "type": "object",
  "properties": {
    "processId": {
      "type": "string",
      "format": "uuid"
    },
    "head": {
      "type": "number"
    },
    "tail": {
      "type": "number"
    }
  },
  "required": [
    "processId"
  ],
  "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>"}}