Fireworks Terminal Sessions — Development skill for Claude Code
Exact tmux session recovery for Codex, Claude Code, and Kimi Code.
How to install Fireworks Terminal Sessions
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open yizhiyanhua-ai/fireworks-terminal-sessions and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Fireworks Terminal Sessions does
Exact tmux session recovery for Codex, Claude Code, and Kimi Code.
Alternatives in Development
- Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
- Tmux Claude Session Manager — Run many Claude Code sessions across your projects, each in its own tmux session — then list them, see which a 380 ★
- Mulmoterminal — Run multiple Claude Code and Codex sessions in parallel — a browser terminal grid that shows which agent needs 187 ★
README
Fireworks Terminal Sessions
Put each Codex, Claude Code, Kimi Code, or Pi conversation back in its named tmux window.
简体中文 · How it works · Architecture SVG · Recovery flow SVG
If you work through **Codex, Claude Code, Kimi Code, or Pi**, ask your agent:
Install `https://github.com/yizhiyanhua-ai/fireworks-terminal-sessions` as a skill and install its local CLI. Run `terminal-sessions doctor`, detect my tmux server name, capture the current Codex/Claude/Kimi/Pi windows, and show me the recovery plan. Do not start a new conversation or replace a running window.
For a later recovery:
My terminal windows disappeared. Use the `fireworks-terminal-sessions` skill to show the exact saved window-to-conversation mapping, restore only missing sessions, and tell me which ones were already running or blocked. Match each tmux name to its task. On Wave Terminal, run `reopen` to recreate every window in one step.
The agent should read [SKILL.md](SKILL.md) and show the plan before running `restore`. The same commands work by hand.

Quick start
Requires macOS or Linux, Python 3.10+, `tmux`, `ps`, `pgrep`, and `lsof`. Install Codex, Claude Code, Kimi Code, or Pi separately for the sessions you want to recover. Automatic periodic capture currently uses macOS launchd; Linux users can run `capture` from their own scheduler.
git clone https://github.com/yizhiyanhua-ai/fireworks-terminal-sessions.git
cd fireworks-terminal-sessions
./install.sh
~/.local/bin/terminal-
Related Skills
Detach
Run Codex and Claude Code reliably in the background on macOS—with a native dashboard, persistent tmux session
Mjolnir
Manage Codex, Claude Code, Muse Code, Kimi Code, Grok Build, and DeepSeek Harness with durable sessions, isola
Tmux Spawn Skill For Claude Code
Claude Code skill for spawning observable tmux sessions. Launch background Claude agents in visible terminal p
Recallnest
One memory, every terminal. Shared memory layer for any MCP client — Claude Code, Codex, Kimi, Antigravity (ag
Ely Tea Party
A terminal where your coding agents come to tea: each session's agent is an animated chibi girl showing what i
Corral
Corral: terminal session handoff for Claude Code, Codex, OpenCode, Kimi, Cursor, and Pi.
Related Agents
Agent Of Empires
Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI Coding Agent Terminal Session manager via tmux and
Codex Orchestrator
CLI tool for delegating tasks to GPT Codex agents via tmux sessions. Designed for Claude Code orchestration wi
Session Error Analyzer
Analyzes specific AI IDE sessions (Claude Code, OpenAI Codex, OpenCode) for LLM behavior errors and returns a