skills.rest
julianjab
julianjabCOMMUNITY
Explore all skills by this author →
GitHub

session

Create and manage Claude Code sub-sessions with git worktrees and tmux.

Updated Apr 1, 2026
Search Tags:#orchestration#worktree#tmux#session-management#claude-code#slack-bridge
One-click install
npx skills add https://github.com/julianjab/ia-tools --skill session-julianjab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session
Source: https://github.com/julianjab/ia-tools/tree/main/skills/session
Command: npx skills add https://github.com/julianjab/ia-tools --skill session-julianjab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, git, claude, python3, and includes scripts (resource) components.

What problem does it solve?

Open a dedicated sub-session for a single task by creating a git worktree, seeding a task plan, and booting a Claude Code instance inside a managed tmux window. It unifies Slack-mode and local-mode workflows to streamline task execution and collaboration.

Core Features & Use Cases

  • Open or reuse a sub-session with a single command, including worktree creation, tmux window management, and a boot prompt tailored to Slack or local mode.
  • Seed the Phase 1 plan in .sdlc/tasks.md and optionally seed within resume-from mode, enabling quick onboarding for new tasks or PRs.
  • Launch Claude with environment hints and an orchestrator role, enabling automated planning, approvals, and progress updates in Slack or in the local session.

Quick Start

Install prerequisites (tmux, git, claude); then run a slash command or script to initiate a session, e.g., /session feat/your-work.

Frequently Asked Questions about session

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

FAQPage Schema
Can I use a Slack bridge to receive automated progress updates from a Claude Code session?▼

Yes, this Skill launches Claude with an orchestrator role and environment hints, enabling automated planning, approvals, and progress updates directly in Slack. It uses mode-aware prompts to tailor the session for Slack collaboration.

Do I need tmux and git installed to run Claude Code sub-sessions?▼

The best way is to run a single slash command or script, which creates a git worktree, validates git refs, seeds the Phase 1 plan in .sdlc/tasks.md, and launches Claude Code inside a managed tmux window with a tailored boot prompt.

How do I resume a Claude Code session from an existing git worktree?▼

Yes, you need tmux, git, claude, and python3 installed as dependencies. The Skill checks for these prerequisites and enforces validation of git refs before creating a worktree and launching the managed sub-session.

Why does my Claude Code sub-session fail to launch in tmux?▼

You can resume a Claude Code session using the resume-from mode, which optionally seeds the task plan in .sdlc/tasks.md within the existing git worktree and relaunches Claude with mode-aware prompts for quick onboarding.

Why does my Claude Code sub-session fail to launch in tmux?▼

Sub-session launch failures often occur when dependencies like tmux, git, claude, or python3 are missing, or when git ref validation fails. The Skill checks for these prerequisites and validates refs before attempting worktree creation.

Related Skills

Explore More Software Engineering Skills→
samueriosamuerio

agent-workspace

Create isolated branch-scoped workspaces using git worktree and tmux.

Community
Advanced
windschordwindschord
7

jules-cli

Extract TODO items from docs/tasks.md and delegate them to Jules via Japanese requests.

Community
Advanced
tcdenttcdent

agent-message

Coordinate task delegation and command execution among Claude Code instances in tmux sessions.

Community
Advanced
leejaedusleejaedus

project-session-manager

Provisions per-task git worktrees and tmux sessions for development environments.

Community
Advanced