codex-lens 0.1.34 → 0.1.36

package/CLAUDE.md

@@ -0,0 +1,61 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Codex-Lens is a visualization tool for Codex that monitors API requests and file system changes. It provides a UI with file explorer, code viewer with diff highlighting, integrated terminal, and Git status.
+
+## Tech Stack
+
+- **Frontend**: React 18, Vite, CodeMirror 6
+- **Backend**: Node.js (ESM), Express, WebSocket
+- **Terminal**: xterm.js, node-pty
+- **File Watching**: chokidar
+- **Diff Generation**: diff
+
+## Commands
+
+```bash
+npm run dev    # Start Vite dev server (port 5173)
+npm run build  # Build with esbuild (backend) + Vite (frontend) -> dist/
+npm start      # Run the production CLI from dist/
+```
+
+## Architecture
+
+### Backend (src/ - built to dist/)
+
+- **aggregator.js** - Central server class. Coordinates HTTP (port 5174), WebSocket, proxy, file watcher, PTY, and Git. Contains embedded fallback HTML UI.
+- **cli.js** - Entry point. Finds Codex binary, creates aggregator, opens browser.
+- **proxy.js** - Intercepts OpenAI API requests, parses SSE streams, broadcasts events.
+- **watcher.js** - chokidar-based file watcher. Tracks code files, generates diffs on change, emits file_tree updates.
+- **pty-manager.js** - Spawns/管理 Codex PTY process via node-pty. Handles terminal I/O and buffering.
+- **git-manager.js** - Git operations (status --porcelain, stage, unstage, commit). Debounces status broadcasts.
+
+### Frontend (src/components/)
+
+- **App.jsx** - Main component. Manages tabs, WebSocket connection, file tree, Git status panel.
+- **CodeViewer.jsx** - CodeMirror 6 wrapper with syntax highlighting (20+ languages) and diff decoration plugin.
+- **TerminalPanel.jsx** - xterm.js terminal connected via WebSocket to backend.
+
+### Communication Flow
+
+1. Frontend connects via WebSocket (`/ws`) to aggregator
+2. Aggregator broadcasts file_change, file_tree, git_status events
+3. File watcher detects changes -> emits via WebSocket -> App updates state
+4. PTY forwards terminal I/O via separate WebSocket (`/ws/terminal`)
+5. Git status updates are debounced (500ms) after file changes
+
+### Key Files
+
+- `src/index.html` - HTML entry point served by Vite in dev
+- `src/global.css` - Global styles
+- `src/lib/logger.js` - Logging utility
+- `src/lib/sse-parser.js` - SSE stream parser for proxy
+- `src/lib/diff-builder.js` - Diff generation utilities
+
+## Build System
+
+- `build.js` - esbuild bundles each backend file individually (no bundling), Vite builds frontend to `dist/public/`
+- `vite.config.js` - Vite configured with src as root, proxies `/ws` and `/api` to port 5174

package/dist/aggregator.js

@@ -269,6 +269,27 @@ class Aggregator {
         await this.gitManager.commit(data.message);
         this.gitManager.broadcastUpdate();
       }
+    } else if (data.type === "git_push") {
+      if (this.gitManager?.isGitRepo()) {
+        const result = await this.gitManager.push();
+        this.broadcast({ type: "git_operation_result", operation: "push", success: result.success, message: result.message });
+        if (result.success) {
+          this.gitManager.broadcastUpdate();
+        }
+      }
+    } else if (data.type === "git_pull") {
+      if (this.gitManager?.isGitRepo()) {
+        const result = await this.gitManager.pull();
+        this.broadcast({ type: "git_operation_result", operation: "pull", success: result.success, message: result.message });
+        if (result.success) {
+          this.gitManager.broadcastUpdate();
+        }
+      }
+    } else if (data.type === "git_fetch") {
+      if (this.gitManager?.isGitRepo()) {
+        const result = await this.gitManager.fetch();
+        this.broadcast({ type: "git_operation_result", operation: "fetch", success: result.success, message: result.message });
+      }
     }
   }
   broadcast(event) {

package/dist/git-manager.js

@@ -111,6 +111,22 @@ class GitManager {
     await this.runGitCommand(["commit", "-m", message]);
     return this.getStatus();
   }
+  async runRemoteOperation(operation, args, successMsg) {
+    const result = await this.runGitCommand(args);
+    return {
+      success: result.code === 0,
+      message: result.code === 0 ? successMsg : result.stderr || `${operation} \u5931\u8D25`
+    };
+  }
+  async push() {
+    return this.runRemoteOperation("Push", ["push"], "Push \u6210\u529F");
+  }
+  async pull() {
+    return this.runRemoteOperation("Pull", ["pull"], "Pull \u6210\u529F");
+  }
+  async fetch() {
+    return this.runRemoteOperation("Fetch", ["fetch", "--all"], "Fetch \u6210\u529F");
+  }
   async broadcastUpdate() {
     const branch = await this.getCurrentBranch();
     const status = await this.getStatus();