ai-chat-cleaner 0.0.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jing Haihan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# ai-chat-cleaner
+
+[![npm version][npm-version-src]][npm-version-href]
+[![bundle][bundle-src]][bundle-href]
+[![JSDocs][jsdocs-src]][jsdocs-href]
+[![License][license-src]][license-href]
+
+Clean and remove AI chat with an interactive terminal UI.
+
+```sh
+npx ai-chat-cleaner
+```
+
+- Supported agents:
+  - `codex`
+
+> [!WARNING]
+> Please restart your AI coding tool after deletion.
+>
+> It is recommended to clean history while Codex is not running, to avoid duplicate writes.
+
+## Why ?
+
+I am not entirely sure why `Codex` and `Claude Code` do not provide a way to delete a specific conversation history, perhaps to preserve context continuity.
+
+But in practice, one conversation that goes in the wrong direction can keep affecting later outputs, so I built this tool.
+
+## License
+
+[MIT](./LICENSE) License © [jinghaihan](https://github.com/jinghaihan)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/ai-chat-cleaner?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/ai-chat-cleaner
+[npm-downloads-src]: https://img.shields.io/npm/dm/ai-chat-cleaner?style=flat&colorA=080f12&colorB=1fa669
+[npm-downloads-href]: https://npmjs.com/package/ai-chat-cleaner
+[bundle-src]: https://img.shields.io/bundlephobia/minzip/ai-chat-cleaner?style=flat&colorA=080f12&colorB=1fa669&label=minzip
+[bundle-href]: https://bundlephobia.com/result?p=ai-chat-cleaner
+[license-src]: https://img.shields.io/badge/license-MIT-blue.svg?style=flat&colorA=080f12&colorB=1fa669
+[license-href]: https://github.com/jinghaihan/ai-chat-cleaner/LICENSE
+[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
+[jsdocs-href]: https://www.jsdocs.io/package/ai-chat-cleaner

package/bin/cli.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict'
+import '../dist/cli.mjs'

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,200 @@
+import process from "node:process";
+import * as p from "@clack/prompts";
+import c from "ansis";
+import { cac } from "cac";
+import { execFile } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import { promisify } from "node:util";
+import pLimit from "p-limit";
+import { join } from "pathe";
+import { rimraf } from "rimraf";
+import { homedir } from "node:os";
+import { glob } from "tinyglobby";
+
+//#region src/utils.ts
+const exec = promisify(execFile);
+async function readJSON(filepath) {
+	const content = await readFile(filepath, "utf-8");
+	return JSON.parse(content);
+}
+async function writeJSON(filepath, data) {
+	await writeFile(filepath, JSON.stringify(data, null, 2), "utf-8");
+}
+function formatRelativeTime(date) {
+	const diff = (/* @__PURE__ */ new Date(date * 1e3)).getTime() - Date.now();
+	const seconds = Math.round(diff / 1e3);
+	const minutes = Math.round(seconds / 60);
+	const hours = Math.round(minutes / 60);
+	const days = Math.round(hours / 24);
+	const months = Math.round(days / 30);
+	const years = Math.round(days / 365);
+	const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
+	if (Math.abs(seconds) < 60) return rtf.format(seconds, "second");
+	if (Math.abs(minutes) < 60) return rtf.format(minutes, "minute");
+	if (Math.abs(hours) < 24) return rtf.format(hours, "hour");
+	if (Math.abs(days) < 30) return rtf.format(days, "day");
+	if (Math.abs(months) < 12) return rtf.format(months, "month");
+	return rtf.format(years, "year");
+}
+function quoteSqlString(value) {
+	return `'${value.replaceAll("'", "''")}'`;
+}
+
+//#endregion
+//#region package.json
+var name = "ai-chat-cleaner";
+var version = "0.0.0-alpha.0";
+
+//#endregion
+//#region src/constants.ts
+const NAME = name;
+const VERSION = version;
+const DEFAULT_OPTIONS = {};
+const AGENTS = { codex: {
+	name: "codex",
+	path: join(homedir(), ".codex")
+} };
+
+//#endregion
+//#region src/codex/constants.ts
+const GLOBAL_STATE_PATH = join(AGENTS.codex.path, ".codex-global-state.json");
+const HISTORY_FILE_PATH = join(AGENTS.codex.path, "history.jsonl");
+const SHELL_SNAPSHOTS_PATH = join(AGENTS.codex.path, "shell_snapshots");
+
+//#endregion
+//#region src/codex/db.ts
+async function readSQLite(filepath) {
+	const { stdout } = await exec("sqlite3", [
+		"-json",
+		filepath,
+		"SELECT * FROM threads;"
+	]);
+	return JSON.parse(stdout.trim());
+}
+async function writeSQLite(filepath, ids) {
+	if (ids.length === 0) return;
+	await exec("sqlite3", [filepath, `DELETE FROM threads WHERE id IN (${ids.map(quoteSqlString).join(", ")});`]);
+}
+async function getDatabasePath(cwd) {
+	return (await glob("state_*.sqlite", {
+		cwd,
+		absolute: true,
+		onlyFiles: true
+	})).filter((file) => /state_\d+\.sqlite$/i.test(file)).sort((a, b) => extractVersion(b) - extractVersion(a))[0] || null;
+}
+function extractVersion(path) {
+	const matched = path.match(/state_(\d+)\.sqlite$/i);
+	if (!matched) return 0;
+	const version = Number.parseInt(matched[1], 10);
+	return Number.isFinite(version) ? version : 0;
+}
+
+//#endregion
+//#region src/codex/delete.ts
+async function deleteThread(thread) {
+	const id = thread.id;
+	await rimraf(thread.rollout_path);
+	await rimraf(join(SHELL_SNAPSHOTS_PATH, `${id}.sh`));
+}
+async function deleteThreads({ threads, globalState, sqlitePath }) {
+	const threadIds = new Set(threads.map((thread) => thread.id));
+	const limit = pLimit(5);
+	await Promise.all(threads.map((thread) => limit(() => deleteThread(thread))));
+	updateGlobalState(threadIds, globalState);
+	await updateHistory(HISTORY_FILE_PATH, Array.from(threadIds));
+	if (sqlitePath) await writeSQLite(sqlitePath, Array.from(threadIds));
+}
+async function updateGlobalState(threadIds, globalState) {
+	for (const id of threadIds) delete globalState["thread-titles"].titles[id];
+	globalState["thread-titles"].order = globalState["thread-titles"].order.filter((id) => !threadIds.has(id));
+	await writeJSON(GLOBAL_STATE_PATH, globalState);
+}
+async function updateHistory(path, ids) {
+	const remove = new Set(ids);
+	const rows = (await readFile(path, "utf8")).split("\n").filter(Boolean).map((line) => JSON.parse(line)).filter((row) => !remove.has(row?.session_id));
+	await writeFile(HISTORY_FILE_PATH, rows.length > 0 ? `${rows.map((row) => JSON.stringify(row)).join("\n")}\n` : "", "utf-8");
+}
+
+//#endregion
+//#region src/codex/detect.ts
+async function detectCodex(cwd = AGENTS.codex.path) {
+	const globalState = await readJSON(GLOBAL_STATE_PATH);
+	const sqlitePath = await getDatabasePath(cwd);
+	const data = sqlitePath ? await readSQLite(sqlitePath) : [];
+	const titles = globalState["thread-titles"].titles;
+	return {
+		threads: data.filter((i) => i.title || i.id in titles).sort((a, b) => a.updated_at > b.updated_at ? -1 : 1).map((thread) => {
+			const title = titles[thread.id] || normalizeTitle(thread);
+			return {
+				...thread,
+				title
+			};
+		}),
+		globalState,
+		sqlitePath
+	};
+}
+function normalizeTitle(thread) {
+	return thread.title.replace(/\n/g, " ").replace(thread.cwd, "").replace(AGENTS.codex.path, "").trim();
+}
+
+//#endregion
+//#region src/codex/index.ts
+async function promptCodex(_options) {
+	const { threads, globalState, sqlitePath } = await detectCodex();
+	const resolved = await p.multiselect({
+		message: `found ${c.yellow`${threads.length}`} threads`,
+		options: threads.map((thread) => ({
+			label: thread.title,
+			hint: formatRelativeTime(thread.updated_at || thread.created_at),
+			value: thread
+		}))
+	});
+	if (p.isCancel(resolved)) {
+		p.outro(c.red("aborting"));
+		process.exit(1);
+		return;
+	}
+	await deleteThreads({
+		threads: resolved,
+		globalState,
+		sqlitePath
+	});
+	p.outro(`cleaned ${c.yellow`${resolved.length}`} threads`);
+}
+
+//#endregion
+//#region src/config.ts
+function normalizeConfig(options) {
+	if ("default" in options) options = options.default;
+	return options;
+}
+async function resolveConfig(options) {
+	const defaults = structuredClone(DEFAULT_OPTIONS);
+	options = normalizeConfig(options);
+	return {
+		...defaults,
+		...options
+	};
+}
+
+//#endregion
+//#region src/cli.ts
+try {
+	const cli = cac(NAME);
+	cli.command("", "Clean and remove AI chat with an interactive terminal UI").allowUnknownOptions().action(async (options) => {
+		p.intro(`${c.yellow`${NAME} `}${c.dim`v${VERSION}`}`);
+		const config = await resolveConfig(options);
+		p.log.info(`start detecting ${c.yellow`Codex`} threads...`);
+		await promptCodex(config);
+	});
+	cli.help();
+	cli.version(VERSION);
+	cli.parse();
+} catch (error) {
+	console.error(error);
+	process.exit(1);
+}
+
+//#endregion
+export {  };

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+//#region src/constants.d.ts
+declare const AGENTS_CHOICES: readonly ["codex"];
+//#endregion
+//#region src/types.d.ts
+interface CommandOptions {
+  cwd?: string;
+}
+type AgentType = typeof AGENTS_CHOICES[number];
+interface AgentConfig {
+  name: string;
+  path: string;
+}
+//#endregion
+//#region src/index.d.ts
+declare function defineConfig(config: Partial<CommandOptions>): Partial<CommandOptions>;
+//#endregion
+export { AgentConfig, AgentType, CommandOptions, defineConfig };

package/dist/index.mjs

@@ -0,0 +1,7 @@
+//#region src/index.ts
+function defineConfig(config) {
+	return config;
+}
+
+//#endregion
+export { defineConfig };

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "ai-chat-cleaner",
+  "type": "module",
+  "version": "0.0.0-alpha.0",
+  "description": "Clean and remove AI chat with an interactive terminal UI.",
+  "author": "jinghaihan",
+  "license": "MIT",
+  "homepage": "https://github.com/jinghaihan/ai-chat-cleaner#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jinghaihan/ai-chat-cleaner.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jinghaihan/ai-chat-cleaner/issues"
+  },
+  "keywords": [],
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./cli": "./dist/cli.mjs",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "ai-chat-cleaner": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "ansis": "^4.2.0",
+    "cac": "^7.0.0",
+    "p-limit": "^7.3.0",
+    "pathe": "^2.0.3",
+    "rimraf": "^6.1.3",
+    "tinyglobby": "^0.2.15"
+  },
+  "devDependencies": {
+    "tsdown": "^0.20.3",
+    "bumpp": "^10.4.1",
+    "pncat": "^0.10.4",
+    "simple-git-hooks": "^2.13.1",
+    "taze": "^19.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "@octohash/eslint-config": "^0.2.4",
+    "eslint": "^10.0.2",
+    "lint-staged": "^16.3.0",
+    "vitest": "^4.0.18",
+    "@types/node": "^25.3.2"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  },
+  "scripts": {
+    "start": "tsx ./src/cli.ts",
+    "build": "tsdown",
+    "deps": "taze major -I",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "release": "bumpp",
+    "bootstrap": "pnpm install"
+  }
+}