Tuskway for Codex
Hand Codex a ticket it can actually finish.
Codex does its best work on a well-scoped task. Tuskway turns each feature's design into tickets with a goal, acceptance checks, dependencies and the files to touch, and Codex reads the brief before it writes a line.
What changes
What Codex gets from Tuskway.
Briefs, not guesswork
Each ticket names its goal, acceptance checks and the areas of the code it touches. Codex works against that, not a summary of a chat.
Know what can run in parallel
Tickets carry dependencies and areas, so Tuskway can tell you what is ready to start and what would collide.
Status moves on its own
Starting a ticket marks it in progress. Opening the pull request moves it to review, in Tuskway and in your tracker once the ticket is published.
Setup
Connect Codex in a minute.
Then run the workflow from Codex, one command per step:
/start-epicCapture the goal, constraints and open questions./write-designDraft the tech design in sections your team reviews./draft-ticketsSplit it into briefs with acceptance checks./tackle-ticketBuild one ticket from its brief and design section.
Tuskway plugin
The plugin includes the MCP server and the Tuskway workflow skills: start an epic, write the design, draft tickets and tackle them. You connect once.
- 1
Install the plugin.
Installcodex plugin marketplace add tuskway/plugin codex plugin add tuskway@tuskway - 2
Sign in.
Sign incodex mcp login tuskway - 3
Say “set up Tuskway”. The setup skill checks the connection, finds your workspace and suggests what to do next.
Without the plugin: MCP server only· show
Connects the tools without the workflow skills. The plugin already includes this server, so use one or the other. If you switch to the plugin, remove this connection.
codex mcp add tuskway --url https://tuskway.com/mcpStep-by-step guide: set up Tuskway in Codex
FAQ
Codex questions.
Does Codex need access to Tuskway's copy of my code?
There isn't one. Codex reads your code where it already runs. Tuskway only stores the notes, design, tickets and comments.
Can I use Codex and Claude Code on the same feature?
Yes. That's the point: both read and update the same spec, so you can switch tools between tickets.
Your teammates use something else? Same spec.
Give Codex a plan your team agreed on.
Every agent on the team reads the same spec, whatever tool it runs in.