mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-02-18 00:17:39 +01:00
24931a2718
The Codex MCP tool description was misleading - it said "Ask a question" and "Returns a thoughtful response" which implied it was read-only. In reality, Codex has full filesystem access and can create/modify files directly since the MCP server executes the `codex` CLI agent which has full implementation capabilities. **Changes:** - Updated description to clarify Codex can "implement changes or answer questions" - Added note that "Codex has full filesystem access and can create/modify files directly" - Updated inputSchema description from "question" to "question or implementation task" - Updated comment from "for initial questions" to "for both questions and implementation" This prevents confusion about Codex being a read-only Q&A tool when it's actually a full implementation agent.
Pulse Codex MCP Server
An MCP (Model Context Protocol) server that provides OpenAI Codex integration for Claude Code.
Features
- codex - Ask questions to OpenAI Codex AI assistant
- codex_clear_session - Clear stored session context
- Automatic session management across conversation turns
- Clean response extraction (no token counts or debug info)
Installation
1. Build the Server
cd /opt/pulse/mcp-server
npm install
npm run build
2. Add to Claude Code
claude mcp add --transport stdio pulse-codex -- node /opt/pulse/mcp-server/dist/index.js
Usage
In Claude Code Conversations
Ask a question:
Use the codex tool to evaluate whether we should use X or Y for Z scenario
Continue a conversation:
Use the codex tool with conversationId "my-conversation" to dig deeper into that approach
Start fresh:
Use the codex_clear_session tool with conversationId "my-conversation"
How It Works
- Each conversation is identified by a
conversationId - The server automatically maintains codex session IDs for each conversation
- Responses are clean (just the answer, no metadata)
- Sessions persist across multiple tool calls with the same conversationId
Development
Watch mode for development:
npm run dev
Architecture
- TypeScript - Type-safe MCP server implementation
- @modelcontextprotocol/sdk - Official MCP SDK
- stdio transport - Communicates with Claude Code via standard input/output