aboutsummaryrefslogtreecommitdiff
path: root/todo.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-16 02:00:19 -0500
committerCraig Jennings <c@cjennings.net>2026-05-16 02:00:19 -0500
commit3f50f682053dd31d5fac96ecdf2b98aad1ce56d7 (patch)
treee87cdc207cba893ac68ad6dcbbff8da17fbe8232 /todo.org
parent6ee37e0a68d31909861cf59684d3601bf40f5abe (diff)
downloaddotemacs-3f50f682053dd31d5fac96ecdf2b98aad1ce56d7.tar.gz
dotemacs-3f50f682053dd31d5fac96ecdf2b98aad1ce56d7.zip
feat(ai-conversations-browser): dired-style browser for saved GPTel conversations
`cj/gptel-load-conversation` prompts via `completing-read`. A dedicated browser shows what each conversation is about at a glance and supports single-key load / delete / rename without having to scroll a minibuffer list. New module `modules/ai-conversations-browser.el` + `cj/gptel-browse-conversations` entry point bound to `C-; a b` ("browse conversations"). Opens `*GPTel-Conversations*` in `cj/gptel-browser-mode` (a `special-mode` derivative). Each row shows date, time, topic slug, and a preview of the most recent message (length configurable via `cj/gptel-browser-preview-length`, default 60 chars). Rows sort newest first. In the browser: - `RET` / `l`: load the conversation (delegates to `cj/gptel-load-conversation` with the file pre-selected via a `cl-letf` stub on `completing-read` so the user isn't prompted twice), then bury the window. - `d`: delete the file under point after `y-or-n-p` confirmation, re-render. - `r`: rename the file under point. Preserves the timestamp, slugifies the new topic, refuses unchanged input and existing targets. - `g`: refresh. - `n` / `p`: next / previous row. - `q`: quit-window. 21 tests cover the helpers (topic parsing, header stripping, preview shaping for truncate / short / empty cases, row-for-file with conversation + non-conversation filenames, rows enumeration, render output for empty + populated cases, newest-first sort, rename-target preservation of timestamp + slug, rename-target error on missing timestamp) and the file-touching actions (delete with y, cancel with n, rename, rename-on-empty-line error).
Diffstat (limited to 'todo.org')
-rw-r--r--todo.org40
1 files changed, 35 insertions, 5 deletions
diff --git a/todo.org b/todo.org
index c59b41ab..99103f13 100644
--- a/todo.org
+++ b/todo.org
@@ -2718,11 +2718,41 @@ errors when no previous, excludes the current directive from the
re-pick prompt). =gptel-rewrite= stubbed for tests so no rewrite
UI fires.
-*** TODO [#B] Saved-conversations browser :feature:
-
-=cj/gptel-load-conversation= prompts via =completing-read=. A browser buffer (dired-style) showing topic, timestamp, and last-message preview, with single-key bindings to load / delete / rename in-place, would be a markedly better interface than the completing-read prompt.
-
-Priority bumped from [#C] to [#B] and the "defer until ≥20 conversations" hold lifted on 2026-05-15 -- the browser is the preferred entry point; build it now rather than wait for prompt friction to force the issue.
+*** 2026-05-16 Sat @ 01:59:44 -0500 Built the saved-conversations browser
+
+New module =modules/ai-conversations-browser.el= +
+=cj/gptel-browse-conversations= entry point bound to =C-; a b=
+(which-key labelled "browse conversations"). Opens a dired-style
+=*GPTel-Conversations*= buffer in =cj/gptel-browser-mode= (a
+=special-mode= derivative).
+
+Each row shows date, time, topic slug, and a preview of the most
+recent message (configurable length via
+=cj/gptel-browser-preview-length=, default 60 chars). Rows sort
+newest first.
+
+Bindings in the browser:
+- =RET= / =l=: load the conversation (delegates to
+ =cj/gptel-load-conversation= with the file pre-selected via a
+ =cl-letf= stub on =completing-read= so the user isn't prompted
+ twice), then bury the browser window.
+- =d=: delete the file under point after =y-or-n-p= confirmation,
+ re-render.
+- =r=: rename the file under point; preserves the timestamp,
+ slugifies the new topic, refuses unchanged input and existing
+ targets.
+- =g=: refresh.
+- =n= / =p=: next / previous row.
+- =q=: quit-window.
+
+21 tests in =tests/test-ai-conversations-browser.el= cover the
+helpers (topic parsing, header stripping, preview shaping for
+truncate / short / empty cases, row-for-file with both
+conversation and non-conversation filenames, rows enumeration,
+render output for empty and populated cases, newest-first sort,
+rename-target preservation of timestamp + slug, rename-target
+error on missing timestamp) and the file-touching actions (delete
+with y, cancel with n, rename, rename-on-empty-line error).
*** 2026-05-16 Sat @ 01:46:55 -0500 Added cj/gptel-quick-ask one-shot command