@liuyoumi/codex-history 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.4.0 - 2026-05-29
+
+### Added
+
+- Allow `purge` to select regular conversations with `--cwd`, `--grep`, and `--archived` filters.
+
 ## 0.3.0 - 2026-05-29
 
 ### Added

package/README.en.md

@@ -52,6 +52,8 @@ codex-history list
 codex-history list --grep "Astro"
 codex-history purge 019e6885
 codex-history purge 019e6885 019e6874
+codex-history purge --cwd /Users/me/Projects/example
+codex-history purge --grep "Astro"
 codex-history purge-orphans
 ```
 
@@ -77,6 +79,8 @@ Type 019e6885 to confirm:
 | `codex-history list` | List local conversations. |
 | `codex-history list --grep <keyword>` | Filter conversations by title, id, or cwd. |
 | `codex-history purge <id...>` | Remove one or more resolved local conversations after confirmation. |
+| `codex-history purge --cwd <path>` | Remove local conversations matching a working directory after confirmation. |
+| `codex-history purge --grep <keyword>` | Remove local conversations matching title, id, or cwd after confirmation. |
 | `codex-history purge-orphans` | Remove orphaned local data after confirmation. |
 
 ### `doctor`
@@ -139,11 +143,23 @@ codex-history purge 019e6885 019e6874
 
 When multiple targets are provided, the tool resolves all targets and prints a batch plan before deletion. If any id is missing, ambiguous, or active, the whole batch is refused before mutation. Interactive batch purge requires typing `purge-selected`.
 
+You can also select local conversations with filters:
+
+```bash
+codex-history purge --cwd /Users/me/Projects/example
+codex-history purge --grep "Astro"
+codex-history purge --archived
+codex-history purge --cwd /Users/me/Projects/example --grep "Astro"
+```
+
+`--cwd`, `--grep`, and `--archived` can be combined. Combined filters delete only conversations that match every provided condition. By default, filter mode matches non-archived conversations only; use `--archived` to target archived conversations. Filtered purge prints a batch plan and requires typing `purge-selected`. Filters cannot be combined with explicit ids.
+
 For scripts or non-interactive shells, use `--force`:
 
 ```bash
 codex-history purge 019e6885 --force
 codex-history purge 019e6885 019e6874 --force
+codex-history purge --cwd /Users/me/Projects/example --force
 ```
 
 `--force` skips only interactive confirmation. It still keeps schema validation, active-thread protection, and post-purge verification.

package/README.md

@@ -52,6 +52,8 @@ codex-history list
 codex-history list --grep "Astro"
 codex-history purge 019e6885
 codex-history purge 019e6885 019e6874
+codex-history purge --cwd /Users/me/Projects/example
+codex-history purge --grep "Astro"
 codex-history purge-orphans
 ```
 
@@ -77,6 +79,8 @@ Type 019e6885 to confirm:
 | `codex-history list` | 列出本地对话。 |
 | `codex-history list --grep <keyword>` | 按标题、id 或 cwd 过滤对话。 |
 | `codex-history purge <id...>` | 确认后删除一条或多条解析到的本地对话。 |
+| `codex-history purge --cwd <path>` | 确认后删除匹配工作目录的本地对话。 |
+| `codex-history purge --grep <keyword>` | 确认后删除匹配标题、id 或 cwd 的本地对话。 |
 | `codex-history purge-orphans` | 确认后清理本地孤儿数据。 |
 
 ### `doctor`
@@ -139,11 +143,23 @@ codex-history purge 019e6885 019e6874
 
 删除多个目标时，工具会先解析全部目标并展示批量计划；只要任意一个 id 不存在、不唯一，或命中 active thread，整个批量操作都会拒绝执行，不会部分删除。交互式批量删除需要输入 `purge-selected` 确认。
 
+也可以直接用过滤条件选择要删除的本地对话：
+
+```bash
+codex-history purge --cwd /Users/me/Projects/example
+codex-history purge --grep "Astro"
+codex-history purge --archived
+codex-history purge --cwd /Users/me/Projects/example --grep "Astro"
+```
+
+`--cwd`、`--grep`、`--archived` 可以组合，组合后只删除同时满足全部条件的对话。默认只匹配未归档对话；如果要删除已归档对话，请使用 `--archived`。过滤式删除会展示批量计划，并要求输入 `purge-selected` 确认。过滤条件不能和 id 同时使用。
+
 脚本或非交互环境可以使用 `--force`：
 
 ```bash
 codex-history purge 019e6885 --force
 codex-history purge 019e6885 019e6874 --force
+codex-history purge --cwd /Users/me/Projects/example --force
 ```
 
 `--force` 只跳过交互确认，不会跳过数据结构校验、active thread 保护和删除后的验证。

package/dist/cli.js

@@ -853,11 +853,35 @@ function planBatchPurgeCommand(paths, threadIds) {
   }
   return {
     mode: "planned",
+    source: "explicit",
     requestedCount: threadIds.length,
     plans,
     duplicateInputs
   };
 }
+function planFilteredPurgeCommand(paths, filters) {
+  validateSupportedDataModel(paths);
+  if (!hasPurgeFilter(filters)) {
+    throw new UsageError("Provide thread id(s) or at least one filter such as --cwd, --grep, or --archived.");
+  }
+  const listOptions = {
+    cwd: filters.cwd,
+    grep: filters.grep,
+    archived: filters.archived
+  };
+  const targets = listThreads(paths, listOptions);
+  return {
+    mode: "planned",
+    source: "filtered",
+    requestedCount: targets.length,
+    plans: targets.map((target) => buildPurgePlan(paths, target)),
+    filters,
+    duplicateInputs: []
+  };
+}
+function hasPurgeFilter(filters) {
+  return Boolean(filters.cwd || filters.grep || filters.archived);
+}
 function executePurgePlanCommand(paths, plan) {
   validateSupportedDataModel(paths);
   return executePurge(paths, plan);
@@ -1130,12 +1154,29 @@ program.command("list").description("List local Codex conversations.").option("-
     )
   )
 );
-program.command("purge").argument("<threadIds...>", "Codex thread id(s) or unique short id prefix(es) to purge").option("--force", "Skip interactive confirmation").description("Purge local Codex conversation(s) after target confirmation.").action(
+program.command("purge").argument("[threadIds...]", "Codex thread id(s) or unique short id prefix(es) to purge").option("--force", "Skip interactive confirmation").option("--cwd <path>", "Filter conversations by exact working directory").option("--grep <keyword>", "Filter conversations by title, id, or cwd keyword").option("--archived", "Filter archived conversations").description("Purge local Codex conversation(s) after target confirmation.").action(
   (threadIds, options) => runCommand(async () => {
     const paths = currentPaths();
-    const plan = planBatchPurgeCommand(paths, threadIds);
+    const requestedThreadIds = threadIds ?? [];
+    const filters = {
+      cwd: options.cwd,
+      grep: options.grep,
+      archived: Boolean(options.archived)
+    };
+    const hasExplicitTargets = requestedThreadIds.length > 0;
+    const hasFilters = hasPurgeFilter(filters);
+    if (hasExplicitTargets && hasFilters) {
+      throw new UsageError("Thread ids cannot be combined with --cwd, --grep, or --archived.");
+    }
+    if (!hasExplicitTargets && !hasFilters) {
+      throw new UsageError("Provide thread id(s) or at least one filter such as --cwd, --grep, or --archived.");
+    }
+    const plan = hasExplicitTargets ? planBatchPurgeCommand(paths, requestedThreadIds) : planFilteredPurgeCommand(paths, filters);
     const force = Boolean(options.force);
-    const useBatchConfirmation = plan.requestedCount > 1;
+    const useBatchConfirmation = plan.source === "filtered" || plan.requestedCount > 1;
+    if (plan.plans.length === 0) {
+      return "No matching local Codex conversations found.";
+    }
     if (plan.plans.length === 1 && !useBatchConfirmation) {
       if (!force) {
         await confirmPurge(plan.plans[0]);
@@ -1343,7 +1384,7 @@ function formatBatchPurgeResult(result) {
     colorize("green", "Batch purge executed."),
     "",
     "Summary:",
-    `- Requested targets: ${result.plan.requestedCount}`,
+    `- Selection: ${formatBatchPurgeSelection(result.plan)}`,
     `- Unique targets purged: ${result.plan.plans.length}`,
     `- Duplicate inputs skipped: ${result.plan.duplicateInputs.length}`,
     `- SQLite row changes: ${sqliteChanges.reduce((sum, change) => sum + change.rows, 0)}`,
@@ -1424,7 +1465,7 @@ function formatBatchPurgeConfirmation(plan) {
   return [
     "About to purge selected local Codex conversations:",
     "",
-    `Requested targets: ${plan.requestedCount}`,
+    `Selection: ${formatBatchPurgeSelection(plan)}`,
     `Unique targets: ${plan.plans.length}`,
     `Duplicate inputs skipped: ${plan.duplicateInputs.length}`,
     "",
@@ -1436,6 +1477,25 @@ function formatBatchPurgeConfirmation(plan) {
     ""
   ].join("\n");
 }
+function formatBatchPurgeSelection(plan) {
+  if (plan.source === "explicit") {
+    return `${plan.requestedCount} requested target(s)`;
+  }
+  return formatPurgeFilters(plan.filters ?? {});
+}
+function formatPurgeFilters(filters) {
+  const parts = [];
+  if (filters.cwd) {
+    parts.push(`cwd=${filters.cwd}`);
+  }
+  if (filters.grep) {
+    parts.push(`grep=${filters.grep}`);
+  }
+  if (filters.archived) {
+    parts.push("archived=true");
+  }
+  return parts.length > 0 ? parts.join(", ") : "filtered conversations";
+}
 function formatPurgeOrphansConfirmation(plan) {
   return [
     "About to purge orphaned local Codex data:",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liuyoumi/codex-history",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI for listing and safely purging local Codex conversation history",
   "type": "module",
   "bin": {