tap

Community

Supervise long-running commands with queryable logs.

Authorbbatchelder
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Tap solves the challenge of reliably starting, monitoring, and controlling long-running processes by wrapping them with a dedicated runner that captures output in memory and exposes a minimal API to query logs and manage restarts.

Core Features & Use Cases

  • In-memory ring buffer: stores recent stdout/stderr lines for fast, deterministic access without log files.
  • Unix-domain socket API: remote control of each service via a lightweight HTTP interface.
  • Per-service runner: isolates supervision and lifecycle to a single process, enabling predictable restarts and readiness checks.
  • Use cases: run a web server or worker, observe logs, restart on failure, or stop services in CI pipelines.

Quick Start

Use tap to run a service, observe logs, and restart when needed. Example: tap run myapp -- node server.js; then tap observe myapp --last 50; if needed, tap restart myapp.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: tap
Download link: https://github.com/bbatchelder/tap/archive/main.zip#tap

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.