# Codex on Mac: Usage Limits, Workspaces and MCP

> Codex's 5-hour and weekly limits in the menu bar, local and Codex Cloud history, a board that launches Codex with your model and effort, and every Edith command as an MCP tool.

- Canonical URL: https://getedith.pro/agents/codex
- Updated: 2026-11-15
- Codex: https://openai.com/codex

See Codex usage limits and history on your Mac, run Codex agents side by side on one board, answer approvals and connect Codex to Edith over MCP.

## Connect Codex to Edith over MCP

```sh
codex mcp add edith -- /Applications/Edith.app/Contents/MacOS/ed mcp
```

Or let Edith write the entry for you:

```sh
ed mcp install --client codex
```

Or add this to `~/.codex/config.toml`:

```toml
[mcp_servers.edith]
command = "/Applications/Edith.app/Contents/MacOS/ed"
args = ["mcp"]
```

See the [Edith MCP server](https://getedith.pro/mcp.md) for how tools, previews and confirmation work.

## Edith extensions for Codex

- [Claude Code Usage Tracker for Mac: Codex, Cursor](https://getedith.pro/extensions/claude-code-usage): See what your coding agents cost and how close you are to their limits.
- [Run Multiple Claude Code and Codex Agents on Mac](https://getedith.pro/extensions/coding-agents): See every coding agent on your Macs in one board, and step in when one needs you.
- [Claude Code, Codex and Cursor Skills for Mac](https://getedith.pro/extensions/agent-skills): Teach your coding agents how to use Edith with one-click skills.
- [Review Pull Requests on Mac in a Terminal Workspace](https://getedith.pro/extensions/code-review): Review GitHub pull requests and code changes in a focused terminal workspace.
- [Terminal With Broadcast Input and Tabs for Mac](https://getedith.pro/extensions/terminal): A fast built-in terminal with tabs that keeps your shells in one place.

## FAQ

### Where does Edith find my Codex history?

In `~/.codex/sessions` and `~/.codex/archived_sessions`, or in the folder `CODEX_HOME` points to. Press refresh on the Usage page, or run `ed usage refresh`, to collect it.

### Why does Codex Cloud show less usage than I expected?

Edith reads Codex Cloud by launch surface. Cloud tasks started from the desktop app or the CLI are left out so they are not counted twice, and the provider may return only part of your older history.

### Does Edith change my Codex config?

Only when you ask. `ed mcp install --client codex` adds an `[mcp_servers.edith]` table to `config.toml` and keeps a `.edith-backup` copy first. Session activity writes `hooks.json` only after you turn it on.

### How do I connect Codex to Edith over MCP?

Run `ed mcp install --client codex` or `codex mcp add edith -- /Applications/Edith.app/Contents/MacOS/ed mcp`, then restart Codex. The [MCP server page](https://getedith.pro/mcp) has the config block.
