skills.rest
bfly123
bfly123COMMUNITY
Explore all skills by this author →
GitHub

reconnect

Toggles tmux-bound disconnect recovery for a Codex CLI thread.

3.5k|342|Updated Oct 25, 2025
Search Tags:#CLI#CODEX#session persistence#reconnect#Tmux#disconnect recovery
One-click install
npx skills add https://github.com/bfly123/claude_code_bridge --skill reconnect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reconnect
Source: https://github.com/bfly123/claude_code_bridge/tree/main/tools/codex-reconnect/skills/reconnect
Command: npx skills add https://github.com/bfly123/claude_code_bridge --skill reconnect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long-running Codex CLI sessions inside tmux can be interrupted by terminal or network disconnects, and users need a simple way to turn disconnect recovery monitoring on or off for the current thread without leaving the conversation.

Core Features & Use Cases

  • Enable Recovery: Run $reconnect on to execute codex-reconnect on and start monitoring the current tmux Codex thread for disconnects.
  • Disable Recovery: Run $reconnect off to execute codex-reconnect off and stop recovery monitoring.
  • Strict Scope: Only responds to the two explicit invocations, relays the command result honestly, and never claims coverage for quota, authentication, or task-completion failures.
  • Use Case: You are running a long Codex coding session in tmux over SSH and want the session to survive a dropped connection, so you type $reconnect on before stepping away.

Quick Start

Type $reconnect on in your tmux-based Codex CLI session to enable disconnect recovery for the current thread.

Frequently Asked Questions about reconnect

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

FAQPage Schema
How do I enable disconnect recovery for a Codex CLI session in tmux?▼

Type $reconnect on inside the Codex CLI running in tmux. The skill runs codex-reconnect on and reports the result, enabling recovery monitoring for the current thread.

How do I turn off Codex reconnect monitoring?▼

Type $reconnect off in the same tmux Codex session. The skill executes codex-reconnect off and relays the command output confirming recovery is disabled.

Does reconnect work outside of tmux or with other CLI agents?▼

No, it is scoped to a Codex CLI thread running inside tmux and only responds to the explicit $reconnect on and $reconnect off invocations. It does not apply to other agents or environments.

What failures does Codex reconnect recovery not cover?▼

It does not cover quota, billing, authentication, policy, context-window, approval, or ordinary task-completion failures. It only addresses tmux-bound disconnect recovery for the session.

What happens if the codex-reconnect command fails?▼

The skill reports the error and does not claim that recovery is enabled. It never fabricates a success state when the underlying command fails.

Related Skills

Explore More Software Engineering Skills→
ClementATHClementATH

omc-teams

Spawn multiple CLI workers in tmux panes to execute tasks in parallel.

Community
Advanced
chdalychdaly

session-recovery

Query the session_store SQLite database to find and resume interrupted Copilot CLI sessions.

Community
Intermediate
eugene-belkovicheugene-belkovich

terminal-persistence

Configure macOS power settings, tmux sessions, and SSH keep-alive for terminal persistence.

Community
Advanced
L3DigitalNetL3DigitalNet
6

tmux

Manage terminal sessions, windows, and panes with tmux.

Official
Intermediate