ai-cli-log 1.0.0

package/README.md

@@ -0,0 +1,23 @@
+# ai-cli-log
+
+Seamlessly log your AI-powered coding conversations. This command-line interface (CLI) tool captures your terminal interactions with AI models like Gemini and Claude, saving entire sessions as clean Markdown documents for easy review and documentation.
+
+## Features:
+
+*   **Interactive Session Capture:** Acts as a wrapper for other CLI tools, capturing full interactive sessions, including user input and the "rendered" output (what you actually see on the terminal after backspaces, cursor movements, etc.).
+*   **Accurate Logging:** Utilizes `node-pty` for pseudo-terminal emulation and `@xterm/headless` to parse ANSI escape codes, ensuring the captured log accurately reflects the final state of the terminal screen.
+*   **Markdown Output:** Saves recorded sessions as clean Markdown files for easy readability and documentation.
+*   **TypeScript Implementation:** Built with Node.js and TypeScript, leveraging a robust ecosystem for CLI development and type safety.
+
+---
+
+# ai-cli-log
+
+无缝记录您的 AI 驱动的编码对话。这个命令行界面 (CLI) 工具捕获您与 Gemini 和 Claude 等 AI 模型的终端交互，并将整个会话保存为整洁的 Markdown 文档，以便于回顾和归档。
+
+## 功能特点：
+
+*   **交互式会话捕获：** 作为其他 CLI 工具的包装器，捕获完整的交互式会话，包括用户输入和“渲染后”的输出（即在退格、光标移动等操作后您在终端上实际看到的内容）。
+*   **精确日志记录：** 利用 `node-pty` 进行伪终端模拟，并使用 `@xterm/headless` 解析 ANSI 转义码，确保捕获的日志准确反映终端屏幕的最终状态。
+*   **Markdown 输出：** 将记录的会话保存为整洁的 Markdown 文件，便于阅读和文档化。
+*   **TypeScript 实现：** 使用 Node.js 和 TypeScript 构建，利用强大的生态系统进行 CLI 开发和类型安全。

package/dist/index.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const pty = __importStar(require("node-pty"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const headless_1 = require("@xterm/headless");
+const args = process.argv.slice(2);
+const command = args[0];
+const commandArgs = args.slice(1);
+if (!command) {
+    console.error('Usage: ai-cli-log <command> [args...]');
+    process.exit(1);
+}
+const logsDir = path.join(process.cwd(), '.ai-cli-logs');
+if (!fs.existsSync(logsDir)) {
+    fs.mkdirSync(logsDir);
+}
+// Initialize xterm.js in headless mode
+const xterm = new headless_1.Terminal({
+    rows: process.stdout.rows,
+    cols: process.stdout.columns,
+    scrollback: Infinity, // Set scrollback to Infinity for unlimited buffer
+    allowProposedApi: true,
+});
+const term = pty.spawn(command, commandArgs, {
+    name: 'xterm-color',
+    cols: process.stdout.columns,
+    rows: process.stdout.rows,
+    cwd: process.cwd(),
+    env: process.env,
+});
+// Pipe pty output to xterm.js and also to stdout
+term.onData((data) => {
+    process.stdout.write(data);
+    xterm.write(data);
+});
+// Pipe stdin to pty
+process.stdin.on('data', (data) => {
+    term.write(data.toString());
+});
+process.stdin.setRawMode(true);
+process.stdin.resume();
+term.onExit(({ exitCode, signal }) => {
+    // Add a small delay to ensure xterm.js has processed all output
+    setTimeout(() => {
+        // Extract rendered text from xterm.js buffer
+        let renderedOutput = '';
+        // Iterate over the entire buffer, including scrollback.
+        // The total number of lines is the sum of lines in scrollback (baseY) and visible rows.
+        for (let i = 0; i < xterm.buffer.active.baseY + xterm.rows; i++) {
+            const line = xterm.buffer.active.getLine(i);
+            if (line) {
+                // translateToString(true) gets the line content, and we trim trailing whitespace.
+                const lineText = line.translateToString(true).replace(/\s+$/, '');
+                renderedOutput += lineText + '\n';
+            }
+        }
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = (now.getMonth() + 1).toString().padStart(2, '0');
+        const day = now.getDate().toString().padStart(2, '0');
+        const hours = now.getHours().toString().padStart(2, '0');
+        const minutes = now.getMinutes().toString().padStart(2, '0');
+        const seconds = now.getSeconds().toString().padStart(2, '0');
+        const prefix = command || 'session';
+        const logFileName = `${prefix}-${year}${month}${day}-${hours}${minutes}${seconds}.md`;
+        const logFilePath = path.join(logsDir, logFileName);
+        fs.writeFile(logFilePath, renderedOutput, (err) => {
+            if (err) {
+                console.error('Error writing log file:', err);
+            }
+            else {
+                console.log(`Session logged to ${path.relative(process.cwd(), logFilePath)}`);
+            }
+            process.exit(exitCode);
+        });
+    }, 500); // 500ms delay
+});
+process.on('SIGINT', () => {
+    term.kill('SIGINT');
+});
+process.on('resize', () => {
+    term.resize(process.stdout.columns, process.stdout.rows);
+    xterm.resize(process.stdout.columns, process.stdout.rows);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "ai-cli-log",
+  "version": "1.0.0",
+  "description": "Seamlessly log your AI-powered coding conversations. This command-line interface (CLI) tool captures your terminal   interactions with AI models like Gemini and Claude, saving entire sessions as clean Markdown documents for easy   review and documentation.",
+  "main": "dist/index.js",
+  "bin": {
+    "ai-cli-log": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alingse/ai-cli-log.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/alingse/ai-cli-log/issues"
+  },
+  "homepage": "https://github.com/alingse/ai-cli-log#readme",
+  "devDependencies": {
+    "@types/node": "^24.0.10",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "@xterm/headless": "^5.5.0",
+    "node-pty": "^1.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,95 @@
+import * as pty from 'node-pty';
+import * as fs from 'fs';
+import * as path from 'path';
+import { Terminal } from '@xterm/headless';
+
+const args = process.argv.slice(2);
+const command = args[0];
+const commandArgs = args.slice(1);
+
+if (!command) {
+  console.error('Usage: ai-cli-log <command> [args...]');
+  process.exit(1);
+}
+
+const logsDir = path.join(process.cwd(), '.ai-cli-logs');
+if (!fs.existsSync(logsDir)) {
+  fs.mkdirSync(logsDir);
+}
+
+// Initialize xterm.js in headless mode
+const xterm = new Terminal({
+  rows: process.stdout.rows,
+  cols: process.stdout.columns,
+  scrollback: Infinity, // Set scrollback to Infinity for unlimited buffer
+  allowProposedApi: true,
+});
+
+const term = pty.spawn(command, commandArgs, {
+  name: 'xterm-color',
+  cols: process.stdout.columns,
+  rows: process.stdout.rows,
+  cwd: process.cwd(),
+  env: process.env as { [key: string]: string; },
+});
+
+// Pipe pty output to xterm.js and also to stdout
+term.onData((data) => {
+  process.stdout.write(data);
+  xterm.write(data);
+});
+
+// Pipe stdin to pty
+process.stdin.on('data', (data) => {
+  term.write(data.toString());
+});
+
+process.stdin.setRawMode(true);
+process.stdin.resume();
+
+term.onExit(({ exitCode, signal }) => {
+  // Add a small delay to ensure xterm.js has processed all output
+  setTimeout(() => {
+    // Extract rendered text from xterm.js buffer
+    let renderedOutput = '';
+    // Iterate over the entire buffer, including scrollback.
+    // The total number of lines is the sum of lines in scrollback (baseY) and visible rows.
+    for (let i = 0; i < xterm.buffer.active.baseY + xterm.rows; i++) {
+      const line = xterm.buffer.active.getLine(i);
+      if (line) {
+        // translateToString(true) gets the line content, and we trim trailing whitespace.
+        const lineText = line.translateToString(true).replace(/\s+$/, '');
+        renderedOutput += lineText + '\n';
+      }
+    }
+
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = (now.getMonth() + 1).toString().padStart(2, '0');
+    const day = now.getDate().toString().padStart(2, '0');
+    const hours = now.getHours().toString().padStart(2, '0');
+    const minutes = now.getMinutes().toString().padStart(2, '0');
+    const seconds = now.getSeconds().toString().padStart(2, '0');
+    const prefix = command || 'session';
+    const logFileName = `${prefix}-${year}${month}${day}-${hours}${minutes}${seconds}.md`;
+    const logFilePath = path.join(logsDir, logFileName);
+
+    fs.writeFile(logFilePath, renderedOutput, (err: NodeJS.ErrnoException | null) => {
+      if (err) {
+        console.error('Error writing log file:', err);
+      } else {
+        console.log(`Session logged to ${path.relative(process.cwd(), logFilePath)}`);
+      }
+      process.exit(exitCode);
+    });
+  }, 500); // 500ms delay
+});
+
+process.on('SIGINT', () => {
+  term.kill('SIGINT');
+});
+
+process.on('resize', () => {
+  term.resize(process.stdout.columns, process.stdout.rows);
+  xterm.resize(process.stdout.columns, process.stdout.rows);
+});

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "es2018",
+    "module": "commonjs",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}