spiracha 1.5.0 → 2.0.0

package/apps/ui/src/styles.css

@@ -0,0 +1,122 @@
+@import url("https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=IBM+Plex+Sans:wght@400;500;600;700&display=swap");
+@import "tailwindcss";
+@plugin '@tailwindcss/typography';
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+:root {
+    --background: #f4f5f6;
+    --foreground: #161a1f;
+    --panel: rgba(255, 255, 255, 0.9);
+    --panel-secondary: rgba(245, 246, 248, 0.95);
+    --panel-foreground: #161a1f;
+    --muted-foreground: #5e6772;
+    --border: rgba(16, 24, 40, 0.12);
+    --accent: #365d8d;
+    --accent-foreground: #ffffff;
+    --accent-muted: rgba(54, 93, 141, 0.08);
+    --destructive: #a93d34;
+    --destructive-foreground: #fff8f7;
+    --success: #2d6a4f;
+    --warning: #aa6b17;
+    --code-background: #f0f2f4;
+    --code-foreground: #1c252f;
+    --panel-shadow: 0 14px 28px rgba(9, 14, 22, 0.04);
+    --radius: 1rem;
+}
+
+.dark {
+    --background: #101418;
+    --foreground: #eef3f7;
+    --panel: rgba(20, 25, 31, 0.88);
+    --panel-secondary: rgba(28, 34, 42, 0.95);
+    --panel-foreground: #eef3f7;
+    --muted-foreground: #99a3af;
+    --border: rgba(203, 213, 225, 0.12);
+    --accent: #84a6ce;
+    --accent-foreground: #e4eef9;
+    --accent-muted: rgba(132, 166, 206, 0.12);
+    --destructive: #d06e64;
+    --destructive-foreground: #1f0906;
+    --success: #6ab085;
+    --warning: #e2ae5e;
+    --code-background: #12181e;
+    --code-foreground: #d8e2ec;
+    --panel-shadow: 0 20px 34px rgba(0, 0, 0, 0.22);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--panel);
+  --color-card-foreground: var(--panel-foreground);
+  --color-popover: var(--panel);
+  --color-popover-foreground: var(--panel-foreground);
+  --color-primary: var(--accent);
+  --color-primary-foreground: var(--accent-foreground);
+  --color-secondary: var(--panel-secondary);
+  --color-secondary-foreground: var(--foreground);
+  --color-muted: var(--panel-secondary);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent-muted);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--border);
+  --color-ring: var(--accent);
+  --radius-sm: calc(var(--radius) - 6px);
+  --radius-md: calc(var(--radius) - 4px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 6px);
+  --font-sans: 'IBM Plex Sans', system-ui, sans-serif;
+  --font-mono: 'IBM Plex Mono', ui-monospace, monospace;
+}
+
+html,
+body,
+#app {
+    min-height: 100%;
+}
+
+html {
+    background: var(--background);
+}
+
+body {
+    margin: 0;
+    background:
+        radial-gradient(circle at top left, rgba(54, 93, 141, 0.08), transparent 28%),
+        radial-gradient(circle at bottom right, rgba(33, 54, 81, 0.06), transparent 25%), var(--background);
+    color: var(--foreground);
+    font-family: var(--font-sans);
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+}
+
+* {
+    box-sizing: border-box;
+}
+
+a {
+    color: inherit;
+    text-decoration: none;
+}
+
+button,
+input,
+select,
+textarea {
+    font: inherit;
+}
+
+code,
+pre,
+[data-mono="true"] {
+    font-family: var(--font-mono);
+}
+
+::selection {
+    background: rgba(54, 93, 141, 0.16);
+}

package/apps/ui/tsconfig.json

@@ -0,0 +1,29 @@
+{
+    "compilerOptions": {
+        "allowImportingTsExtensions": true,
+        "jsx": "react-jsx",
+        "lib": ["ESNext", "DOM", "DOM.Iterable"],
+        "module": "ESNext",
+
+        /* Bundler mode */
+        "moduleResolution": "bundler",
+        "noEmit": true,
+        "noFallthroughCasesInSwitch": true,
+        "noUncheckedSideEffectImports": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "paths": {
+            "@/*": ["./src/*"],
+            "@spiracha/*": ["../../src/*"],
+            "#/*": ["./src/*"]
+        },
+
+        /* Linting */
+        "skipLibCheck": true,
+        "strict": true,
+        "target": "ESNext",
+        "types": ["vite/client"],
+        "verbatimModuleSyntax": true
+    },
+    "include": ["**/*.ts", "**/*.tsx"]
+}

package/apps/ui/vite.config.ts

@@ -0,0 +1,84 @@
+import { createReadStream } from 'node:fs';
+import { access, constants } from 'node:fs/promises';
+import path from 'node:path';
+import tailwindcss from '@tailwindcss/vite';
+import { devtools } from '@tanstack/devtools-vite';
+import { tanstackStart } from '@tanstack/react-start/plugin/vite';
+import viteReact from '@vitejs/plugin-react';
+import { defineConfig, type Plugin } from 'vite';
+import { buildUiExportContentDisposition, resolveUiExportFilePathFromRequestPath } from '../../src/lib/ui-export-files';
+
+const getExportContentType = (filePath: string) => {
+    if (filePath.endsWith('.zip')) {
+        return 'application/zip';
+    }
+
+    if (filePath.endsWith('.md')) {
+        return 'text/markdown; charset=utf-8';
+    }
+
+    if (filePath.endsWith('.txt')) {
+        return 'text/plain; charset=utf-8';
+    }
+
+    return 'application/octet-stream';
+};
+
+const spirachaExportFiles = (): Plugin => {
+    return {
+        configureServer(server) {
+            server.middlewares.use(async (req, res, next) => {
+                if (!req.url) {
+                    next();
+                    return;
+                }
+
+                const exportFilePath = resolveUiExportFilePathFromRequestPath(
+                    new URL(req.url, 'http://spiracha.local').pathname,
+                );
+                if (!exportFilePath) {
+                    next();
+                    return;
+                }
+
+                try {
+                    await access(exportFilePath, constants.R_OK);
+                } catch {
+                    res.statusCode = 404;
+                    res.end('Not Found');
+                    return;
+                }
+
+                res.setHeader('Cache-Control', 'no-store');
+                res.setHeader('Content-Disposition', buildUiExportContentDisposition(exportFilePath));
+                res.setHeader('Content-Type', getExportContentType(exportFilePath));
+                res.statusCode = 200;
+
+                if (req.method === 'HEAD') {
+                    res.end();
+                    return;
+                }
+
+                createReadStream(exportFilePath).pipe(res);
+            });
+        },
+        name: 'spiracha-export-files',
+    };
+};
+
+const config = defineConfig({
+    plugins: [spirachaExportFiles(), devtools(), tailwindcss(), tanstackStart(), viteReact()],
+    resolve: {
+        alias: {
+            '@spiracha': path.resolve(__dirname, '..', '..', 'src'),
+        },
+        tsconfigPaths: true,
+    },
+    server: {
+        fs: {
+            allow: [path.resolve(__dirname, '..', '..')],
+        },
+    },
+});
+
+export default config;

package/bin/spiracha.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env bun
+import path from 'node:path';
+import process from 'node:process';
+
+export type SpirachaDevServerCommand = {
+    args: string[];
+    cwd: string;
+};
+
+export const resolveSpirachaPackageRoot = (binDir = import.meta.dir): string => path.resolve(binDir, '..');
+
+export const buildSpirachaDevServerCommand = (packageRoot = resolveSpirachaPackageRoot()): SpirachaDevServerCommand => ({
+    args: ['--bun', 'vite', 'dev', '--host', '127.0.0.1', '--port', process.env.PORT || '3000'],
+    cwd: path.join(packageRoot, 'apps', 'ui'),
+});
+
+export const runSpirachaDevServer = async (): Promise<number> => {
+    const command = buildSpirachaDevServerCommand();
+    const proc = Bun.spawn([process.execPath, ...command.args], {
+        cwd: command.cwd,
+        env: process.env,
+        stderr: 'inherit',
+        stdin: 'inherit',
+        stdout: 'inherit',
+    });
+
+    return proc.exited;
+};
+
+if (import.meta.main) {
+    process.exitCode = await runSpirachaDevServer();
+}

package/package.json

@@ -4,32 +4,40 @@
         "url": "https://github.com/ragaeeb"
     },
     "bin": {
-        "codex-chats": "./bin/codex-chats.js",
-        "codex-chats-claude": "./bin/codex-chats-claude.js",
-        "spiracha": "./bin/spiracha.js"
+        "spiracha": "./bin/spiracha.ts"
     },
     "bugs": {
         "url": "https://github.com/ragaeeb/spiracha/issues"
     },
     "dependencies": {
-        "@inquirer/prompts": "^8.5.2",
-        "@modelcontextprotocol/sdk": "^1.29.0",
+        "@tailwindcss/typography": "0.5.20",
+        "@tailwindcss/vite": "4.3.1",
+        "@tanstack/devtools-vite": "0.7.0",
+        "@tanstack/match-sorter-utils": "8.19.4",
+        "@tanstack/react-devtools": "0.10.5",
         "@tanstack/react-query": "5.101.0",
+        "@tanstack/react-query-devtools": "5.101.0",
         "@tanstack/react-router": "1.170.15",
+        "@tanstack/react-router-devtools": "1.167.0",
         "@tanstack/react-router-ssr-query": "1.167.1",
+        "@tanstack/react-start": "1.168.25",
         "@tanstack/react-table": "8.21.3",
         "@tanstack/react-virtual": "3.14.2",
+        "@tanstack/router-plugin": "1.168.18",
+        "@vitejs/plugin-react": "6.0.2",
         "class-variance-authority": "0.7.1",
         "clsx": "2.1.1",
-        "iconv-lite": "^0.7.2",
         "lucide-react": "1.18.0",
         "radix-ui": "1.5.0",
         "react": "19.2.7",
         "react-dom": "19.2.7",
         "tailwind-merge": "3.6.0",
+        "tailwindcss": "4.3.1",
+        "tw-animate-css": "1.4.0",
+        "vite": "8.0.16",
         "zod": "4.4.3"
     },
-    "description": "Export local Codex, Claude Code, and Cursor transcripts, and browse Codex, Claude Code, Kiro, Cursor, Antigravity, and OpenCode history through a local UI.",
+    "description": "Browse and expose local Codex, Claude Code, Kiro, Qoder, Cursor, Antigravity, and OpenCode conversation history through a local UI and stable data API.",
     "devDependencies": {
         "@types/bun": "^1.3.14",
         "@types/node": "^25.9.3",
@@ -38,66 +46,34 @@
     "engines": {
         "bun": ">=1.3.14"
     },
+    "exports": {
+        ".": {
+            "import": "./src/client.ts",
+            "types": "./src/client.ts"
+        },
+        "./client": {
+            "import": "./src/client.ts",
+            "types": "./src/client.ts"
+        },
+        "./types": {
+            "import": "./src/lib/conversation-data/types.ts",
+            "types": "./src/lib/conversation-data/types.ts"
+        }
+    },
     "files": [
-        "bin/codex-chats.js",
-        "bin/codex-chats-claude.js",
-        "bin/spiracha.js",
-        "src/export-chats.ts",
-        "src/export-claude.ts",
-        "src/export-cursor.ts",
-        "src/mcp-server.ts",
-        "src/spiracha.ts",
-        "src/ui-cli.ts",
-        "src/lib/antigravity-db.ts",
-        "src/lib/antigravity-exporter-types.ts",
-        "src/lib/antigravity-keychain.ts",
-        "src/lib/claude-code-db.ts",
-        "src/lib/claude-code-exporter-types.ts",
-        "src/lib/claude-code-transcript-phase.ts",
-        "src/lib/claude-code-transcript.ts",
-        "src/lib/claude-exporter.ts",
-        "src/lib/cursor-db.ts",
-        "src/lib/cursor-exporter.ts",
-        "src/lib/cursor-exporter-types.ts",
-        "src/lib/cursor-recovery.ts",
-        "src/lib/cursor-transcript.ts",
-        "src/lib/kiro-db.ts",
-        "src/lib/kiro-exporter-types.ts",
-        "src/lib/kiro-transcript-phase.ts",
-        "src/lib/kiro-transcript.ts",
-        "src/lib/opencode-db.ts",
-        "src/lib/opencode-exporter-types.ts",
-        "src/lib/opencode-transcript-phase.ts",
-        "src/lib/opencode-think-tags.ts",
-        "src/lib/opencode-transcript.ts",
-        "src/lib/codex-exporter-cli.ts",
-        "src/lib/codex-exporter-db.ts",
-        "src/lib/codex-exporter-transcript.ts",
-        "src/lib/codex-exporter-types.ts",
-        "src/lib/codex-exporter.ts",
-        "src/lib/codex-browser-db.ts",
-        "src/lib/codex-browser-export.ts",
-        "src/lib/codex-browser-types.ts",
-        "src/lib/codex-thread-recovery.ts",
-        "src/lib/codex-thread-cache.ts",
-        "src/lib/codex-thread-parser.ts",
-        "src/lib/codex-analytics.ts",
-        "src/lib/concurrency.ts",
-        "src/lib/path-transforms.ts",
-        "src/lib/sqlite-error.ts",
-        "src/lib/sqlite-retry.ts",
-        "src/lib/ui-export-archive.ts",
-        "src/lib/ui-export-files.ts",
-        "src/lib/ui-cache.ts",
-        "src/lib/interactive-cli.ts",
-        "src/lib/model-label.ts",
-        "src/lib/native-open.ts",
-        "src/lib/shared.ts",
-        "apps/ui/dist/client/assets/**/*",
-        "apps/ui/dist/client/icon.svg",
-        "apps/ui/dist/client/manifest.json",
-        "apps/ui/dist/client/robots.txt",
-        "apps/ui/dist/server/**/*",
+        "bin/spiracha.ts",
+        "apps/ui/components.json",
+        "apps/ui/package.json",
+        "apps/ui/public/**/*",
+        "apps/ui/src/**/*",
+        "!apps/ui/src/**/*.vitest.ts",
+        "!apps/ui/src/**/*.vitest.tsx",
+        "apps/ui/tsconfig.json",
+        "apps/ui/vite.config.ts",
+        "src/client.ts",
+        "src/lib/**/*.ts",
+        "!src/lib/**/*.test.ts",
+        "!src/lib/*-test-helpers.ts",
         "README.md",
         "AGENTS.md"
     ],
@@ -106,11 +82,12 @@
         "codex",
         "claude",
         "kiro",
+        "qoder",
         "cursor",
         "antigravity",
         "opencode",
         "transcripts",
-        "export",
+        "api",
         "markdown",
         "bun"
     ],
@@ -126,20 +103,16 @@
         "coverage": "bun run coverage:root && bun run coverage:ui",
         "coverage:root": "bun test --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run ./src/coverage-check.ts root",
         "coverage:ui": "bun run --cwd apps/ui coverage && bun run ./src/coverage-check.ts ui",
-        "export:claude": "bun run ./src/export-claude.ts",
         "format": "biome check . --write && biome lint . --write",
         "lint": "biome check .",
-        "mcp": "bun run ./src/mcp-server.ts",
-        "smoke:package-ui": "bun run ./src/package-ui-smoke.ts",
-        "start": "bun run ./src/export-chats.ts",
+        "start": "bun run --cwd apps/ui dev",
         "typecheck": "bun run typecheck:root && bun run typecheck:ui",
         "typecheck:root": "bunx tsc --noEmit",
         "typecheck:ui": "bun run --cwd apps/ui typecheck",
-        "ui:dev": "bun run --cwd apps/ui dev",
         "ui:preview": "bun run --cwd apps/ui preview"
     },
     "type": "module",
-    "version": "1.5.0",
+    "version": "2.0.0",
     "workspaces": [
         "apps/*"
     ]