tmux-claude-sdk

Manage Claude Code sessions in tmux with session and process ID detection.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/tankygranny05/agent-box --skill tmux-claude-sdk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-claude-sdk
Source: https://github.com/tankygranny05/agent-box/tree/main/agent-box/seed/codex-skills/tmux-claude-sdk
Command: npx skills add https://github.com/tankygranny05/agent-box --skill tmux-claude-sdk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the control of Claude Code sessions within a tmux environment, ensuring deterministic session management and reliable interaction with Claude's features.

Core Features & Use Cases

  • Session Management: Spawn, detect, and rename tmux sessions for Claude Code, including session and process IDs.
  • Interactive Control: Send prompts, clear input, abort generation, access rewind menus, and exit Claude using precise keybindings.
  • Observability: Preserve logging through --log-dir sse_lines.jsonl for detailed session monitoring.
  • Use Case: When you need to programmatically interact with Claude Code for tasks like automated code generation or analysis, this skill provides the robust control and logging necessary for reliable execution.

Quick Start

Use the tmux-claude-sdk skill to spawn a new Claude Code session in the current directory and send the prompt "Hello, Claude!".

Frequently Asked Questions about tmux-claude-sdk

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

FAQPage Schema
How do I programmatically control Claude Code sessions in tmux?

This skill manages Claude Code sessions in tmux by spawning sessions, detecting process IDs, and sending prompts through precise keybindings. It enables deterministic session control for automated code generation tasks.

How does tmux session management work for automated Claude Code interaction?

Tmux session management for Claude Code works by spawning sessions, detecting session and process IDs, and renaming them as needed. This allows you to programmatically send prompts and maintain reliable interaction state.

Can I send prompts and abort generation to Claude Code via tmux keybindings?

Yes, you can send prompts, clear input, abort generation, access rewind menus, and exit Claude using precise tmux keybindings. This interactive control ensures reliable execution during automated code generation workflows.

How do I preserve logging and observability for Claude Code tmux sessions?

You preserve logging for Claude Code tmux sessions by utilizing the --log-dir sse_lines.jsonl parameter. This maintains detailed session monitoring and observability for deterministic session control and interaction tracking.

Do I need any external dependencies to manage Claude Code sessions with tmux?

No external dependencies are required to manage Claude Code sessions with tmux using this skill. It operates autonomously to provide session spawning, prompt submission, and control key emulation without additional packages.

Why use tmux for Claude Code session management instead of direct execution?

Using tmux for Claude Code session management ensures deterministic control and reliable interaction by preserving observability through logging. It allows you to programmatically interact with Claude for automated code generation while maintaining session state.