# Background Process Manager

> Use this tool when you need to manage long-running command-line processes, such as running servers or build processes, and require real-time monitoring and control. It solves the problem of limited native background process management in AI agents, providing a server-centric architecture for starting, stopping, and monitoring processes. With inputs via WebSocket server and outputs including output history and real-time monitoring, it is ideal for use cases where visibility into process execution status is crucial.

Canonical page: https://skillsregistry.net/skills/waylaidwanderer-background-process  
JSON: https://api.skillsregistry.net/v1/skills/waylaidwanderer-background-process

## Description

Background Process MCP provides AI assistants with the ability to start, stop, and monitor long-running command-line processes through a server-centric architecture built by Joel (waylaidwanderer). The implementation uses a standalone WebSocket server that manages child processes via node-pty, maintaining complete process state including output history, with both an MCP client for LLM integration and an optional terminal UI for human monitoring. It addresses the limitation that many AI agents like Google's Gemini CLI cannot manage background processes natively, offering tools for process lifecycle management, output retrieval with head/tail options, and real-time monitoring, making it valuable for agents that need to run servers, watchers, build processes, or other long-running tasks while maintaining visibility into their execution status.

## Trust

- **Trust score (0–1):** 0.89
- **Verification tier:** verified
- **Last scanned:** 2026-09-28

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** ai-ml
- **Updated:** 2026-09-28

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/waylaidwanderer-background-process)
- **Repository:** <https://github.com/waylaidwanderer/background-process-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "waylaidwanderer-background-process"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/waylaidwanderer-background-process` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/waylaidwanderer-background-process/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt