Jot for Codex

Let Codex fix what your reviewers report.

Two commands connect the repo. Ask Codex what is open in Jot: it reads each report with its screenshot, selector and replay summary, fixes the code, and replies on the reviewer's pin.

Connect it

Cursor, Codex, Windsurf, any agent
npx @usejot/cli login
npx @usejot/cli init

login opens your browser to pick a workspace. init connects the repo. No token to paste.

The MCP server, by handany MCP client
{
  "mcpServers": {
    "jot": {
      "command": "npx",
      "args": [
        "-y",
        "@usejot/mcp"
      ],
      "env": {
        "JOT_API_TOKEN": "…"
      }
    }
  }
}

Codex keeps MCP servers in ~/.codex/config.toml; codex mcp add writes it for you. Step by step in the docs · Set up Jot with an AI agent

What the agent reads

The whole repro, not a guess.

  • The reviewer's sentence and labels, pinned to the element
  • A screenshot of the page as they saw it
  • The URL and the element's CSS selector
  • Browser, operating system and screen size
  • On Record: a replay of the page, with console and network on one timeline
A reviewer's pin on a checkout page, with the agent's reply in the thread saying what it changed.A reviewer's pin on a checkout page, with the agent's reply in the thread saying what it changed.

Made for Codex

How it works in Codex

  • jot init writes a Jot section into AGENTS.md, which Codex reads, so the agent knows how to work the queue.
  • Add the server with codex mcp add, or in ~/.codex/config.toml.
  • Check it worked: codex mcp list shows jot. Then ask "what's open in Jot?".
fetch_feedback

Start here: to find open work, or to see what is left after a fix.

get_comment

Before touching code for a comment: it is the full repro.

update_status

IN_PROGRESS when you start; RESOLVED once the fix is in and tested, then reply.

post_reply

After every fix (what changed, how to check it), or to ask the reporter a question.

create_batch_note

One change fixed several comments: one note for all of them, not a reply each.

list_projects

Only to see which workspace and projects this token reaches.

Questions

Can Codex approve its own fixes?

Agents reply and resolve; who approves is your workspace's choice (by default, the person who reported it).

Which plan do I need?

MCP agents come with every plan, Free included. Reviewers stay free on every plan.

Do I paste a token into Codex?

No. jot login opens your browser to pick a workspace and saves the token in a profile on your machine; the MCP server reads it from there.

Also for: Claude Code · Cursor · Windsurf. Send Jots to: GitHub · Linear · Jira · Trello · Microsoft Teams

Your first Jot is a minute away.

Start free. Reviewers are always free, on every plan.