gob

Orchestrate and monitor long-running background processes via a unified CLI.

1|1|Updated Dec 3, 2020
One-click install
npx skills add https://github.com/kaofelix/dotfiles --skill gob
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gob
Source: https://github.com/kaofelix/dotfiles/tree/main/pi/.pi/agent/skills/gob
Command: npx skills add https://github.com/kaofelix/dotfiles --skill gob

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

gob provides a unified CLI to start, monitor, and stream logs from long-running background processes, so development tasks don't block you.

Core Features & Use Cases

  • Start background jobs with gob add <cmd> - returns job ID immediately and runs in the background.
  • Run commands and wait for completion with gob run <cmd> - executes and streams output until completion.
  • Monitor and manage jobs with gob list, gob stdout <job_id>, gob stop <job_id>, gob restart <job_id>, and gob remove <job_id>.

Quick Start

Use gob to start a background server: gob add npm run dev Then monitor its output: gob stdout <job_id>

Frequently Asked Questions about gob

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

FAQPage Schema
How do I manage long-running background processes during development?

You can manage long-running background processes by using a unified CLI to start, monitor, and stream logs from jobs. This allows development tasks like background servers and file watchers to run concurrently without blocking your active workflow.

How do I start a background server and stream its logs via CLI?

To start a background server, use the add command with your desired script to immediately get a job ID running in the background. You can then stream its logs by passing the job ID to the stdout command to monitor real-time output.

What is the best way to run concurrent background jobs in a development environment?

The best way to run concurrent jobs is using a CLI that applies per-directory scoping to isolate tasks. It provides deterministic command semantics to add, run, and await multiple background processes concurrently within your specific project directories.

Can I stop or restart a background job without losing my development workflow state?

Yes, you can stop or restart a background job without losing state because the CLI manages the complete job lifecycle. It supports stopping, restarting, and removing jobs by their specific job IDs while maintaining your per-directory scoping.

Does background job management work with file watchers and concurrent agent activity?

Background job management works with file watchers and concurrent agent activity by applying deterministic command semantics to development workflows. It orchestrates long-running processes, streaming logs and managing lifecycles so tasks run concurrently without blocking agents.

How do I wait for a background command to finish and stream its output?

To wait for a command to finish, use the run command to execute it and stream output directly until completion. This ensures you capture the full process logs synchronously while the task completes its execution lifecycle.