Skip to content

docs: say in the README what termit refuses to do - #27

Merged
tkc merged 1 commit into
mainfrom
readme-philosophy
Sep 10, 2026
Merged

docs: say in the README what termit refuses to do#27
tkc merged 1 commit into
mainfrom
readme-philosophy

Conversation

@tkc

@tkc tkc commented Sep 10, 2026

Copy link
Copy Markdown
Owner

The README opened with the feature list and never stated the rules that produced it. This writes them down.

The three rules, now in ## Why

  • Only what the work needs — a feature has to be something this way of working does not function without. The short list is on purpose.
  • A terminal, and nothing more — spawn processes, relay the pty, interpret escape sequences, draw. No conversation management, no driving an agent, no workflows. It is also the reason the agent-specific parts (fork, resume) are a string in the config rather than code in here.
  • Measured, not asserted — the lighter option wins, and every speed claim points at a reproducible number, including the ones that were tried and rejected for measuring worse.

## Not goals now says why those things are out — each is either a second way to do what the left pane already does, or a job for a program you run inside a terminal — instead of just listing them.

Corrections while in there

  • Hyperlinks (OSC 8) was still listed as no; it has been supported since Open OSC 8 hyperlinks #21.
  • Added Synchronized output (?2026), which the parser handles and agent UIs use, to the capability table.
  • Linked docs/references/performance-techniques.md and docs/references/scrollback.md from the design notes.
  • The size and latency figures now cite the section of docs/performance.md they come from; the binary size stays rounded rather than quoted to a decimal that drifts every build.

No feature text was added: the philosophy section replaces the old "Not a framework" bullet rather than sitting next to it.

🤖 Generated with Claude Code

https://claude.ai/code/session_01GvMacYD6T9EoWqc7C247Hr

The README opened with the feature list and never stated the rules that
produced it. Rewrite the Why section around the three that actually
decide changes: only what the work needs, a terminal and nothing more,
and measured rather than asserted. Not goals now says why those things
are out -- each is either a second way to do what the left pane does, or
a job for a program running inside a terminal.

Also correct the capability table: OSC 8 hyperlinks have been supported
since #21 but were still listed as no, and synchronized output (?2026),
which the parser handles, was missing. Link the two reference documents
under docs/references from the design notes, and cite the section the
size and latency figures come from.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GvMacYD6T9EoWqc7C247Hr
@tkc
tkc merged commit 6a810a9 into main Sep 10, 2026
1 check passed
@tkc
tkc deleted the readme-philosophy branch September 10, 2026 02:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant