Skip to main content

Named Codex session launcher

Project description

codex-tabs

codex-tabs is a small launcher for named Codex sessions.

It keeps a registry of aliases for codex resume <SESSION_ID> and opens them with:

  • Windows Terminal tabs on Windows/WSL
  • tmux windows on Linux/macOS

Platform support outside Windows/WSL is implemented but not fully tested yet.

Feature suggestions, bug reports, and platform-specific improvements are welcome in GitHub Issues or Discussions.

Install

pipx install codex-tabs

Start

codex-tabs

Example:

Welcome to codex-tabs.
Registry: ~/.config/codex-tabs/sessions.toml
Everything here affects codex-tabs only. Your Codex setup and data stay unchanged.

What would you like to do?
[W] Open all saved tabs
[O] Open a tab
[A] Add a tab
[L] List tabs
[C] Clear the screen
[R] Rename a saved tab alias
[D] Delete a saved tab alias
[I] Ignore other untracked previous sessions
[Q] Quit

Add a tab from an unsaved Codex session.
[1] Use the most recent unsaved session
[2] Show recent unsaved sessions
[3] Search unsaved sessions
[B] Back

[1]
    last updated: 2026-03-03 09:03:01 -03 (2h 14m ago)
    cwd: /home/example/code/project

    first user message: study the project so I can ask you for help afterwards
    last user message: walk me through how to test it, step by step
    last Codex message: 1. Open the app. 2. Go to Settings. 3. ...

Select a session by number, or [M] to show more (blank to cancel):
Name this tab (leave blank to cancel):

Docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codex_tabs-1.0.0.tar.gz (40.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

codex_tabs-1.0.0-py3-none-any.whl (33.5 kB view details)

Uploaded Python 3

File details

Details for the file codex_tabs-1.0.0.tar.gz.

File metadata

  • Download URL: codex_tabs-1.0.0.tar.gz
  • Upload date:
  • Size: 40.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for codex_tabs-1.0.0.tar.gz
Algorithm Hash digest
SHA256 7aab866fb46c4b0138dfd57afaa50d765f6e378ab2ba2e1506593682165251b6
MD5 2e21b991f79cd50aa657c5dce479d093
BLAKE2b-256 da0b044f3fcf74b4966155e67be283b32705fd96214f4b3d5fa587e73491f64e

See more details on using hashes here.

Provenance

The following attestation bundles were made for codex_tabs-1.0.0.tar.gz:

Publisher: publish.yml on d0d1/codex-tabs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file codex_tabs-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: codex_tabs-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 33.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for codex_tabs-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 52d46d156b70cd67f1d86c06e544ab0ea7b8a33af586a3470cb7d94fe94d3d37
MD5 0b93b34801b0f658b39215237caabfb9
BLAKE2b-256 3e9706e2fb41f36d7abb710de9ddd2c39106e2b306e76c8c4ba604edd579165f

See more details on using hashes here.

Provenance

The following attestation bundles were made for codex_tabs-1.0.0-py3-none-any.whl:

Publisher: publish.yml on d0d1/codex-tabs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page