codex-tasklist — плагин для Codex: что делает и как установить
Плагин codex-tasklist создаёт живую панель задач для сессий Codex CLI с автосохранением в SQLite и переключением на tmux при отсутствии нативных панелей терминала.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-tasklist@awesome-codex-pluginsЧто делает codex-tasklist
Плагин отслеживает контекст диалога с Codex, автоматически формирует очередь задач по обычным запросам пользователя и выводит её в отдельную панель терминала. Очередь привязана к конкретной сессии, обновляет статусы по ходу работы и закрывается вместе с завершением процесса. Для работы нужен Python 3.10 или новее, при этом сторонние библиотеки не требуются — задействован только стандартный набор модулей.
Данные сохраняются в приватный временный каталог и сбрасываются в файл PLUGIN_DATA/runtime.sqlite3 после вызовов инструментов и событий жизненного цикла. Для терминалов WezTerm, kitty, iTerm2 и Ghostty предусмотрены нативные адаптеры. В остальных средах на Linux и macOS плагин разворачивает сессию через tmux.
Если компьютер выключится до записи чекпоинта в SQLite, последние изменения в очереди будут утеряны. В обычных терминалах Windows без WSL графическая панель не запустится, но команды управления очередью остаются доступными.
Какие задачи решает
- отслеживать статус шагов в отдельном окне во время работы Codex
- сохранять очередь задач между перезапусками сессии через локальную базу SQLite
- запускать панель задач в tmux без ручной настройки конфигурации
Примеры запросов агенту
- Настрой лаунчер codex-tasklist
- Покажи текущий список задач сессии
- Обнови статус второй задачи на завершённую
Как установить codex-tasklist
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install codex-tasklist@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о codex-tasklist
Как установить codex-tasklist в Claude Code?
Выполните в консоли /plugin marketplace add hashgraph-online/awesome-codex-plugins, а затем запустите команду /plugin install codex-tasklist@awesome-codex-plugins. После установки подтвердите доверие хукам и перезапустите клиент.
Что делает плагин codex-tasklist?
Он разворачивает отдельную боковую панель со списком задач для CLI-сессии Codex. Задачи добавляются и обновляются прямо из естественного диалога, а их состояние пишется в SQLite.
Какие терминалы поддерживают панель задач без tmux?
Нативные адаптеры встроены для WezTerm, kitty, iTerm2 и macOS-версии Ghostty. В других терминалах на Linux и macOS потребуется установленный в системе tmux.
Исходный текст
codex-tasklist · MIT
# Codex Tasklist A persistent per-session task queue for Codex CLI, with native terminal panels and automatic tmux setup. Version 2.0 requires Python 3.10+ and uses only the Python standard library. Write requests normally: Codex creates tasks, matches follow-ups, and updates statuses. Each session keeps its own saved queue. The panel opens with a live Codex CLI session and closes when its owner exits. Queue commands remain available if the panel cannot open. Version 2.0.3 restores panels under the shared Codex app-server daemon (0.155+), where hooks no longer run inside the interactive CLI: the session is bound to its `codex` process and the pane is matched by controlling tty. It also fixes sandbox write failures. Hooks supply a private temporary working directory shared by the CLI and panel, and checkpoint it to `PLUGIN_DATA/runtime.sqlite3` after tools and lifecycle events. Existing queues are imported; the last checkpoint restores tasks after temporary-file cleanup. A machine failure before checkpointing can lose the latest changes. Use the hook's exact `--data-dir`; reinstall, trust the updated hooks and restart Codex after upgrading. WezTerm, kitty, iTerm2 and supported Ghostty macOS scripting APIs have native adapters. Other Linux/macOS terminals, including VS Code, use tmux. Windows Terminal uses WSL for panels; native PowerShell/cmd keeps queue commands. Real Codex integration has been tested with WezTerm on Linux/Windows, kitty on Linux and Konsole through tmux. Native macOS adapters still need live platform verification. On native Windows, run **`codex`** or **`codex resume`** directly. The plugin opens WezTerm panels automatically and keeps queue commands available in other terminals. No launcher or shell-policy changes are needed. On Linux/macOS/WSL, ask Codex to **set up the codex-tasklist launcher**, then run `codex-tasklist` instead of `codex`. Arguments are forwarded, including `codex-tasklist resume`. The launcher uses a native panel when available or configures a private tmux session automatically. No tmux knowledge is required. If tmux is missing, install it once with your package manager; Codex can still run without a panel. Manual setup: run `python3 PATH/TO/scripts/tasklist.py --data-dir YOUR_PLUGIN_DATA install-launcher` (Linux/macOS/WSL). Add the printed directory to PATH if needed. Re-run setup after upgrades. The launcher does not install dependencies or edit shell profiles. To skip command installation, use `python3 PATH/TO/scripts/tasklist.py start -- resume`. Native requirements: kitty needs a permitted local Unix remote-control socket and `splits` layout; macOS adapters need Automation permission. Ghostty must expose terminal TTYs in its AppleScript API. A denied or unavailable API falls back through the launcher. iTerm2 AppleScript is deprecated upstream; tmux remains the fallback. An already running Codex cannot be moved into tmux automatically. See the [installation guide, demo and controls](https://github.com/martinille/codex-tasklist#readme). Review and trust hooks before use. See [SECURITY.md](SECURITY.md) for vulnerability reporting and [LICENSE](LICENSE) for the MIT license.
© Martin Ille · MIT · hashgraph-online/awesome-codex-plugins