coleam00
Codex CLI support
Hi, Please add official support for Codex CLI so it can also use subagents. It would be incredibly powerful—just like the support you implemented for Claude Code. Ideally, the UI could include dedicated tabs for Codex CLI as well.
Just to clarify, I'm referring to the regular version, not the API-based pricing tier.
Hi, there is no need to implement anything. The MCP Server is compatible and can be added to Codex as well as to any other IDE/Tool which supports mcp. The only thing is that we dont have an example configuration in the UI, which does not mean its not compatible.
See: https://github.com/coleam00/Archon/discussions/544#discussioncomment-14278583
Are subagents supported even if Codex CLI doesn't have this feature built in?
Archon does not provide subagents. It "just" a tool to help manage tasks and knowledge. Basically combining Context7 and Taskmaster, with more features coming in the future. The Coding features will stay in the Tool you use. Archon is no competitor to claude code / codex / etc.
@leex279 Yeah, I know it's an MCP server, but I'd love to see official UI documentation—just like the comprehensive docs you have for Claude Code. I hope you can provide the same level of detailed guidance for Codex CLI, so we don’t have to search the web for the best settings to use it with Archon
Sure, @coleam00 is on adding Claude Desktop examples as well. He can take this I guess also ;)
@looper200 I appreciate the suggestion! Like Thomas mentioned, the support is there just not the full documentation. In the MCP tab in the Archon UI where we list out some AI coding assistants, there isn't a enough room to cover more. However, once we add a dedicated docs site for Archon we'll have a page for basically every AI coding assistant including Codex!
Archon and Codex CLI — Not compatible without a proxy
Codex CLI only speaks MCP over STDIO right now. Archon’s MCP endpoint is remote (HTTP/Streamable HTTP), so they don’t pair directly. They are actively working to add Streamable HTTP to Codex; until that ships, use a tiny bridge (mcp-proxy) and you’re golden.
What works:
Use the [mcp-proxy](https://github.com/sparfenyuk/mcp-proxy) bridge to translate STDIO ⇄ Streamable HTTP.
Test command:
mcp-proxy --transport=streamablehttp http://localhost:8051/mcp
Codex CLI config (~/.codex/config.toml):
[mcp_servers.archon]
command = "mcp-proxy"
args = ["--transport=streamablehttp", "http://localhost:8051/mcp"]
Install mcp-proxy
Repo: https://github.com/sparfenyuk/mcp-proxy
Pick one:
# Recommended (Python uv)
uv tool install mcp-proxy
# Alternative (pipx)
pipx install mcp-proxy
# Latest from GitHub
uv tool install git+https://github.com/sparfenyuk/mcp-proxy
I tried the mcp-proxy path and was not able to get it to work. I'd be interested if this actually works. I can get the mcp-proxy to respond to a pseudo-MCP server such as hello-mcp but I never see any transactions occur on the Archon MCP connector.
I have been using Archon with Codex, here is the config
TOML
[mcp_servers.archon]
command = "npx"
args = ["-y", "mcp-remote", "http://localhost:8051/mcp", "--allow-http"]
Save to your user rood config file
I was able to get the test to connect and accept a connection.
mcp-proxy --transport=streamablehttp http://100.64.0.7:8051/mcp
but when codex attempt to connect to this i end up with MCP client for `archon` failed to start: request timed out
[mcp_servers.archon]
command = "mcp-proxy"
args = ["--transport=streamablehttp", "http://100.64.0.7:8051/mcp"]
I did also try with local host only to make sure it wasn't some kinda networking hiccup on my vpn I cannot find a debug flag or anything to get some more information out of codex cli. Anyone have a suggestion as to what I am doing incorrectly.
I had similar issues getting set-up with Codex (also same for other MCPs with Codex). I eventually got it to work with this set-up, although not really sure why the the long 'env' parameter helps. Happy for someone to explain or tell me what I'm doing wrong, but at least it works!
[mcp_servers.archon] command = "node" args = ["C:\Users\[USERNAME]\AppData\Roaming\npm\node_modules\mcp-remote\dist\proxy.js", "http://localhost:8051/mcp", "--allow-http"] env = { APPDATA="C:\Users\[USERNAME]\AppData\Roaming", LOCALAPPDATA="C:\Users\[USERNAME]\AppData\Local", HOME="C:\Users\[USERNAME]", SystemRoot="C:\Windows", ComSpec="C:\Windows\System32\cmd.exe", NPM_CONFIG_REGISTRY="https://registry.npmmirror.com" }
I had similar issues getting set-up with Codex (also same for other MCPs with Codex). I eventually got it to work with this set-up, although not really sure why the the long 'env' parameter helps. Happy for someone to explain or tell me what I'm doing wrong, but at least it works!
[mcp_servers.archon] command = "node" args = ["C:\Users[USERNAME]\AppData\Roaming\npm\node_modules\mcp-remote\dist\proxy.js", "http://localhost:8051/mcp", "--allow-http"] env = { APPDATA="C:\Users[USERNAME]\AppData\Roaming", LOCALAPPDATA="C:\Users[USERNAME]\AppData\Local", HOME="C:\Users[USERNAME]", SystemRoot="C:\Windows", ComSpec="C:\Windows\System32\cmd.exe", NPM_CONFIG_REGISTRY="https://registry.npmmirror.com" }
This worked for me as well. I have to replace '' with '/' The alternative would be to escape the backslash '\'.
I'll be doing some research tomorrow on how to add Archon to Codex based on your OS. I have it working on Windows but it is kind of hacky
@coleam00 thank you, man. Also, make videos with Archon and without Archon so people can clearly see the actual difference in the codebase and the overall improvements.
@coleam00 thank you, man. Also, make videos with Archon and without Archon so people can clearly see the actual difference in the codebase and the overall improvements.
You are welcome! I appreciate the suggestion too - it's difficult to show this kind of thing just with the unpredictable nature of LLMs but I have been thinking about how to do so well.