[codex] add browser, terminal, and thread-management MCP tools

[JoshuaRileyDev]

Summary

This PR expands the MCP surface in T3 Code so agents can directly use the built-in browser and terminal surfaces, and adds project/thread management tools for orchestration workflows. It also makes those capabilities explicit in the chat turn instructions so they are surfaced when prompts are generated.

The branch has been squashed into a single commit for easier review.

What changed

• Added a dedicated browser-opening alias, browser_open, that routes to the existing internal preview/browser broker.
• Added terminal_run so an MCP client can open the scoped built-in terminal and send a shell command in one call.
• Added orchestration MCP tools for:
  • projects_list
  • threads_list
  • threads_create
  • threads_archive
• Extended shared contracts for the new orchestration and terminal tool inputs/results.
• Registered the new toolkits in the MCP HTTP server and covered them with server tests.
• Updated the Codex developer instructions so chat prompts explicitly mention the new browser, terminal, and thread-management tools.

Behavior details

• browser_open reveals the internal browser for the current thread and can optionally navigate to a URL immediately.
• terminal_run reuses the scoped terminal session when possible, opens it if needed, and writes the command with a trailing newline.
• projects_list returns the visible project shells from the current orchestration snapshot.
• threads_list filters threads by projectId.
• threads_create uses project defaults when a thread-level model selection is not supplied, then reloads the created thread from projection state.
• threads_archive is idempotent when the thread is already archived and otherwise dispatches the archive command before reloading the updated thread.
• The developer prompt now names these capabilities explicitly so they are visible in chat-based turn construction, not just as hidden MCP registrations.

Validation

• bun fmt
• bun lint
• bun typecheck

Notes

The repository already had the internal preview/browser surface; this PR makes that capability available as a clearer MCP entrypoint for agents and pairs it with terminal and thread-management actions.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 278015c1-367c-4db1-8de7-118900a9d381

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}