For Codex desktop
Task boards.
Inside Codex.
Plan your project, start a chat from a task, and review the result on the same card. Your boards stay on your device.
Open source · Free to use · Stored locally
01Plan the task. Goals, priorities, and prerequisites live on the card.
02Assign a chat. A claim gives one chat ownership of the task.
03Review the result. Read the changes and checks, then accept the work or request changes.
How it works
From task
to finished work.
Keep the brief, the owner, and the result in one place. Here’s the path of one installation task.
Start a new chat from a card, or ask an existing chat to pick it up. A new chat opens with a prepared prompt; send it to begin.
Package a one-command installation
Bundle the board, local server, workflow skill, and licenses. An existing installation must keep its cards.
- Package versions agree.
- A clean Codex profile opens the board.
- Upgrading preserves existing tasks.
The brief is ready for a chat to pick up.
The card keeps the outcome and acceptance criteria together, so the next chat starts with a useful brief.
Review
See what changed.
Decide what’s done.
A chat submits its work with a short progress note and the checks it ran. You can see the brief and the result together.
The chat adds notes to the card and submits its result for review. Threadboard does not read your conversation history.
Read the workflow guideYour projects
One project.
As many boards as you need.
Threadboard uses the projects you already created in Codex. Each gets an empty General board. Add Product, Release, or a board for the next thing you want to ship.
Separate boards.
The same project context.
Local storage
The board lives
on your machine.
Your tasks are saved on your device. Plugin updates and uninstalling Threadboard leave your boards intact.
Updates while you work.
A visible board checks a small local revision once a second. Cards reload after a change. Hidden panels pause, and open drafts stay open.
Your work survives updates.
Plugin files and task data have separate homes. Export a readable JSON snapshot, or back up the database to keep a restorable copy.
Keyboard and theme support.
Use the keyboard, work in a narrow panel, and follow your Codex theme. Threadboard stays beside the chats doing the work.
Requirements
Before you install.
Threadboard is an open-source preview. Here’s what it does today.
What do I need?
Codex desktop with plugin and MCP App support, the Codex CLI, and Node.js 22.13 or newer. The package includes the compiled app, so you don’t need npm or a build step to use it.
Will a card start a chat automatically?
Start in new chat opens Codex with a prepared task prompt. Send it to begin. You can also ask an existing chat to claim a card. A claim gives one chat ownership; it does not start work until you send the prompt.
What gets sent to a server?
Threadboard has no hosted backend and doesn’t sync boards or transcripts. When you ask Codex to work on a task, that task context uses your normal Codex model service and allowance. Local storage doesn’t make the model run offline.
Can I use it across multiple computers?
The current preview is for one device. It has local exports and database backups; it has no account or cross-device synchronization.
How ready is the preview?
Board opening has been confirmed in Codex. Backend, browser, performance, and installation checks run in CI. Native chat placement and full-view navigation recovery are still experimental. Read the current release notes.
Does it cost anything?
Threadboard is free and MIT licensed, with no board subscription or hosted backend to pay for. Task work still uses your existing Codex account and model allowance.
Install
Add Threadboard
to Codex.
Download the preview or install with the Codex CLI. Open Threadboard from the sidebar to find your projects.
Download the preview 1.2 MB Verify the checksum-
01
Extract the ZIP and open a terminal in that folder.
-
02
Run the installer.
node install.mjs -
03
Fully quit and reopen Codex. Open Threadboard from the sidebar.
Add the repository marketplace and install the plugin.
codex plugin marketplace add vrnrn/Threadboard --ref main
codex
plugin add threadboard@threadboard-plugins
Fully quit and reopen Codex, then open Threadboard from the sidebar.
Already have boards? The installer keeps your task data. User guide ↗
Free and open source.
Read the source, report a bug, or contribute a fix.