Repository navigation
Releases
v1.3.4
Fixes
- Prevent farm manifests from saving unloaded Codex multi-agent child thread IDs; child rollouts now resolve to their resumable root while independent forks keep their own IDs.
- Repair child-thread IDs already present in older manifests during restore.
- Wait briefly for Codex writer ownership to clear during farm reboot, avoiding shutdown races.
- Refuse to launch a duplicate writer when a conversation remains active in another Codex process, with safe recovery guidance instead of a failed TUI.
Upgrade note
Rerun source ./setup.sh after updating so the new codex-session-meta.py helper and updated save/restore scripts are installed. If an original conversation remains owned after /fork, use /resume in that same TUI or exit the owning Codex process before restoring it elsewhere.
Verification
- GitHub Actions passed on Python 3.10 and Python 3.13.
- Ruff, Bash syntax, ShellCheck, and all 328 unit tests passed.
- Isolated tmux validation, the demo, exact-session resume, and pinned deep-history integration passed.
- Child/root/fork identity and live/stale writer-lock regressions were verified.
Full changelog: v1.3.3...v1.3.4
v1.3.3
Fixes
- Prevent seamless Page Up from opening the deep-history popup before tmux copy mode has numerically reached the top of retained scrollback.
- Preserve the live-output handoff when scroll position temporarily exceeds history size.
- Advance the farm integration marker so existing tmux servers reinstall the corrected Page Up bindings.
- Detect stale installed compatibility launchers, restore native Page Up safely, and force binding reinstallation after the launcher is updated.
Upgrade note
Deep-history users should rerun source ./setup.sh --with-deep-history after updating so the installed compatibility launcher and active tmux bindings are refreshed.
Verification
- GitHub Actions passed on Python 3.10 and Python 3.13.
- Ruff, Bash syntax, ShellCheck, and all 315 unit tests passed.
- Isolated tmux validation, the demo, exact-session resume, and the pinned deep-history integration passed.
- The numeric-boundary regression was verified red against the old lexical predicate and green with this release.
Full changelog: v1.3.2...v1.3.3
v1.3.2
Fixes
- Make a standalone Escape key close the read-only deep-history popup while preserving Page Up, Page Down, arrow keys, and search input.
- Prevent split terminal navigation sequences from appearing as characters in the viewer.
- Let Escape dismiss a persistent viewer-startup failure and reliably restore the terminal state.
- Keep the copy-mode boundary intact so Page Up can reopen older history immediately after closing.
Verification
- GitHub Actions passed on Python 3.10 and Python 3.13.
- Ruff, ShellCheck, unit tests, isolated validation, exact-session resume, and the deep-history integration passed.
- The running 15-pane farm was upgraded and exercised in place: open, Page Up/Down, Escape close, and immediate reopen all passed.
Full changelog: v1.3.1...v1.3.2
v1.3.1
Fixes
- Fix deep-history popups passing a literal
#{pane_id}, so Page Up opens the archived transcript instead of flashing an empty error box. - Keep Page Up/Page Down inside the read-only
lessviewer, preserve the copy-mode boundary afterq, and allow Page Up to reopen the viewer immediately. - Keep future viewer startup errors visible until Enter and prevent navigation keys from echoing during loading.
- Include the exact-session restore and Bash 3 farm-reboot corrections merged after v1.3.0.
Verification
- GitHub Actions passed on Python 3.10 and Python 3.13.
- Ruff, ShellCheck, unit tests, isolated validation, exact-session resume, and the real deep-history integration passed.
- The running 15-pane farm was upgraded in place; every pane retained a healthy deep-history pipe and plugin doctor passed.
Full changelog: v1.3.0...v1.3.1
v1.3.0
Highlights
- Introduce the new Agent Looper system with modular runners, prompt presets, endless and gated completion modes, farm-native operation, split-pane layouts, control inboxes, safety checks, persistent state, retry handling, and hybrid Claude/Codex supervision.
- Add optional durable tmux deep history with pinned installation, automatic current/future pane capture, compatible farm-log mirroring, a seamless Page Up handoff beyond tmux RAM, responsive popups, and robust macOS/Python startup handling.
- Add safe farm reboot commands,
codex-doctor, exact session-resume integration, stronger save/restore behavior, and improved named-session diagnostics. - Improve Codex and Claude status detection, stale-state repair, blocked-output safeguards, high-memory window flags, and long-running looper visibility.
- Rename and document the project as Agent CLI Farm, with expanded operator guidance and examples.
- Harden setup for Bash 3 and supported Python selection, and expand Ruff, ShellCheck, Python 3.10/3.13, validation, resume, and deep-history CI coverage.
Deep-history upgrade note
Deep history remains opt-in because terminal transcripts may contain sensitive output. Install or refresh it with ./setup.sh --with-deep-history. Once enabled, the default automatic backend records current tmux panes and installs global hooks for future panes; use CODEXFARM_HISTORY_BACKEND=legacy to opt out.
Verification
- GitHub Actions passed on Python 3.10 and Python 3.13.
- Ruff formatting and lint passed.
- ShellCheck and Bash syntax checks passed.
- Unit tests, isolated validation, demo, exact session-resume integration, and deep-history integration passed.
Full changelog: v1.2.0...v1.3.0
v1.2.0
What's Changed
- Add a single shared autoservice registry for multiple named farms.
- Save named farms to separate default manifests.
- Add registered-farm save/restore modes for autosave/autorestore.
- Register named farms for the single annotator process.
- Fix named-farm status/watch behavior and update docs.
Verification
- python3 -m pytest -q
- shellcheck bin/codex-save bin/codex-restore bin/codex-add bin/codex-resume bin/codex-board bin/codex-status bin/codex-watch setup.sh examples/*.sh
- git diff --check HEAD
v1.1.2
Highlights
- Add named farm support for add/resume/board workflows, including derived board sessions for named farms.
- Ship direct Claude and Gemini wrapper commands alongside the existing Codex commands.
- Restore saved windows by launching tool-specific resume commands instead of typing resume commands into already-running panes.
- Capture exact active session IDs for Codex, Claude, and Gemini when autosaving from live panes, with safe latest/continue fallbacks when exact IDs are unavailable.
- Pin autosave/autorestore systemd units to the selected tmux farm and improve documentation around restore behavior.
Verification
- python3 -m pytest -q
- shellcheck bin/codex-save bin/codex-restore bin/codex-add bin/codex-resume bin/codex-board bin/codex-status bin/codex-watch setup.sh examples/*.sh
- git diff --check