jb

Manage long-running background commands with job IDs, logs, and retries.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nijaru/dotfiles --skill jb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jb
Source: https://github.com/nijaru/dotfiles/tree/main/private_dot_codex/skills/jb
Command: npx skills add https://github.com/nijaru/dotfiles --skill jb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a lightweight background job manager to run long-running commands without losing output or requiring an active session.

Core Features & Use Cases

  • Start jobs with IDs and optional names
  • Follow, wait, stop, and retry
  • Persist output and survive disconnects

Quick Start

Start a background task with: jb run "npm test" --name tests; view status with jb status <id>; tail logs with jb logs <id> --follow.

Frequently Asked Questions about jb

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

FAQPage Schema
How do I run long-running commands without losing output when my session disconnects?

Background job managers persist command output and survive session disconnects. jb starts jobs with immediate IDs, stores logs locally, and lets you retrieve output anytime via jb logs <id>, so builds, tests, and deployments continue even if your connection drops.

Can I manage parallel tasks and monitor their status from the command line?

Yes. jb assigns unique IDs to each job, tracks status via jb status <id>, and supports named references for easy tracking. You can start multiple parallel tasks—tests, builds, deployments—and check their progress or tail live logs with jb logs <id> --follow.

What's the best way to handle timeouts and retries for long-running CLI commands?

jb implements timeouts and retry logic natively. Set execution constraints when starting jobs, gracefully stop tasks with jb stop, and retry failed commands without manual reexecution. Idempotent keys prevent duplicate work across retries.

How do I keep background jobs running after I close my terminal?

jb detaches jobs from your session and stores state in ~/.jb. Start a job with jb run, receive an ID immediately, close your terminal, and reconnect later to check status or stream logs. Jobs persist independently of your shell session.

Do I need special setup to start using background job management for DevOps tasks?

No prerequisites or external dependencies required. jb is a lightweight CLI tool that works with any long-running command—migrations, server startup, CI/CD pipelines. Store and manage everything locally under ~/.jb without additional configuration.

Can I follow live output while a background job runs?

Yes. Use jb logs <id> --follow to stream output in real time as your command executes, or retrieve complete logs after the job finishes. Named job references make it easy to tail specific tasks without remembering numeric IDs.