Configuration
Thomas Forgione edited this page 2026-09-15 12:05:56 +02:00

Page revisions

13 Commits

Author SHA1 Message Date
7b6a4d2b66
Document the context gauge on the bottom bar 2026-09-15 12:05:56 +02:00
567c602051
Document the web tools and the [searxng] table 2026-09-15 11:35:04 +02:00
febf58700a
Describe a call being written, and the answers it takes
A tool call is shown as it arrives now, so there is something to say about
watching one. The prompt is a list rather than four letters, there is no
longer an answer that refuses for good, and a tool that has stopped working
is worth knowing to look for in config.toml.
2026-09-11 12:22:38 +02:00
97b02ac1af
Say there is no round limit, and document write_file
max_rounds is configurable and signed, negative meaning no ceiling, which is
the default. Ctrl-C is what stops a turn instead. And the third disk tool
writes.
2026-09-11 11:41:30 +02:00
996f3f513f
Describe the tools papote has, and being asked about them
Three tools now rather than one, two of which read the disk and therefore
stop and ask. Says what the prompt looks like, what each key does, that Esc
is an answer, and how to set the permissions up in advance under [tools].
2026-09-11 11:25:19 +02:00
916e37ef31
Say what the colours on the bar mean
Grey for something that happened, amber for something that did not, red for
something that failed -- and the new warning key in theme.toml.
2026-09-11 10:59:19 +02:00
5645b93f42
Thinking is on by default now
The configuration and usage pages said it was off, and why it was not worth
turning on. Both now say what it is for, and that turning it off is for a
small context.
2026-09-11 09:50:15 +02:00
3b8cd475f3
Document thinking, and the boxes around the asides
A Thinking section on the usage page: what is shown while a model reasons,
that it stays in the conversation, that its tokens count, and that keeping it
costs no context. The tools example gains its boxes too. The configuration
page no longer says turning thinking on buys nothing, and the limitations
page no longer says it is dropped — what remains is that it cannot be folded
away.
2026-09-11 09:47:48 +02:00
c39d32f348
Document tool calling
A Tools section on the usage page: what a tool is for, what the two muted
lines in the conversation are, the one tool there is, the five-round guard,
and the `tools` key with the `--jinja` caveat that makes it worth having.
The configuration page gains the key, and the dependency page the two crates
behind the clock.
2026-09-11 09:38:15 +02:00
baac378d9b
Document walking the candidates with Tab
The Completion section now covers what each press does, the highlight on the
bar and the `selection` colour behind it, Shift-Tab, the list scrolling
rather than being cut, and how to settle a candidate or go into a directory
you cycled onto. The keys table and the theme key list follow.
2026-09-10 21:30:11 +02:00
387d9e0fa9
Document conversation names and /rename 2026-09-10 17:21:31 +02:00
58b444369f
Use example.com in the examples, as RFC 2606 reserves it
example.fr is somebody's domain; example.com is set aside for exactly this.
2026-09-10 17:12:51 +02:00
21a9383bdf
Split the README's detail across nine pages, with a sidebar
The README had grown to 279 lines and buried the point under a full
configuration reference. It keeps the pitch, the example and a quick start;
everything else moves here, one page per thing you might actually be looking
for.

_Sidebar.md gives every page the same three-section column: getting started,
using it, under the hood.
2026-09-10 17:09:02 +02:00