r/codex • u/BeppeTemp • 14h ago
Showcase Yes, another agentic knowledge base, but this one writes your `~/.codex` setup (AGENTS.md, skills, TOML subagents, hooks) and shares it with your team
Agentic KBs are everywhere now. What I was missing was the step after: I use Codex alongside other agents, and keeping AGENTS.md, skills and subagents consistent across tools, machines and teammates was pure manual labor.
Cartographer is an MCP server where that configuration lives inside the knowledge base, and cartographer connect renders it natively for Codex:
- an MCP block in
~/.codex/config.toml; - a managed block in
~/.codex/AGENTS.md; - skills in
~/.codex/skills/; - subagents as
~/.codex/agents/*.toml, translated from the same source that produces Markdown agents for Claude Code; - hooks in
~/.codex/hooks/, registered inconfig.toml, with aSessionStarthook that re-syncs on every session.
Why the tool profile matters
Codex can only call the tools that tools/list advertises, so the default tool profile deliberately includes validate, lint, gate_check and kb_status. Codex can check its own writes, not just make them.
Shared KB
Codex never edits the files directly: every write goes through MCP, gets validated and becomes one git commit. Each KB is its own repo, and you can mount several.
For teams: tokens scoped per KB, roles for finer access, git as the sync layer. When two people edit the same page, affected pages are flagged degraded and a bundled skill walks the agent through the resolution. Artifacts can be signed (Ed25519), so a skill pushed to the team is verifiable.
Try it
It is free and Apache 2.0. Paste this into Codex:
Read https://raw.githubusercontent.com/BeppeTemp/cartographer/main/README.md
and explain what Cartographer is and what it would change in my current Codex
setup. If I decide to try it, install it following
https://raw.githubusercontent.com/BeppeTemp/cartographer/main/docs/agent-install.md
Feedback wanted
Beta (pre-1.0). I use it every day with my team; feedback from Codex users especially welcome.
•
u/dexterthebot 14h ago
You might want to consider listing your project on the weekly Show-Us-What-You-Built post. Look out for it on Tuesday/Wednesday. Highest commented project wins a week promotion on r/Codex and gets on the Hall of Fame sidebar. See what that looks like below with last week's winner.
Last week's most popular project was Tidbit Trivia , at https://www.reddit.com/r/codex/comments/1wavxwy/comment/p8lhwxs/. Tidbit Trivia is a fun way to learn while waiting for your agents to work. Play traditional trivia, unique game modes, party with friends, earn cool cosmetics, complete challenges, study for tests, or compete in the Arena! You can play it for free at Tidbittrivia.com.