<feed xmlns='http://www.w3.org/2005/Atom'>
<title>dotemacs/docs/design/gptel-tools-shortlist.org, branch load-graph-classify-start</title>
<subtitle>My Emacs configuration
</subtitle>
<id>https://git.cjennings.net/dotemacs/atom?h=load-graph-classify-start</id>
<link rel='self' href='https://git.cjennings.net/dotemacs/atom?h=load-graph-classify-start'/>
<link rel='alternate' type='text/html' href='https://git.cjennings.net/dotemacs/'/>
<updated>2026-05-16T07:04:51+00:00</updated>
<entry>
<title>docs(gptel): add shortlist design doc for additional gptel tools</title>
<updated>2026-05-16T07:04:51+00:00</updated>
<author>
<name>Craig Jennings</name>
<email>c@cjennings.net</email>
</author>
<published>2026-05-16T07:04:51+00:00</published>
<link rel='alternate' type='text/html' href='https://git.cjennings.net/dotemacs/commit/?id=19240036f89422dcaba3f0e3c3a822c92b0f35c1'/>
<id>urn:sha1:19240036f89422dcaba3f0e3c3a822c92b0f35c1</id>
<content type='text'>
The Gptel Work project asked for a survey of published gptel tools
with adopt / skip / defer decisions per candidate.  I can't do a
live community-tool survey from this session, so the doc covers
the candidates the task body called out plus a few obvious
adjacents.

Decisions:

- ADOPT (7): `search_in_files`, `git_status` / `git_log` /
  `git_diff` (three tools), `web_fetch`, `search_emacs_help`,
  `find_file_by_name`, `take_screenshot`.  Each gets a sketch in
  the doc -- args, validation posture, implementation outline.
- DEFER (2): `run_shell_command` (huge surface, click-fatigue
  risk; the ADOPT-bucket tools cover most legit use cases),
  `org_capture` (needs UX design for template pre-fill and the
  round-trip).
- SKIP (1): `eval_elisp` (code execution from a model is too
  dangerous even with confirm-each-call).

The doc also lists three follow-ups: the live community survey
that this session couldn't do, per-tool implementation sub-tasks
to be filed under the next iteration of Gptel Work, and a
sandboxing-convention decision for `web_fetch` (allowlist of
outbound URLs vs description-only warning).

Three open questions at the bottom of the doc for review:
build-all-at-once vs paired stages, `fd` as a hard dep vs `find`
fallback, Hyprland-only screenshot vs Wayland-generic via a
portal.

Closes the Gptel Work PROJECT for this iteration -- all 9 in-scope
sub-tasks landed this session.
</content>
</entry>
</feed>
