AGENTS.md points at a nonexistent path: codex-mcp/src/mcp_connection_manager.rs

Open Beginner friendly
#36,068 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
90/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
rust
Domain
documentation

Research direction

Open AGENTS.md and check the MCP guidance against the codex-rs/codex-mcp/src directory. Update the outdated mcp_connection_manager.rs reference to connection_manager.rs, then verify that the referenced file exists on main and the documentation contains no stale path.

Written by the indexing model from the issue text.

Description

documentation mcp

The MCP guidance in AGENTS.md points at a file that does not exist:

When working with MCP tool calls, prefer using codex-rs/codex-mcp/src/mcp_connection_manager.rs to handle mutation of tools and tool calls.

codex-rs/codex-mcp/src/mcp_connection_manager.rs is not present on main. The module is codex-rs/codex-mcp/src/connection_manager.rs — the mcp_ filename prefix is gone.

This matters because AGENTS.md is read by coding agents: an agent following that line looks for a file that isn't there and then either stops or guesses at the right one.

Suggested fix, one line:

-- When working with MCP tool calls, prefer using `codex-rs/codex-mcp/src/mcp_connection_manager.rs` to handle mutation of tools and tool calls.
+- When working with MCP tool calls, prefer using `codex-rs/codex-mcp/src/connection_manager.rs` to handle mutation of tools and tool calls.

I have this staged on a branch but could not open a PR — CreatePullRequest returns a permissions error for my account on this repo, so I am filing it here instead. Happy to submit a PR if outside contributions are enabled, or feel free to apply the one-line change directly.

Found with unrot and verified by hand against main.

Dominant language
Rust
Stars
125k
Forks
19.5k
Avg merge
1m
Merged PRs (30d)
1k

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from openai/codex

All issues in openai/codex

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.