What is a Claude Code worker session?

A worker session is a secondary Claude Code instance launched in a detached tmux terminal to perform specific tasks independently of the main controller session.

Can a human take over a worker session?

Absolutely. Since workers run in standard tmux sessions, a human operator can attach to the session at any time to observe or take direct control.

Is it safe to skip permissions for workers?

While workers use the skip-permissions flag for automation, safety is maintained through the skill's integrated tool-gating scripts and the controller's ability to monitor all activity.

How does the controller monitor worker progress?

The controller polls a specialized JSONL event file that records lifecycle events such as tool usage, prompt submissions, and session status.

Can I approve tool calls made by background workers?

Yes, the skill includes a tool approval hook that allows the controller to inspect, allow, or deny specific tool calls before they are executed by the worker.

Claude Code Session Driver

Name: Claude Code Session Driver
Author: obra

byobra

•

Productivity & Workflow

Orchestrates multiple Claude Code background sessions to delegate tasks, run parallel workflows, and monitor worker progress.

This skill transforms Claude into a high-level project manager capable of spawning and controlling secondary 'worker' sessions within tmux. It provides a robust framework for delegating complex sub-tasks, executing parallel operations, and building multi-step pipelines where sessions can pass data through shared files. With built-in support for lifecycle event tracking, manual tool-call approvals, and seamless human hand-off, it allows for scalable and supervised AI-driven engineering workflows without blocking the main interaction loop.

Key Features

01Real-time lifecycle event monitoring and state polling

02Supervised tool-use gating for background worker safety

03Seamless session hand-off between AI and human operators

04Parallel task execution for high-throughput development

05Multi-worker orchestration via detached tmux sessions

0650 GitHub stars

Use Cases

01Delegating refactoring or test generation to background workers while maintaining focus on the main architecture.

02Creating multi-stage pipelines where one session generates a technical specification and another implements the code.

03Running parallel codebase audits by assigning different modules to multiple concurrent Claude sessions.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add obra/claude-session-driver driving-claude-code-sessions

For use in Claude.ai and ChatGPT

Download Skill