codexhop 1.0.0__py3-none-any.whl

codexhop-1.0.0.dist-info/METADATA

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: codexhop
+Version: 1.0.0
+Summary: Use several ChatGPT accounts with OpenAI Codex on one machine: hop the saved login in one command, or run a different account in each terminal. One file, no dependencies.
+Author-email: Ebenworks <contact@ebenworks.co>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/psychofict/codexhop
+Project-URL: Repository, https://github.com/psychofict/codexhop
+Project-URL: Documentation, https://github.com/psychofict/codexhop#readme
+Project-URL: Changelog, https://github.com/psychofict/codexhop/blob/main/CHANGELOG.md
+Project-URL: Security policy, https://github.com/psychofict/codexhop/blob/main/SECURITY.md
+Project-URL: Issues, https://github.com/psychofict/codexhop/issues
+Project-URL: Author, https://ebenworks.co/
+Keywords: codex,openai-codex,codex-cli,chatgpt,account-switcher,multi-account,chatgpt-plus,chatgpt-pro,chatgpt-business,oauth,credentials,cli,developer-tools,productivity,shell,terminal,ai,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration :: Authentication/Directory
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/psychofict/codexhop/main/assets/cover.png" alt="codexhop: hop OpenAI Codex between ChatGPT accounts" width="820">
+</p>
+
+<p align="center">
+  <a href="https://github.com/psychofict/codexhop/actions/workflows/ci.yml"><img src="https://github.com/psychofict/codexhop/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/psychofict/codexhop/blob/main/LICENSE"><img src="https://img.shields.io/badge/licence-MIT-FC5F00" alt="MIT licence"></a>
+  <img src="https://img.shields.io/badge/python-3.9%2B-FC5F00" alt="Python 3.9 or newer">
+  <img src="https://img.shields.io/badge/dependencies-none-FC5F00" alt="No dependencies">
+</p>
+
+codexhop lets you use several ChatGPT accounts with OpenAI Codex on one machine,
+such as a personal plan and a seat in your company's workspace. It saves each
+account's Codex login, swaps the live one in one command, and can run a
+different account in each terminal.
+
+The whole tool is one Python file with no dependencies. A browser opens only
+when you add an account.
+
+```
+$ chop
+      NAME  EMAIL           PLAN      5H USED
+1.    home  me@gmail.com    plus      4%
+2. *  work  me@company.com  business  62%
+
+hop to which? [1-2, Enter to stay] 1
+switched to home (me@gmail.com, plus)
+new `codex` sessions start as this account.
+```
+
+`chop` is the short name the shell glue gives `codexhop`. The 5H USED column is
+the last reading `chop usage` saved, so the menu comes up at once.
+
+## Install
+
+```bash
+pipx install codexhop              # or: pip install --user codexhop
+eval "$(codexhop shell-init)"      # the `chop` alias and tab completion
+```
+
+Put the `eval` line in your `~/.bashrc` or `~/.zshrc` and open a new terminal.
+It needs Python 3.9 or newer and Codex, on Linux or macOS. For the newest code
+from GitHub instead, use `pipx install git+https://github.com/psychofict/codexhop`.
+
+To install from a clone instead, run `./install.sh`. It links
+`~/.local/bin/codexhop` to the clone and adds the same line to your shell rc. If
+`chop` is taken on your machine, `codexhop shell-init --alias NAME` picks
+another name.
+
+Then save the login you already have, and add the others:
+
+```bash
+chop save home       # names whatever is logged in right now
+chop add work        # signs in as a second account, aside from the live one
+```
+
+`chop add` runs `codex login` in a private temporary Codex home, so your live
+login is untouched while you sign in. If your browser is signed in to ChatGPT as
+another account, that is the one you get. Open the link in a private window, or
+use `chop add work --device-auth`.
+
+## Commands
+
+```bash
+chop work               # new codex sessions start as work
+chop run home           # codex as home in this terminal only; arguments after the name go to codex
+chop usage              # 5-hour and weekly usage for every account
+chop next home work     # hop to whichever of the others has room in its 5-hour window
+```
+
+| Command | What it does |
+|---|---|
+| `chop` | list the accounts and ask which one to hop to |
+| `chop <name>` | hop to that account |
+| `chop add <name>` | sign in as another account and save it |
+| `chop save [name]` | save the login you have now |
+| `chop run <name> [...]` | run `codex` as that account in this terminal only |
+| `chop usage [name]` | 5-hour and weekly usage, with reset times |
+| `chop next [names]` | hop to another login in the list that has 5-hour room ([how it picks](https://github.com/psychofict/codexhop/blob/main/docs/commands.md#chop-next-names)) |
+| `chop whoami` | who the live login is, read from the login itself |
+| `chop list --long` | token expiry, last renewal and save date per account |
+| `chop renew [name]` | renew the saved logins that are due |
+| `chop doctor [--fix]` | check the setup and repair what it can |
+| `chop rm`, `chop rename` | delete or rename a saved account |
+
+The [command reference](https://github.com/psychofict/codexhop/blob/main/docs/commands.md)
+covers every command, flag, setting, file and exit status.
+
+### One account per terminal
+
+`chop run work` starts `codex` as `work` in this terminal, while every other
+terminal keeps the live login.
+
+The session gets its own Codex home. That home holds the account's login and
+links to everything else in yours, so the session has your config, rules,
+skills and history, and `codex resume` sees the same conversations. When the
+session ends, a login it renewed is saved back.
+
+### Usage for every account
+
+```
+$ chop usage
+   NAME  5 HOURS            WEEK                NOTE
+*  home  4%  resets 3h19m   18%  resets 23h59m
+   work  62%  resets 2h09m  41%  resets 23h59m
+```
+
+The figures come from the endpoint Codex reads an account's rate limits from. A
+reading under
+a minute old is shown again without asking, and a server that asks for a pause
+is not asked again until the pause is over.
+
+An idle account whose access token has run out is renewed first, so every
+account can be read, not only the live one.
+
+## What happens to sessions that are already open
+
+A hop changes the login new `codex` sessions start with. A session that is
+already open keeps the login it started with until that login's access token is
+within 5 minutes of running out, about 10 days after its last renewal. Then it
+stops with "signed in to another account. Please sign in again."
+
+The exception is two logins in one workspace: there the open session moves to
+the new login at that point.
+
+This was measured with Codex 0.160.1 and 0.166.0, and
+[How it works](https://github.com/psychofict/codexhop/blob/main/docs/how-it-works.md#what-open-sessions-do)
+has the cases and the script. The hop tells you how long the open sessions have.
+Start a new session to move over; `codex resume` reopens the conversation in it.
+
+When a session is about to renew the live login, the hop stops and says so. A
+hop that lands during that renewal can cost the account its login, because
+Codex 0.166.0 drops the renewed tokens and 0.160.1 saves them under the new
+account's workspace id. Let the session make its next request first, or pass
+`--yes`.
+
+## How it works
+
+Codex keeps its login in `~/.codex/auth.json`. codexhop keeps one copy of that
+file per account in `~/.codex/codexhop/accounts/`, mode 600, and copies the one
+you want into place.
+
+Which account a login belongs to is read from the login's own ID token (email,
+ChatGPT user and workspace), so listing, hopping and `whoami` need no network.
+During the swap codexhop holds `auth.lock`, the lock Codex 0.166.0 takes around
+its own writes. The outgoing login is filed under the right account first, so a
+renewal Codex has already saved is never overwritten.
+
+[How it works](https://github.com/psychofict/codexhop/blob/main/docs/how-it-works.md)
+goes through it step by step.
+
+## Before you hop
+
+- Codex can keep its login in the system keyring instead of `auth.json`. The
+  file is the default; if yours is set to `keyring` or `auto`, codexhop says how
+  to switch back.
+- Codex before 0.164.0 does not check, when it saves a renewal, that
+  `auth.json` still holds the same login (the check first appears in Codex's
+  source at rust-v0.164.0). `chop doctor` warns about it, and
+  `chop doctor --fix` repairs a file that got mixed up. Upgrading Codex closes
+  the gap.
+- `CODEX_ACCESS_TOKEN`, and `CODEX_API_KEY` in `codex exec`, take the place of
+  the saved login. `chop whoami` and `chop doctor` warn when either is set.
+- codexhop changes nothing about what each account may do. Use each one within
+  OpenAI's terms of use.
+
+## FAQ
+
+**Does codexhop send my login anywhere?** Only to OpenAI, and only to renew it
+(`auth.openai.com`) or to read usage (`chatgpt.com`), when a command needs to.
+`CODEXHOP_OFFLINE=1` turns both off.
+[SECURITY.md](https://github.com/psychofict/codexhop/blob/main/SECURITY.md)
+lists what the tool holds and how it protects it.
+
+**Can I hop between a ChatGPT login and an API key?** Yes. `chop add work
+--with-api-key` reads the key from standard input, and the result hops like any
+other account.
+
+**Does it switch accounts by itself when one runs out?** No. `chop next` hops
+to another login with room in its 5-hour window, but only when you run it.
+
+**Two accounts with the same email?** One email in two ChatGPT workspaces is two
+logins, and codexhop keeps them apart. `chop list` adds a WORKSPACE column when
+that happens.
+
+**Windows?** Windows is not supported. codexhop runs on Linux and macOS.
+
+## Contributing and licence
+
+Issues and pull requests are welcome. Start with
+[CONTRIBUTING.md](https://github.com/psychofict/codexhop/blob/main/CONTRIBUTING.md),
+and report anything that could expose a login through
+[SECURITY.md](https://github.com/psychofict/codexhop/blob/main/SECURITY.md).
+
+codexhop is built by [Ebenworks](https://ebenworks.co/), which also makes
+[claudehop](https://github.com/psychofict/claudehop) for Claude Code.
+
+MIT licence. Not affiliated with, endorsed by, or sponsored by OpenAI. "OpenAI",
+"Codex" and "ChatGPT" are trademarks of OpenAI, used here only to say what this
+works with.

codexhop-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+codexhop.py,sha256=VDAqSAMuVpx7kYKLaodaRmN2rIKPNmIHHoR290j-Nas,97138
+codexhop-1.0.0.dist-info/licenses/LICENSE,sha256=fW4--GIfdgllYdgzngz7rN8E9BM27OVinheASvq8ccY,1066
+codexhop-1.0.0.dist-info/METADATA,sha256=yhoHIQsnWsxvnpSEzB_AI2e4mwoJEsxCe4cdPf9C_RM,10860
+codexhop-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+codexhop-1.0.0.dist-info/entry_points.txt,sha256=9zoT9qChv0fWD5-eYp0ZHRJ0aWMyi-8j1DFUgKMX6go,51
+codexhop-1.0.0.dist-info/top_level.txt,sha256=ZMiM8ItIHehi2y5a64K_7oWzQw2IFjxY7K6L-Vp4LaY,9
+codexhop-1.0.0.dist-info/RECORD,,

codexhop-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codexhop-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codexhop = codexhop:console_main

codexhop-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ebenworks
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codexhop-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+codexhop