yizhiyanhua-ai

Fireworks Terminal Sessions — Development skill for Claude Code

Development community

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 icon: a luminous terminal and recovery loop

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.

![Architecture diagram: live tmux panes, exact identity capture, private journal, and guarded native resume](docs/diagrams/architecture.png)

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-