Codex

TaskDeck in Codex.

Connect the Codex CLI, the IDE extension or the Codex app to your boards over MCP, track a project’s work on a board, and let a board hand cards to Codex sessions hosted by OpenAI.

Product Roadmap
Your team + a hand from a routineInteractive example
  • RP

    Design the onboarding flow

    Riley

    In progress
  • JL

    Fix the date picker

    Jamie

    In progress
ACM-24To doMKMorgan requested this task

Write the release notes for 2.4

Checklist
0/3

Agent sessions

Latest comment

Morgan

Can one of our routines draft these release notes? I'll review them before we publish.

Try Hand to Claude or Ask Codex, or replay the example. This demo uses sample data.

Connect Codex

One connection serves the Codex CLI, the IDE extension and the Codex app. Add TaskDeck’s MCP server, sign in, and approve the connection.

The connection is shared by the Codex CLI, the IDE extension and the Codex app.

  1. Connect TaskDeck

    Run:

    codex mcp add taskdeck --url https://mcp.taskdeck.me/mcp
  2. Sign in to TaskDeck

    Sign in:

    codex mcp login taskdeck
  3. Track a project

    Ask Codex to track this project on TaskDeck.

What Codex can do on your boards

Read and update cards

Read a board or a card in full, create cards, move them, comment and tick checklist items, within the access you approved.

Track its own work

With Autotrack, start-work opens a card for each task and finish-work verifies the work and moves the card on.

Act as you, or as an agent

When you approve the connection, choose whether it acts as you or as one of your AI agents, limited to the projects you pick.

Text, not widgets

Codex shows no TaskDeck widgets. The board, card and insights tools answer in Markdown, so it reads all of it as text.

Track a project from Codex

Ask Codex to track this project on TaskDeck. It previews the board, sets tracking up, and writes the Autotrack block into AGENTS.md, which Codex reads, creating the file when the project has none, and into CLAUDE.md as well.

Codex routines

A board can hand cards to Codex. Each hand-over starts a session hosted by OpenAI that works the card as your AI agent.

Set up
In Board settings → AI routines, choose Codex and add an OpenAI API key with the agents and responses permissions, a model, the routine’s instructions and, optionally, an environment template with your repository and tools.
One card per session
The session connects to TaskDeck with access to its card only, and TaskDeck adds its own rules to your instructions.
Questions
A required question holds the card, and the same session picks up again once every question is answered or withdrawn.
Stop
Stop cancels the session’s current turn and revokes its access to the card.
Handed back on its own
A session that fails, or sits idle without open questions, hands the card back by itself.
Billing
Runs are billed to your OpenAI project. A ChatGPT subscription doesn’t cover them.
How routines work

Good to know

  • AI connections, and with them Codex, are on the Pro and Max plans.
  • Setting up tracking needs a connection that acts as you.
  • Codex routines need the routine’s owner on Pro or Max, and an OpenAI API key.

Codex

Questions about TaskDeck in Codex

Does my ChatGPT subscription cover Codex routines?

No. Codex routines use an OpenAI API key, and runs are billed to that OpenAI project.

Does TaskDeck give Codex access to my code?

No. A Codex routine reaches your code through the OpenAI environment template you choose; left empty, it starts in a fresh sandbox.

Can a Codex routine change other cards?

No. Its connection reaches only the card it was handed.

Does Codex show TaskDeck widgets?

No. TaskDeck’s tools answer in text, and Codex reads all of it.

Give your next project a clear starting point.

Create a board, add your first task, and bring your team together.

No credit card required · Free forever plan