How rebel0789/codexpro works
CodexPro is a local MCP server that lets ChatGPT work within explicitly allowed repositories. The main loop routes tool requests through the server to bounded workspace operations: inspect and search code, make guarded changes, run checks, review likely impact, and preserve plans or context for handoff. Separate branches cover attachment import, image viewing, repository capabilities, and session handling. The source excerpts show several dispatches and analysis calls; other links are limited to README claims or source-index references, so uncertain call relationships are omitted.
Main entry points: server.ts MCP tool server · index.ts Workspace analysis · http.ts HTTP transport · searchOps.ts Search tools
Components 22
MCP entrypoints
- HTTP transport
src/http.ts - stdio transport
src/stdio.ts - MCP tool server
src/server.ts
Workspace access
- Workspace registry
src/guard.ts - File operations
src/fsOps.ts - Search tools
src/searchOps.ts - Command tools
src/bashOps.ts - Git operations
src/gitOps.ts - Image viewing
src/imageOps.ts - Attachment import
src/importOps.ts
Repository intelligence
- Workspace analysis
src/analysis/index.ts - File inventory
src/analysis/inventory.ts - Symbol extraction
src/analysis/extract.ts - Language classification
src/analysis/classify.ts - Change impact
src/analysis/impact.ts
Agent workflows
- Capability inventory
src/capabilitiesOps.ts - Context and plans
src/proContext.ts - Agent sessions
src/codexSessions.ts
Policy and state
- Runtime configuration
src/config.ts - Saved profiles
src/profileStore.ts - Secret redaction
src/redact.ts
Other components
- ChatGPT
Connections 25
- ChatGPT → HTTP transport: sends tool requests
README.md - HTTP transport → MCP tool server: routes MCP requests
src/http.ts - stdio transport → MCP tool server: serves MCP
- MCP tool server → Workspace registry: selects workspaces
src/server.ts - MCP tool server → File operations: dispatches file tools
src/server.ts - MCP tool server → Search tools: dispatches search
src/server.ts - MCP tool server → Command tools: dispatches commands
src/server.ts - MCP tool server → Git operations: dispatches git tools
src/server.ts - MCP tool server → Image viewing: views images
src/server.ts - MCP tool server → Attachment import: imports files
src/server.ts - MCP tool server → Workspace analysis: reviews changes
src/server.ts - MCP tool server → Capability inventory: inspects capabilities
src/server.ts - MCP tool server → Context and plans: builds workspace summary
src/server.ts - MCP tool server → Agent sessions: manages sessions
src/server.ts - Workspace analysis → File inventory: inventories files
src/analysis/index.ts - Workspace analysis → Symbol extraction: extracts symbols
src/analysis/index.ts - Workspace analysis → Language classification: classifies projects
src/analysis/index.ts - Change impact → Workspace analysis: inspects workspace
src/analysis/impact.ts - Search tools → Workspace analysis: runs structured search
src/searchOps.ts - Context and plans → File operations: reads and writes context
src/proContext.ts - HTTP transport → Runtime configuration: loads settings
src/http.ts - HTTP transport → Saved profiles: uses saved profiles
src/http.ts - Search tools → Runtime configuration: uses search limits
src/searchOps.ts - File operations → Secret redaction: redacts file results
src/fsOps.ts - Context and plans → Secret redaction: redacts context
src/proContext.ts