Skip to main content

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

Metadata

Release files for codex-tabs 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codex-tabs 1.0.0
File Size Uploaded
codex_tabs-1.0.0.tar.gz 40.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for codex-tabs 1.0.0
File Interpreter ABI Platform
codex_tabs-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 74.3 kB

Release files / codex_tabs-1.0.0.tar.gz

Download URL codex_tabs-1.0.0.tar.gz
Size 40.8 kB
Tags Source
SHA-256 checksum
How to use checksums
7aab866fb46c4b0138dfd57afaa50d765f6e378ab2ba2e1506593682165251b6
BLAKE2b-256 checksum
How to use checksums
da0b044f3fcf74b4966155e67be283b32705fd96214f4b3d5fa587e73491f64e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 19, 2026.

Transparency log

Release files / codex_tabs-1.0.0-py3-none-any.whl

Download URL codex_tabs-1.0.0-py3-none-any.whl
Size 33.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
52d46d156b70cd67f1d86c06e544ab0ea7b8a33af586a3470cb7d94fe94d3d37
BLAKE2b-256 checksum
How to use checksums
3e9706e2fb41f36d7abb710de9ddd2c39106e2b306e76c8c4ba604edd579165f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 19, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page