codex-partner 0.0.1__tar.gz

codex_partner-0.0.1/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: codex-partner
+Version: 0.0.1
+Summary: A self-hosted web interface for managing persistent Codex tasks.
+Project-URL: Homepage, https://github.com/froststeam/Codex-Partner
+Project-URL: Repository, https://github.com/froststeam/Codex-Partner.git
+Project-URL: Issues, https://github.com/froststeam/Codex-Partner/issues
+Keywords: codex,agent,task-management,self-hosted
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.27
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: pexpect>=4.8; platform_system != "Windows"
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: Pillow>=10.0
+
+# Codex Partner
+
+Codex Partner is a self-hosted control panel for long-running Codex work. It keeps one native Codex thread alive and lets terminals, browsers, and multiple devices interact with the same task.
+
+![Codex Partner task workspace](https://raw.githubusercontent.com/froststeam/Codex-Partner/main/docs/codex-partner.png)
+
+## Why
+
+- **Long tasks stop too early.** Persistent Goals can resume after a failed turn, disconnect, or service restart until the objective is complete.
+- **Multiple clients split the session.** Every connected browser is a view of the same server-owned Codex thread, not a competing `resume` process.
+- **Messages collide with active work.** New messages wait in a durable queue and enter the conversation only when their turn actually starts.
+
+## Highlights
+
+- Live task state, tool activity, context usage, and paginated history
+- Goal Resume with pause, retry, and restart recovery
+- Ordered message queue with manual dispatch
+- Workspace browser, editor, uploads, downloads, and image previews
+- Browser terminal that preserves its session when hidden
+- Model and API provider management with health checks and failover
+- Codex memories, Skills, archive, recycle bin, and SSH workspace support
+- Default YOLO mode for newly created sessions
+
+## Install
+
+Requires Python 3.10+ and an authenticated [Codex CLI](https://github.com/openai/codex).
+
+```bash
+git clone git@github.com:froststeam/Codex-Partner.git
+cd Codex-Partner
+python3 -m venv .venv
+. .venv/bin/activate
+pip install .
+cp .env.example .env
+codex-partner
+```
+
+Open <http://127.0.0.1:8787>.
+
+For access from other devices, set `CODEX_DASHBOARD_HOST=0.0.0.0` and a strong `CODEX_DASHBOARD_TOKEN` in `.env`.
+
+## Docker
+
+```bash
+docker build -t codex-partner:0.0.1 .
+docker run -d --name codex-partner \
+  -p 8787:8787 \
+  -e CODEX_DASHBOARD_TOKEN=replace-with-a-strong-random-token \
+  -v codex-partner-data:/var/lib/codex-partner \
+  -v codex-home:/home/codex/.codex \
+  -v codex-workspace:/workspace \
+  codex-partner:0.0.1
+docker exec -it codex-partner codex login
+```
+
+## systemd
+
+After completing the installation above, stop the foreground process and install the user service:
+
+```bash
+mkdir -p ~/.config/systemd/user
+cp codex-partner.user.service.example ~/.config/systemd/user/codex-partner.service
+systemctl --user daemon-reload
+systemctl --user enable --now codex-partner.service
+systemctl --user status codex-partner.service
+```
+
+This service uses the current user's existing Codex login, configuration, memories, and Skills. The example assumes the repository is at `~/Codex-Partner`; edit the two paths in the unit if it is elsewhere.
+
+View logs with `journalctl --user -u codex-partner.service -f`. To keep it running after logout, run `sudo loginctl enable-linger "$USER"` once.
+
+## Use
+
+Create a session, choose a workspace and model, then send a message. Messages sent during an active turn queue automatically. Set a Goal to let Codex Partner keep resuming unfinished work. Reopen the same session from any connected device to continue the same thread.
+
+Type `/help` in the message input for commands. Press `` ` `` to toggle the terminal, `Shift+N` / `Shift+P` to switch sessions, and `Ctrl/Cmd+K` to focus the composer.

codex_partner-0.0.1/README.md

@@ -0,0 +1,76 @@
+# Codex Partner
+
+Codex Partner is a self-hosted control panel for long-running Codex work. It keeps one native Codex thread alive and lets terminals, browsers, and multiple devices interact with the same task.
+
+![Codex Partner task workspace](https://raw.githubusercontent.com/froststeam/Codex-Partner/main/docs/codex-partner.png)
+
+## Why
+
+- **Long tasks stop too early.** Persistent Goals can resume after a failed turn, disconnect, or service restart until the objective is complete.
+- **Multiple clients split the session.** Every connected browser is a view of the same server-owned Codex thread, not a competing `resume` process.
+- **Messages collide with active work.** New messages wait in a durable queue and enter the conversation only when their turn actually starts.
+
+## Highlights
+
+- Live task state, tool activity, context usage, and paginated history
+- Goal Resume with pause, retry, and restart recovery
+- Ordered message queue with manual dispatch
+- Workspace browser, editor, uploads, downloads, and image previews
+- Browser terminal that preserves its session when hidden
+- Model and API provider management with health checks and failover
+- Codex memories, Skills, archive, recycle bin, and SSH workspace support
+- Default YOLO mode for newly created sessions
+
+## Install
+
+Requires Python 3.10+ and an authenticated [Codex CLI](https://github.com/openai/codex).
+
+```bash
+git clone git@github.com:froststeam/Codex-Partner.git
+cd Codex-Partner
+python3 -m venv .venv
+. .venv/bin/activate
+pip install .
+cp .env.example .env
+codex-partner
+```
+
+Open <http://127.0.0.1:8787>.
+
+For access from other devices, set `CODEX_DASHBOARD_HOST=0.0.0.0` and a strong `CODEX_DASHBOARD_TOKEN` in `.env`.
+
+## Docker
+
+```bash
+docker build -t codex-partner:0.0.1 .
+docker run -d --name codex-partner \
+  -p 8787:8787 \
+  -e CODEX_DASHBOARD_TOKEN=replace-with-a-strong-random-token \
+  -v codex-partner-data:/var/lib/codex-partner \
+  -v codex-home:/home/codex/.codex \
+  -v codex-workspace:/workspace \
+  codex-partner:0.0.1
+docker exec -it codex-partner codex login
+```
+
+## systemd
+
+After completing the installation above, stop the foreground process and install the user service:
+
+```bash
+mkdir -p ~/.config/systemd/user
+cp codex-partner.user.service.example ~/.config/systemd/user/codex-partner.service
+systemctl --user daemon-reload
+systemctl --user enable --now codex-partner.service
+systemctl --user status codex-partner.service
+```
+
+This service uses the current user's existing Codex login, configuration, memories, and Skills. The example assumes the repository is at `~/Codex-Partner`; edit the two paths in the unit if it is elsewhere.
+
+View logs with `journalctl --user -u codex-partner.service -f`. To keep it running after logout, run `sudo loginctl enable-linger "$USER"` once.
+
+## Use
+
+Create a session, choose a workspace and model, then send a message. Messages sent during an active turn queue automatically. Set a Goal to let Codex Partner keep resuming unfinished work. Reopen the same session from any connected device to continue the same thread.
+
+Type `/help` in the message input for commands. Press `` ` `` to toggle the terminal, `Shift+N` / `Shift+P` to switch sessions, and `Ctrl/Cmd+K` to focus the composer.