How tct68/claudex works
ClaudeX is a visual manager for a project’s Claude Code workspace. Users initialize a .claude workspace, start the local server, then manage commands, skills, hooks, agents, MCP servers, and workspace backups in the web UI. The API also supports template operations and Claude CLI tests; the registry exposes discovered workspace assets. The source excerpts establish server and service calls, but do not show how individual pages invoke the API, so those links are omitted. The README documents live reload and the vision-to-UI integration.
Main entry points: App.jsx Web app shell · index.js HTTP server · cli.js ClaudeX CLI · api.js Workspace API
Components 21
Entry and UI
- ClaudeX CLI
bin/cli.js - Web app shell
src/web/src/App.jsx - UI layout
src/web/src/components/Layout.jsx
Workspace management
- Workspace setup
src/server/services/workspace.js - Commands
src/web/src/pages/CommandsPage.jsx - Skills
src/web/src/pages/SkillsPage.jsx - Hooks
src/web/src/pages/HooksPage.jsx - Agents
src/web/src/pages/AgentsPage.jsx - MCP management
src/web/src/pages/MCPServersPage.jsx - Import and export
src/web/src/pages/ImportExportPage.jsx - Template preview
src/web/src/components/TemplatePreviewModal.jsx - Markdown preview
src/web/src/components/MarkdownPreview.jsx
Server runtime
- Workspace API
src/server/routes/api.js - HTTP server
src/server/index.js - Workspace discovery
src/server/services/workspace.js - Registry API
src/server/routes/registry.js - Asset registry
src/server/services/agent-registry.js
Integrations
- Claude CLI service
src/server/services/claude.js - Claude Code CLI
- Vision-to-UI server
src/mcp-servers/vision-ui/index.js
Other components
- Developer
Connections 21
- Developer → ClaudeX CLI: runs commands
bin/cli.js - ClaudeX CLI → Workspace setup: initializes workspace
bin/cli.js - ClaudeX CLI → HTTP server: starts server
bin/cli.js - Developer → Web app shell: manages workspace
README.md - Web app shell → UI layout: renders
src/web/src/App.jsx - Web app shell → Commands: routes to
src/web/src/App.jsx - Web app shell → Skills: routes to
src/web/src/App.jsx - Web app shell → Hooks: routes to
src/web/src/App.jsx - Web app shell → Agents: routes to
src/web/src/App.jsx - Web app shell → MCP management: routes to
src/web/src/App.jsx - Web app shell → Import and export: routes to
src/web/src/App.jsx - Template preview → Markdown preview: renders content
src/web/src/components/TemplatePreviewModal.jsx - HTTP server → Workspace API: mounts routes
src/server/index.js - HTTP server → Registry API: mounts routes
src/server/index.js - HTTP server → Workspace discovery: reads workspace
src/server/index.js - HTTP server → Claude CLI service: checks installation
src/server/index.js - Workspace API → Workspace discovery: gets workspace info
src/server/routes/api.js - Workspace API → Claude CLI service: tests commands
src/server/routes/api.js - Registry API → Asset registry: discovers assets
src/server/routes/registry.js - Claude CLI service → Claude Code CLI: spawns process
src/server/services/claude.js - Developer → Vision-to-UI server: uses MCP integration
README.md