Agent PBX v0.10.0

v0.10.0 - 2026-06-18

Highlights

• Adds first-class operator agents with TUI lifecycle controls, a dedicated
  Operators split, tmux-backed operator launch paths, and fork-pane cycling for
  monitoring operator-owned caller forks.
• Adds operator campaign persistence with dedicated SQLite tables for campaigns,
  assignments, events, forks, and fork DAG links so campaign queries do not rely
  on report metadata scans.
• Adds operator campaign routing through caller forks, including @caller:
  reference expansion, fork regeneration after caller restarts, stale tmux
  target repair, and safer campaign dispatch checks.
• Adds the TUI Campaigns tab for viewing operator campaign state and generated
  campaign reports, plus View Report (R) / /campaign report.
• Adds campaign-to-Joplin capture with Copy Note (C), Shift+C, and
  /campaign copy, creating a new scoped Joplin note with campaign detail and
  loaded generated reports.
• Improves tmux plan-selection routing for native Codex plan selectors and
  pre-plan choice handling.
• Refreshes the README TUI demo GIF for the new operator, campaign, and Joplin
  workflows while reducing the release asset size.
• Adds configurable GitHub remote/SSH settings for PR and issue workflows.

Verification

• python -m pytest
• git diff --check
• Release wheelhouse build with scripts/build_wheelhouse.sh
• Local no-index wheelhouse install smoke test

Release Assets

• agent-pbx-wheelhouse.tar.gz - e5a934cf31effc74b35e60812f3c8633194aeda9a04ff2ed42e222e25a28d830
• install-agent-pbx.sh - 4180a89d9aca85c9d0fcb0c3f525fbe9d3e8ed1a772a74fc047017d88d33597f

Agent PBX v0.9.0

Highlights

• Added GitHub Pull Request and Issue workflow tabs in the TUI.
• Added API, schema, store, and MCP support for PR review/merge and issue mitigation flows.
• Added lazy Joplin note reference completion and lazy project file completion from prompt input.
• Improved /plan:N handling so plan selections work against the target agent even when UI focus has shifted.
• Refreshed the README hero GIF and WorkerBee-based TUI demo capture pipeline.
• Added palette shortcuts for opening Latest, Thread, and Files.

Install

curl -fsSL https://github.com/m4xx3d0ut/agent-pbx/releases/latest/download/install-agent-pbx.sh | sh
agent-pbx --version

Verification

• pytest: 321 passed, 9 existing Textual coroutine warnings
• wheelhouse build completed for agent-pbx 0.9.0
• isolated wheelhouse install smoke test returned agent-pbx 0.9.0

Agent PBX v0.8.1

Highlights

• Fixes stale Joplin sync status in the TUI so an older sync failure no longer keeps showing Sync: error after a newer successful sync.
• Adds tmux/Termux-safe Joplin action shortcuts with Ctrl+G as the leader, plus j as an alternate leader when focus is outside the editable note body.
• Makes Joplin tab button shortcuts visible directly in the action labels: New n, Ren m, Del d, Save s, Ref r, Copy c, LOG+ l, LOG- x, and Sync u.
• Fixes /joplin copy from the Latest input so it targets the input-selected agent instead of the Agents table cursor.
• Updates README guidance for the Joplin shortcut workflow.

Verification

• python -m pytest -> 293 passed, with the existing WorkerBee coroutine warning.
• git diff --check
• scripts/build_wheelhouse.sh --out dist/agent-pbx-wheelhouse --python .venv/bin/python
• Isolated wheelhouse install smoke: agent-pbx 0.8.1

Assets

• agent-pbx-wheelhouse.tar.gz SHA256: ab011472e0a2c7d73f587a98c6856a8d762009172f1143701428131f61c75f1d
• install-agent-pbx.sh SHA256: 4180a89d9aca85c9d0fcb0c3f525fbe9d3e8ed1a772a74fc047017d88d33597f

Agent PBX v0.8.0

Highlights

• Adds a queued Joplin sync gateway with durable sync jobs, sync status
  reporting, and a /v1/joplin/sync API for manual or write-triggered sync.
• Adds project-scoped Joplin note APIs so notes created directly under an Agent
  PBX project notebook can be listed, read, edited, deleted, and referenced.
• Expands the TUI Joplin tab to show project-level notes while keeping COPY and
  LOG captures attributed under agent/session note folders.
• Adds @joplin: references in the Latest input. Tab completion uses cached
  project note titles, and send-time expansion fetches fresh note bodies into a
  Markdown Joplin Note References section for Codex review.
• Updates README and AGENTS/runbook guidance for project-scoped Joplin
  references, sync-on-write, and operator prompt expansion behavior.

Verification

• python -m pytest
• git diff --check
• Release wheelhouse build with scripts/build_wheelhouse.sh

Artifacts

• agent-pbx-wheelhouse.tar.gz SHA256: 335f71dc4a44afe01dcdfeacff674754d54041e19e2a45cb03dd76bf4cc4daaa
• install-agent-pbx.sh SHA256: 4180a89d9aca85c9d0fcb0c3f525fbe9d3e8ed1a772a74fc047017d88d33597f

Agent PBX v0.7.0

Highlights

• Adds optional Joplin notes integration with scoped notebooks under project > agent, MCP document export, and server-side configuration for local REST API plus CLI/WebDAV sync.
• Adds the TUI Joplin tab for listing, viewing, creating, renaming, deleting, saving, COPY notes, and growing LOG notes within the Agent PBX notebook scope.
• Adds tmux-direct Joplin COPY/LOG capture using Codex /copy and local clipboard helpers, so prompts and copied responses can be written to notes.
• Adds sync-on-write support that runs joplin --profile <profile> sync after note writes, and surfaces Joplin zero-exit E2EE errors such as unloaded master keys.
• Improves tmux plan-selection routing and alerts, including relaxed scope for visible native Codex plan selectors.
• Syncs starred agents across TUI clients so workstation and watch-screen TUIs share pinned agent ordering.
• Expands user configuration defaults, Joplin availability guards, README guidance, and AGENTS/runbook notes for Joplin and tmux-direct workflows.

Verification

• .venv/bin/python -m pytest (280 passed, 1 warning)
• git diff --check
• .venv/bin/python -m build --sdist --wheel
• scripts/build_wheelhouse.sh --out dist/agent-pbx-wheelhouse --python .venv/bin/python
• Offline wheelhouse install smoke test: agent-pbx --version reported agent-pbx 0.7.0

Assets

• install-agent-pbx.sh: installer wrapper for artifact-based installs.
• agent-pbx-wheelhouse.tar.gz: offline wheelhouse containing Agent PBX and runtime dependencies.

Agent PBX v0.6.0

Highlights

• Adds agent-pbx-tui, a TUI-only launcher for lightweight LAN clients with
  dotenv-style config at ~/.config/agent-pbx/tui.env.
• Adds low-power TUI watch mode, configurable refresh intervals, and updated
  tiny/mobile focus shortcuts for small terminals such as PocketCHIP.
• Improves remote TUI refresh by tailing current events and isolating the SSE
  event worker from other Textual refresh workers.
• Adds shared latest-report seen state so clearing NEW in one TUI clears it
  in other connected TUIs.
• Fixes no-report agents incorrectly appearing as NEW, and makes the tiny
  Agents view show Project directly after Status.
• Adds /v1/events?tail=true&limit=N for efficient latest-event reads and
  advances the database schema to version 7 with latest-report seen backfill.

Verification

• python -m pytest
• git diff --check
• PocketCHIP remote TUI probes for event refresh and shared NEW clearing

Agent PBX v0.5.0

Highlights

• Adds richer Files tab image previews in the TUI with truecolor ANSI
  half-block rendering, grayscale text fallback, built-in PNG decoding, and GIF
  first-frame decoding.
• Adds optional image decoding support through agent-pbx[images] for Pillow,
  plus a best-effort chafa fallback when the binary is installed on the host.
• Improves tmux direct mode by tracking tmux streaming per selected agent, so
  one agent can use the tmux stream while another stays on the standard PBX
  latest report view.
• Adds cached @path completion in the Latest input and tmux direct input from
  directories already read in the Files tab.
• Adds /ctrlc support for sending Ctrl+C through tmux direct mode, useful for
  backing out of Codex /side chat.
• Expands TUI and workflow test coverage around file browsing, path completion,
  tmux mode selection, and image preview rendering.

Assets

• agent-pbx-wheelhouse.tar.gz sha256: d5691a9118d98b214ea789f17bce372f5b99620deefda982e9c3f0ff97fda03a
• install-agent-pbx.sh sha256: cd1bc22731eae1a4a827a36c368cda29700c64a0e6392782c5b76ca90f410559

Verification Results

• python -m pytest: 219 passed
• git diff --check: passed
• Local wheelhouse smoke test: agent-pbx 0.5.0

Agent PBX v0.4.0

Highlights

• Adds the TUI project file browser for viewing agent workspace files without
  leaving Agent PBX.
• Improves tmux-backed workflows with safer toggles, better mobile key
  navigation, and focus controls for small terminals and SSH/Termux use.
• Expands command palette and slash-command support, including Git helpers and
  custom user command configuration.
• Adds README hero/demo assets and a scripted TUI demo capture flow.
• Aligns AGENTS.md and runbook guidance around report mode, nohup polling mode,
  planning, and completion git-state reporting.
• Fixes WorkerBee project status selection when multiple WorkerBee records share
  the same project cwd, so explicit running projects are preferred.

Assets

• agent-pbx-wheelhouse.tar.gz sha256: 2761ddc5fe171d704aaad38837a564f016722e63092ef626e22aad0a7f1788c0
• install-agent-pbx.sh sha256: cd1bc22731eae1a4a827a36c368cda29700c64a0e6392782c5b76ca90f410559

Verification Results

• python -m pytest: 209 passed
• git diff --check: passed
• Local installer smoke test: agent-pbx 0.4.0

Agent PBX v0.3.0

Highlights

• Adds the corrected tmux-backed palette /plan flow: type /plan first, then send one Agent PBX planning prompt with structured plan-option instructions.
• Adds literal tmux key sending for slash commands so Codex handles them as interactive commands.
• Expands README guidance for palette commands and custom TUI theme creation.
• Bumps package version to 0.3.0 and modernizes Apache-2.0 package license metadata.

Verification

• python -m pytest: 169 passed
• git diff --check: passed
• Built dist/agent-pbx-wheelhouse.tar.gz
• Smoke installed from the local wheelhouse and verified agent-pbx --version reports 0.3.0

Agent PBX v0.2.0

Full Changelog: v0.1.1...v0.2.0