takotrace 0.0.1

package/DEVELOPMENT.md

@@ -0,0 +1,37 @@
+# Development
+
+## Requirements
+
+- Node.js 22+
+- Codex, Claude Code, or both
+
+## Run locally
+
+```bash
+npm install
+npm run dev
+```
+
+The web app and local server reload while you edit source files.
+
+## Checks
+
+```bash
+npm test
+npm run typecheck
+npm run build
+```
+
+Read [TECHNICAL_DESIGN.md](./TECHNICAL_DESIGN.md) for the architecture, data model, provider behavior, and current boundaries.
+
+## Publish to npm
+
+The [`Publish to npm`](./.github/workflows/publish.yml) workflow runs when a GitHub Release is published.
+
+1. Create an npm granular access token that can publish `takotrace`.
+2. Add it to the GitHub repository as an Actions secret named `NPM_TOKEN`.
+3. Update `version` in `package.json` and `package-lock.json` with `npm version <patch|minor|major> --no-git-tag-version`.
+4. Commit and push the version change.
+5. Create a GitHub Release whose tag is exactly `v<version>`, for example `v0.1.0`.
+
+The workflow rejects mismatched tags, runs the full verification suite, builds the package, and publishes it with npm provenance.

package/PRODUCT.md

@@ -0,0 +1,33 @@
+# Product
+
+## Register
+
+product
+
+## Users
+
+开发者和 Agent 工作流设计者在本机运行、调试与回顾 Agent 会话时使用。TakoTrace 当前同时接入 Codex 与 Claude，并通过统一的 Provider 层为其他本地 Agent 保留扩展空间。
+
+## Product Purpose
+
+TakoTrace 将分散的会话、用户请求、Agent 响应、工具调用、Skill、MCP 与 Subagent 活动组织成可快速浏览和深入检查的本地界面。成功意味着用户能迅速定位目标会话，理解一次交互的完整执行路径，并在需要时查看精确的底层事件与原始数据。
+
+## Brand Personality
+
+克制、精确、高密度。界面应像可靠的开发工具：信息丰富但不喧闹，熟悉而高效，并对运行状态保持诚实。蓝色章鱼吉祥物通过多触手映射并行执行链，以放大镜表达 Trace 与检查能力；友好的品牌形象与克制的工具界面形成清晰层次。
+
+## Anti-references
+
+避免装饰性仪表盘、卡片堆叠、过多状态文字、无意义的形状与颜色、夸张动效，以及为了展示技术而增加的交互复杂度。不要把 Codex 专有概念固化成无法扩展到其他 Agent 的产品结构。
+
+## Design Principles
+
+1. 会话优先：用户请求与 Agent 响应是主线，工具和编排活动作为可追溯的辅助层。
+2. 渐进披露：列表保持紧凑，完整内容、元数据和原始数据按需展开。
+3. 语义胜过装饰：颜色、图形和状态只在表达真实差异时使用。
+4. 熟悉且可预测：遵循成熟开发工具和 Vercel 界面的交互惯例。
+5. 面向多 Agent：数据模型、命名与布局不依赖单一 Agent 实现。
+
+## Accessibility & Inclusion
+
+以 WCAG AA 为基线，支持键盘操作、可见焦点、足够的文字与状态对比度，并尊重减少动态效果偏好。状态不能只依赖颜色表达。

package/README.md

@@ -0,0 +1,69 @@
+<p align="center">
+  <img src="./assets/takotrace-logo.png" alt="TakoTrace logo" width="160" />
+</p>
+
+<h1 align="center">TakoTrace</h1>
+
+<p align="center">Inspect Codex and Claude Code sessions as timelines, sequence diagrams, and raw events.</p>
+
+<p align="center">
+  <a href="https://github.com/zhaofinger/takotrace/stargazers"><img src="https://img.shields.io/github/stars/zhaofinger/takotrace?style=flat&logo=github" alt="GitHub stars" /></a>
+  <img src="https://img.shields.io/badge/Node.js-22%2B-339933?logo=node.js&logoColor=white" alt="Node.js 22+" />
+  <img src="https://img.shields.io/badge/providers-Codex%20%2B%20Claude-2563eb" alt="Codex and Claude support" />
+  <img src="https://img.shields.io/badge/storage-local--first-0f766e" alt="Local-first storage" />
+</p>
+
+<p align="center"><a href="./README.zh-CN.md">中文</a></p>
+
+TakoTrace turns local AI coding sessions into a browsable execution trace. Follow the user request, agent reasoning, commands, file changes, MCP calls, skills, and subagents without digging through rollout files or terminal logs.
+
+## Quick start
+
+Requires Node.js 22+ and Codex, Claude Code, or both.
+
+```bash
+npx takotrace
+```
+
+TakoTrace listens on `127.0.0.1:4317`, starts the available providers, and opens the browser.
+
+```bash
+# Start one provider
+npx takotrace --provider codex
+npx takotrace --provider claude
+
+# Select a Codex binary
+npx takotrace --codex-path /path/to/codex
+
+# Change the port and keep the browser closed
+npx takotrace --port 4400 --no-open
+```
+
+Run `npx takotrace --help` for every CLI option.
+
+## What you can inspect
+
+- Sessions grouped by provider and working directory.
+- Each run as a Trace, Sequence diagram, or Raw JSON.
+- Commands, file changes, MCP calls, skills, and subagent relationships.
+- Token usage, Markdown, attachments, images, and local source files.
+- Codex history recovered read-only from local rollout files when App Server decoding fails.
+
+TakoTrace uses **Session**, **Run**, and **Step** in the UI. Raw APIs keep the original provider field names.
+
+## Data and security
+
+TakoTrace binds to loopback by default, keeps runtime state in memory, and adds no telemetry or remote session storage. Codex rollout fallback and Claude history access are read-only. Provider authentication stays with Codex or Claude Code.
+
+> [!WARNING]
+> The local API has no general authentication layer. Do not expose it directly to a LAN or the public internet, including with `--host 0.0.0.0`.
+
+## Documentation
+
+- [Technical design](./TECHNICAL_DESIGN.md)
+- [Product principles](./PRODUCT.md)
+- [Development guide](./DEVELOPMENT.md)
+
+<p align="center">
+  <a href="https://github.com/zhaofinger/takotrace"><img src="./assets/star-takotrace.gif" alt="If TakoTrace is useful, star the repository" width="600" /></a>
+</p>

package/README.zh-CN.md

@@ -0,0 +1,69 @@
+<p align="center">
+  <img src="./assets/takotrace-logo.png" alt="TakoTrace Logo" width="160" />
+</p>
+
+<h1 align="center">TakoTrace</h1>
+
+<p align="center">用时间线、时序图和原始事件查看 Codex 与 Claude Code 会话。</p>
+
+<p align="center">
+  <a href="https://github.com/zhaofinger/takotrace/stargazers"><img src="https://img.shields.io/github/stars/zhaofinger/takotrace?style=flat&logo=github" alt="GitHub Stars" /></a>
+  <img src="https://img.shields.io/badge/Node.js-22%2B-339933?logo=node.js&logoColor=white" alt="Node.js 22+" />
+  <img src="https://img.shields.io/badge/Provider-Codex%20%2B%20Claude-2563eb" alt="支持 Codex 与 Claude" />
+  <img src="https://img.shields.io/badge/存储-本地优先-0f766e" alt="本地优先" />
+</p>
+
+<p align="center"><a href="./README.md">English</a></p>
+
+TakoTrace 把本地 AI 编程会话整理成可浏览的执行轨迹。用户请求、Agent 推理、命令、文件修改、MCP 调用、Skill 和 Subagent 都集中在一个界面，不必再翻 rollout 文件或终端日志。
+
+## 快速开始
+
+需要 Node.js 22+，并安装 Codex、Claude Code，或同时安装两者。
+
+```bash
+npx takotrace
+```
+
+TakoTrace 默认监听 `127.0.0.1:4317`，启动可用的 Provider 并打开浏览器。
+
+```bash
+# 只启动一个 Provider
+npx takotrace --provider codex
+npx takotrace --provider claude
+
+# 指定 Codex 路径
+npx takotrace --codex-path /path/to/codex
+
+# 修改端口且不自动打开浏览器
+npx takotrace --port 4400 --no-open
+```
+
+运行 `npx takotrace --help` 查看全部参数。
+
+## 可以查看什么
+
+- 按 Provider 和工作目录分组的 Session。
+- 每个 Run 的 Trace、Sequence 和 Raw JSON。
+- 命令、文件修改、MCP 调用、Skill 与 Subagent 关系。
+- Token 用量、Markdown、附件、图片和本地源文件。
+- Codex App Server 解码失败时，从本地 rollout 文件只读恢复历史。
+
+界面使用 **Session**、**Run**、**Step**，Raw API 保留 Provider 的原始字段名。
+
+## 数据与安全
+
+TakoTrace 默认只绑定 loopback，运行状态保存在内存中，不增加遥测或远程会话存储。Codex rollout 回退与 Claude 历史访问均为只读，登录和认证仍由 Codex 或 Claude Code 负责。
+
+> [!WARNING]
+> 本地 API 没有通用认证层。不要将它直接暴露到局域网或公网，包括使用 `--host 0.0.0.0`。
+
+## 文档
+
+- [技术设计](./TECHNICAL_DESIGN.md)
+- [产品原则](./PRODUCT.md)
+- [本地开发](./DEVELOPMENT.md)
+
+<p align="center">
+  <a href="https://github.com/zhaofinger/takotrace"><img src="./assets/star-takotrace.gif" alt="如果 TakoTrace 对你有用，欢迎点亮 Star" width="600" /></a>
+</p>

package/TECHNICAL_DESIGN.md

@@ -0,0 +1,46 @@
+# TakoTrace 技术设计
+
+## 目标
+
+TakoTrace 是一个通过 `npx takotrace` 启动的本地服务，用网页观察 Codex 与 Claude Agent 会话，并实时追踪 Run、工具调用和执行状态。
+
+## 架构
+
+```text
+Browser <-- HTTP + SSE --> TakoTrace --> Codex adapter --> stdio JSONL --> codex app-server
+                               |             +-- read-only fallback --> rollout JSONL
+                               |
+                               +--------> Claude adapter --> Agent SDK / ~/.claude sessions
+```
+
+- TakoTrace 使用 Node.js/TypeScript 启动 Provider；默认同时管理 `codex app-server` 子进程与 Claude Agent SDK。
+- Provider 适配层解析 Codex JSON-RPC 与 Claude SDK/session 数据，并转换为统一的 trace 事件。
+- 浏览器通过 SSE 接收实时事件，通过 HTTP 获取历史数据和发送操作。
+- 首版数据保存在内存中，暂不引入数据库。
+
+## 数据模型
+
+```text
+Thread
+└── Turn
+    └── Item: message | tool | command | file_change | approval
+```
+
+每个事件至少包含时间、类型、状态、Thread ID、Turn ID、Item ID 和原始数据。
+
+## 核心流程
+
+1. CLI 启动本地 HTTP 服务和所选 Provider；`--provider all` 默认同时启用 Codex 与 Claude。
+2. Codex adapter 完成 `initialize` / `initialized` 握手，分页调用 `thread/list` 加载历史元数据，并按需调用 `thread/read` 加载完整 Turn/Item 快照；反序列化兼容错误时，只读解析匹配的 rollout JSONL 恢复历史。
+3. Claude adapter 从 `~/.claude` 读取历史 session 与 transcript；受管 Run 通过 Agent SDK 的 `query()` 启动或恢复，并将 SDK 消息归一化为统一事件。
+4. 两侧 Provider 持续同步历史快照和实时通知，由服务按 Provider ownership 隔离 Session、搜索、Run 与详情数据。
+5. 网页按当前 Codex / Claude Tab 和工作目录分组展示 Session；主时间线以 Run 为单位，将用户消息、Agent 执行和最终回复聚合为一行。
+6. `/api/state` 与 SSE 只传 compact item；选中 Run 时，再通过详情接口加载受长度保护的 raw 数据。
+
+## 首版边界
+
+- 精确实时通知仅覆盖当前 TakoTrace 实例管理的会话；外部 Codex 与 Claude 历史会话通过周期同步提供可能滞后的近实时快照。
+- 默认只绑定 `127.0.0.1`，不开放远程访问。
+- 不修改 Codex 私有会话文件；rollout JSONL 仅作为 `thread/read` 兼容失败时的 best-effort 只读回退，不作为主协议。
+- 不提供 claude.ai 登录，也不读取、存储或回显 Provider 凭据。
+- 对未知事件保留原始数据并安全忽略，兼容协议扩展。

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import type { ProviderSelection } from './shared/types.js';
+import type { TraceProvider } from './server/provider.js';
+interface CliOptions {
+    host: string;
+    port: number;
+    open: boolean;
+    help: boolean;
+    provider: ProviderSelection;
+    codexPath?: string;
+    claudePath?: string;
+}
+export declare function parseArgs(args: string[]): CliOptions;
+export declare function createProvider(options: CliOptions): TraceProvider;
+export {};

package/dist/cli.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import { realpathSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CodexClient } from './server/codex-client.js';
+import { resolveCodexCommand } from './server/codex-command.js';
+import { ClaudeClient } from './server/claude-client.js';
+import { TakoTraceServer } from './server/http-server.js';
+import { MultiProvider } from './server/multi-provider.js';
+const HELP = `Usage: takotrace [options]
+
+Options:
+  --host <host>  Bind host (default: 127.0.0.1)
+  --port <port>  Bind port (default: 4317)
+  --provider <codex|claude|all>  Agent providers (default: all)
+  --codex-path <path>  Codex executable path (overrides automatic selection)
+  --claude-path <path>  Claude Code executable path for managed sessions
+  --no-open      Do not open the browser
+  --help         Show this help
+`;
+export function parseArgs(args) {
+    const options = { host: '127.0.0.1', port: 4317, open: true, help: false, provider: 'all' };
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === '--help' || argument === '-h')
+            options.help = true;
+        else if (argument === '--no-open')
+            options.open = false;
+        else if (argument === '--host')
+            options.host = requireValue(args, ++index, '--host');
+        else if (argument.startsWith('--host='))
+            options.host = argument.slice('--host='.length);
+        else if (argument === '--port')
+            options.port = parsePort(requireValue(args, ++index, '--port'));
+        else if (argument.startsWith('--port='))
+            options.port = parsePort(argument.slice('--port='.length));
+        else if (argument === '--provider')
+            options.provider = parseProvider(requireValue(args, ++index, '--provider'));
+        else if (argument.startsWith('--provider='))
+            options.provider = parseProvider(argument.slice('--provider='.length));
+        else if (argument === '--codex-path')
+            options.codexPath = requireValue(args, ++index, '--codex-path');
+        else if (argument.startsWith('--codex-path='))
+            options.codexPath = argument.slice('--codex-path='.length);
+        else if (argument === '--claude-path')
+            options.claudePath = requireValue(args, ++index, '--claude-path');
+        else if (argument.startsWith('--claude-path='))
+            options.claudePath = argument.slice('--claude-path='.length);
+        else
+            throw new Error(`Unknown option: ${argument}`);
+    }
+    return options;
+}
+export function createProvider(options) {
+    if (options.provider === 'codex')
+        return new CodexClient({ command: options.codexPath });
+    const claude = new ClaudeClient({ pathToClaudeCodeExecutable: options.claudePath });
+    if (options.provider === 'claude')
+        return claude;
+    return new MultiProvider({ providers: [new CodexClient({ command: options.codexPath }), claude] });
+}
+async function main() {
+    let options;
+    try {
+        options = parseArgs(process.argv.slice(2));
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : error}\n\n${HELP}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (options.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (options.provider !== 'claude') {
+        const selected = resolveCodexCommand({ explicitPath: options.codexPath });
+        options.codexPath = selected.command;
+        process.stdout.write(`Codex command: source=${selected.source} version=${selected.version ?? 'unknown'} command=${selected.command}\n`);
+    }
+    const provider = createProvider(options);
+    const staticDir = join(dirname(fileURLToPath(import.meta.url)), 'web');
+    const server = new TakoTraceServer(provider, { host: options.host, port: options.port, staticDir });
+    server.attachProvider(provider);
+    let address;
+    try {
+        address = await server.listen();
+    }
+    catch (error) {
+        await provider.stop();
+        throw error;
+    }
+    const url = `http://${formatHost(address.host)}:${address.port}`;
+    process.stdout.write(`TakoTrace listening on ${url}\n`);
+    if (options.open)
+        openBrowser(url);
+    try {
+        const initialized = await provider.start();
+        server.store.setConnection('connected', {
+            provider: initialized.provider,
+            userAgent: initialized.userAgent ?? (initialized.provider === 'all'
+                ? 'codex + claude'
+                : initialized.provider === 'claude' ? 'claude-agent-sdk' : 'codex app-server'),
+        });
+    }
+    catch (error) {
+        server.store.setConnection('error', { error: error instanceof Error ? error.message : String(error) });
+        await server.close();
+        await provider.stop();
+        throw error;
+    }
+    const shutdown = async () => {
+        await server.close();
+        await provider.stop();
+    };
+    process.once('SIGINT', () => void shutdown().then(() => process.exit(0)));
+    process.once('SIGTERM', () => void shutdown().then(() => process.exit(0)));
+}
+function requireValue(args, index, option) {
+    const value = args[index];
+    if (!value || value.startsWith('--'))
+        throw new Error(`${option} requires a value`);
+    return value;
+}
+function parsePort(value) {
+    const port = Number(value);
+    if (!Number.isInteger(port) || port < 0 || port > 65_535)
+        throw new Error(`Invalid port: ${value}`);
+    return port;
+}
+function parseProvider(value) {
+    if (value === 'codex' || value === 'claude' || value === 'all')
+        return value;
+    throw new Error(`Invalid provider: ${value} (expected codex, claude or all)`);
+}
+function formatHost(host) {
+    return host.includes(':') ? `[${host}]` : host;
+}
+function openBrowser(url) {
+    const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
+    const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+    child.unref();
+}
+if (process.argv[1] && fileURLToPath(import.meta.url) === realpathSync(process.argv[1])) {
+    main().catch((error) => {
+        process.stderr.write(`takotrace: ${error instanceof Error ? error.message : error}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/server/claude-client.d.ts

@@ -0,0 +1,63 @@
+import { type Options as ClaudeQueryOptions, type Query, type SDKSessionInfo, type SessionMessage } from '@anthropic-ai/claude-agent-sdk';
+import type { TraceInput, TraceProvider } from './provider.js';
+export interface ClaudeSdk {
+    listSessions(options?: {
+        dir?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<SDKSessionInfo[]>;
+    getSessionInfo(sessionId: string, options?: {
+        dir?: string;
+    }): Promise<SDKSessionInfo | undefined>;
+    getSessionMessages(sessionId: string, options?: {
+        dir?: string;
+        limit?: number;
+        offset?: number;
+        includeSystemMessages?: boolean;
+    }): Promise<SessionMessage[]>;
+    query(params: {
+        prompt: string;
+        options?: ClaudeQueryOptions;
+    }): Query;
+}
+export interface ClaudeClientOptions {
+    dir?: string;
+    pathToClaudeCodeExecutable?: string;
+    historyRefreshMs?: number;
+    historyThreadLimit?: number;
+    historyMessagesLimit?: number;
+    sdk?: ClaudeSdk;
+}
+export declare class ClaudeClient implements TraceProvider {
+    readonly providerId: "claude";
+    private readonly emitter;
+    private readonly options;
+    private readonly sdk;
+    private historyTimer?;
+    private historySync?;
+    private started;
+    private busy;
+    private readonly sessionByThread;
+    private pendingThreadId?;
+    constructor(options?: ClaudeClientOptions);
+    start(): Promise<{
+        provider: 'claude';
+        userAgent?: string;
+    }>;
+    stop(): Promise<void>;
+    onTrace(listener: (event: TraceInput) => void): () => void;
+    onHistory(listener: (threads: unknown[], replace: boolean, provider?: 'claude') => void): () => void;
+    onError(listener: (error: Error) => void): () => void;
+    refreshHistory(): Promise<void>;
+    private fetchHistory;
+    startThread(params?: Record<string, unknown>): Promise<unknown>;
+    resumeThread(threadId: string, params?: Record<string, unknown>): Promise<unknown>;
+    startTurn(threadId: string, text: string, params?: Record<string, unknown>): Promise<unknown>;
+    private emitTrace;
+    private emitUserMessage;
+    private emitAssistantMessage;
+    private emitResult;
+    private rememberSession;
+}
+export declare function sessionToHistory(session: SDKSessionInfo, messages: SessionMessage[]): unknown;
+export declare function messagesToTurns(sessionId: string, messages: SessionMessage[]): Array<Record<string, unknown>>;