codex-mcps-demo

Try it out

1. git clone https://github.com/jordan-cutler/codex-mcps-demo.git to clone the repo.
2. Create a .env file and set ANTHROPIC_API_KEY to your API key from the Anthropic console.
3. nvm install 22 && nvm alias default 22 && nvm use 22 to ensure you have node 22 and are using it
4. npm i -g pnpm to ensure you have pnpm installed
5. pnpm install to install dependencies
6. npm install -g @anthropic-ai/claude-code to install Claude per the official docs
7. node --experimental-strip-types scripts/claudeDiagram.ts <inputFolder>. For example, node --experimental-strip-types scripts/claudeDiagram.ts folder-samples/slack.
8. You should see the outputs/ folder update as Claude runs. Once it's finished, it will output a diagram.ai.md file to <inputFolder>/diagram.ai.md. For example, here's a commit from running it on folder-samples/slack

[!NOTE] From the .claude/settings.json file, Claude has access to bash commands. Run the script at your own risk.

Future expansion

There is a Github action in .github/workflows/claude-diagram.yml which runs the Claude script on a hardcoded folder (folder-samples/slack). This could be modified to only pass in any folders which have changed from the most recent push. Doing this would auto-generate documentation for every changed folder in the codebase as engineers commit to it.

You may or may not want to do this for your own reasons 😄