hx-cli 0.1.9__tar.gz → 0.2.0__tar.gz

{hx_cli-0.1.9 → hx_cli-0.2.0}/CHANGELOG.md

@@ -28,6 +28,71 @@ the project follows [semantic versioning](https://semver.org/).
 
 ---
 
+## [0.2.0] - 2026-09-14
+
+### Changed
+
+- The interface is drawn into your terminal's own scrollback instead of taking
+  over the screen. Finished output belongs to the terminal: scroll it, select
+  it with the mouse, copy it, pipe it, and it is still there after HX exits.
+  `/fullscreen` takes the whole window back for anyone who preferred it that
+  way - the prompt pinned to the bottom row, the transcript scrolling above it
+  with `pgup`, `pgdn`, `ctrl+home` and `ctrl+end` - and writes the choice to
+  `tui.fullscreen` for the next session. On either screen the prompt and the
+  status bar sit on the bottom row from the first frame - a conversation that
+  does not fill the window is padded above the dock, not below it, and rows a
+  closing picker gives back open above it too. The slash-command and `@`-path
+  completion lists draw above the prompt for the same reason: under it, every
+  keystroke that changed the number of matches moved the prompt and the status
+  bar with it. Exiting erases the whole interface - banner, conversation and
+  dock - and puts the shell prompt back on the row HX started on, rather than
+  leaving a dead prompt box and a status bar on screen above it, from either
+  screen: quitting out of `/fullscreen` also takes away the frame that was
+  parked underneath it.
+- Approving a tool call is now a framed prompt with one option per line, each
+  saying what it does - `always allow` states that it writes a rule to
+  `.hx/settings.local.json`. `y`/`s`/`a`/`n` still answer in one keystroke,
+  `esc` denies, and the arrow keys work for anyone who wants to read first.
+  The command shown is the one that will run, `$` and all. When two subagents
+  stop at an approval at once, the older one holds the keyboard and the other
+  says it is waiting rather than offering keys that would answer the first.
+- Your theme reaches the whole interface. Links, list bullets, block quotes,
+  horizontal rules and inline code in the model's replies now follow the
+  palette instead of a hard-coded set of colours, and headings are visibly
+  different from each other.
+- Multi-line output from `/help`, `/cost`, `/status` and the rest lines up
+  under its own first line instead of at two different indents.
+- The todo list is a block in the conversation rather than a sidebar, and
+  `/todos` and `ctrl+t` show it. A scrollback-native interface has no second
+  column to put a sidebar in.
+- Mouse selection is the terminal's, across the whole session including what
+  has scrolled off, rather than HX's own within the visible screen.
+- Text HX did not write - a file a tool read, a command's output, the model's
+  reply, a paste into the prompt - is drawn as plain text. Escape sequences in
+  it are removed rather than sent on to your terminal, so a file cannot set
+  your clipboard, rename your window, hide a link behind different words, or
+  erase what is already on screen by being read.
+- `/clear` now clears the screen and the scrollback above it, instead of
+  emptying the transcript and leaving the last session on screen. Terminals
+  that do not implement scrollback erasure - macOS Terminal.app - clear the
+  screen only.
+- `/model`, the command palette and every other picker are sized to the
+  terminal rather than to a fixed eight rows, so a tall window shows a long
+  list instead of leaving two thirds of itself empty.
+- `ctrl+z` suspends HX to the background and resuming redraws it; `ctrl+home`
+  and `ctrl+end` reach the ends of the conversation; `ctrl+_` undoes in the
+  prompt. All three were listed in `/help` and bound to nothing.
+- `ctrl+p` and `ctrl+l` are named in the hints line under the prompt, which is
+  where the keys a session offers are supposed to be discoverable.
+- A block drawn against the prompt no longer closes itself with a second rule,
+  which left a rule, a blank line and another rule under every picker and under
+  every approval. Whichever block ends up against the dock lets the dock's own
+  rule close it, and takes its own back as soon as something lands underneath.
+- The installer now opens with a terminal boot animation that draws and lights
+  the HX mark, with a clean static version for CI and redirected output.
+
+---
+
 ## [0.1.9] - 2026-09-11
 
 ### Changed
@@ -325,7 +390,9 @@ First release, published to PyPI as [`hx-cli`](https://pypi.org/project/hx-cli/)
 - `/configure` and `hx auth` for the OpenRouter key, `hx upgrade` for
   self-update, and `install.sh` bootstrapping uv with a pinned Python.
 
-[Unreleased]: https://github.com/aletisunil/hx/compare/v0.1.8...HEAD
+[Unreleased]: https://github.com/aletisunil/hx/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/aletisunil/hx/compare/v0.1.9...v0.2.0
+[0.1.9]: https://github.com/aletisunil/hx/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/aletisunil/hx/compare/v0.1.7...v0.1.8
 [0.1.7]: https://github.com/aletisunil/hx/compare/v0.1.6...v0.1.7
 [0.1.6]: https://github.com/aletisunil/hx/compare/v0.1.5...v0.1.6

hx_cli-0.1.9/README.md → hx_cli-0.2.0/PKG-INFO

@@ -1,6 +1,42 @@
+Metadata-Version: 2.5
+Name: hx-cli
+Version: 0.2.0
+Summary: HX - a terminal coding agent
+Project-URL: Homepage, https://github.com/aletisunil/hx
+Project-URL: Issues, https://github.com/aletisunil/hx/issues
+Author: Sunil Aleti
+License: MIT
+Keywords: agent,cli,coding-agent,llm,openrouter,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: markdown-it-py>=3.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pygments>=2.17
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: truststore>=0.10
+Requires-Dist: wcwidth>=0.2.13
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pyte>=0.8; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: types-pygments; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Description-Content-Type: text/markdown
+
 # HX
 
-A terminal coding agent. Python core, Textual TUI, OpenRouter for models.
+A terminal coding agent. Python core, its own terminal renderer, OpenRouter for
+models.
 
 HX runs in your project directory, reads and edits your code, runs commands in
 a sandboxed shell, and shows you what every turn costs.
@@ -291,13 +327,13 @@ be rebound (see [Keybindings](#keybindings)).
 | `ctrl+p` | command palette |
 | `ctrl+l` | model picker |
 | `ctrl+o` | expand tool output (also `ctrl+r`) |
-| `ctrl+t` | toggle the todo sidebar |
+| `ctrl+t` | show the current plan |
 | `ctrl+x` | copy the selected message to the clipboard |
 | `ctrl+up` | previous message |
 | `ctrl+down` | next message |
-| `pgup` | scroll the transcript up |
-| `pgdn` | scroll the transcript down |
-| `ctrl+home` | jump to the start of the transcript |
+| `pgup` | scroll the transcript up (fullscreen; otherwise your terminal scrolls) |
+| `pgdn` | scroll the transcript down (fullscreen; otherwise your terminal scrolls) |
+| `ctrl+home` | jump to the start: the viewport in fullscreen, the first message otherwise |
 | `ctrl+end` | jump back to the newest output |
 | `@path` | complete a file path |
 | `!command` | run a shell command directly, no model turn |
@@ -309,7 +345,8 @@ The prompt is a readline-style editor: `ctrl+a`/`ctrl+e` for line start and end,
 `ctrl+b`/`ctrl+f` by character, `alt+b`/`alt+f` by word, `ctrl+w` and `alt+d` to
 kill a word, `ctrl+u` and `ctrl+k` to kill to the start or end of a line, then
 `ctrl+y` to yank it back and `alt+y` to walk further down the kill ring.
-`ctrl+z` undoes, `ctrl+shift+z` redoes.
+`ctrl+_` undoes, `ctrl+shift+z` redoes - `ctrl+z` belongs to the shell, and
+suspends HX.
 
 Typing `/` or `@` opens a completion list above the prompt; `tab` cycles it,
 `enter` accepts, `esc` dismisses.
@@ -364,18 +401,55 @@ than being silently resolved.
 | `/rewind` | go back to an earlier prompt, restoring the files HX changed |
 | `/title [text]` | show or set this session's name |
 | `/prompt` | the system prompt this session is running with |
-| `/todos` | toggle the sidebar |
+| `/todos` | show the current plan |
 | `/skills` | installed skills |
 | `/agents` | subagent types |
 | `/mcp` | server status |
 | `/theme [name]` | `dark`, `light`, `ansi`, or any theme in `~/.hx/themes` |
 | `/queue [steer <n>\|clear]` | messages waiting for the turn to end, and what to do with them |
 | `/copy` | copy the last reply to the clipboard |
+| `/fullscreen [on\|off]` | take the whole window, with the prompt pinned to the bottom |
 | `/mouse [on\|off]` | mouse reporting, and with it your terminal's own text selection |
 | `/init` | generate an `AGENTS.md` for the project |
 | `/help` | list commands and keys |
 | `/quit` | exit (also `/exit`, `/q`) |
 
+### The two screens
+
+By default HX draws into your terminal's own scrollback. Finished output belongs
+to the terminal while the session runs: it scrolls it, selects it, copies it and
+pipes it. Nothing is repainted above the fold, so a long session costs the same
+to draw as a short one.
+
+The prompt and the status bar still open on the bottom row of the window: a
+conversation too short to fill the screen is padded above them rather than
+below, so the dock stays where you last saw it instead of creeping down the
+screen a block at a time. The padding is gone by the time the terminal starts
+scrolling.
+
+Leaving takes the whole interface off the screen: the banner, the conversation
+and the dock are erased and your shell prompt comes back on the row HX started
+on, the terminal as it was found. The erase stops at the top of the window -
+lines that had already scrolled above it stay in your scrollback, because the
+only sequence that reaches them takes everything the terminal remembers,
+including what was there before HX ran. `/clear` is the command that asks for
+that.
+
+`/fullscreen` switches to the alternate screen instead - the whole window, the
+prompt pinned to the bottom row, the transcript scrolling above it with `pgup`,
+`pgdn`, `ctrl+home` and `ctrl+end`. The trade is the thing the default was
+chosen for: the alternate screen is not scrollback, so your terminal cannot
+scroll or select it, and it is gone when HX exits. `/fullscreen off` gives it
+back, and either way the choice is written to `tui.fullscreen` for the next
+session. Quitting from fullscreen leaves the same clean terminal as quitting
+from the default screen: the alternate screen goes, and so does the frame HX
+had drawn underneath it before the switch.
+
+`/clear` wipes the screen and the scrollback above it. Terminals that do not
+implement scrollback erasure - macOS Terminal.app is the one people hit - clear
+the screen only, and the old conversation stays above it until you clear it the
+terminal's own way (`cmd+k`).
+
 ### Selecting and copying text
 
 Drag to select and `ctrl+c` to copy. HX copies through `pbcopy`, `wl-copy` or
@@ -489,7 +563,8 @@ along with the `.hx/.gitignore` it added to hide it.
   },
 
   "tui": {
-    "enterWhileBusy": "queue"         // queue | steer - what enter does mid-turn
+    "enterWhileBusy": "queue",        // queue | steer - what enter does mid-turn
+    "fullscreen": false               // true takes the whole window (see /fullscreen)
   }
 }
 ```
@@ -761,7 +836,8 @@ src/hx/
   permissions/  rule engine, shell decomposition, Seatbelt/bubblewrap
   skills/ agents/ mcp/
   keys.py       keybinding registry: ids, defaults, descriptions, user overrides
-  tui/          Textual app, commands, per-tool renderers, widgets
+  term/         the renderer: raw mode, input decoding, the differ, the screen
+  tui/          views, commands, per-tool renderers, themes
     themes/     the shipped palettes, as JSON
 ```
 

hx_cli-0.1.9/PKG-INFO → hx_cli-0.2.0/README.md

@@ -1,41 +1,7 @@
-Metadata-Version: 2.5
-Name: hx-cli
-Version: 0.1.9
-Summary: HX - a terminal coding agent
-Project-URL: Homepage, https://github.com/aletisunil/hx
-Project-URL: Issues, https://github.com/aletisunil/hx/issues
-Author: Sunil Aleti
-License: MIT
-Keywords: agent,cli,coding-agent,llm,openrouter,tui
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Console
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.11
-Requires-Dist: click>=8.1
-Requires-Dist: httpx>=0.27
-Requires-Dist: pydantic>=2.7
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: rich>=13.7
-Requires-Dist: textual>=0.85
-Requires-Dist: truststore>=0.10
-Provides-Extra: dev
-Requires-Dist: mypy>=1.11; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
-Requires-Dist: pytest-cov>=5.0; extra == 'dev'
-Requires-Dist: pytest-textual-snapshot>=1.0; extra == 'dev'
-Requires-Dist: pytest>=8.2; extra == 'dev'
-Requires-Dist: ruff>=0.6; extra == 'dev'
-Requires-Dist: textual-dev>=1.5; extra == 'dev'
-Requires-Dist: types-pygments; extra == 'dev'
-Requires-Dist: types-pyyaml; extra == 'dev'
-Description-Content-Type: text/markdown
-
 # HX
 
-A terminal coding agent. Python core, Textual TUI, OpenRouter for models.
+A terminal coding agent. Python core, its own terminal renderer, OpenRouter for
+models.
 
 HX runs in your project directory, reads and edits your code, runs commands in
 a sandboxed shell, and shows you what every turn costs.
@@ -326,13 +292,13 @@ be rebound (see [Keybindings](#keybindings)).
 | `ctrl+p` | command palette |
 | `ctrl+l` | model picker |
 | `ctrl+o` | expand tool output (also `ctrl+r`) |
-| `ctrl+t` | toggle the todo sidebar |
+| `ctrl+t` | show the current plan |
 | `ctrl+x` | copy the selected message to the clipboard |
 | `ctrl+up` | previous message |
 | `ctrl+down` | next message |
-| `pgup` | scroll the transcript up |
-| `pgdn` | scroll the transcript down |
-| `ctrl+home` | jump to the start of the transcript |
+| `pgup` | scroll the transcript up (fullscreen; otherwise your terminal scrolls) |
+| `pgdn` | scroll the transcript down (fullscreen; otherwise your terminal scrolls) |
+| `ctrl+home` | jump to the start: the viewport in fullscreen, the first message otherwise |
 | `ctrl+end` | jump back to the newest output |
 | `@path` | complete a file path |
 | `!command` | run a shell command directly, no model turn |
@@ -344,7 +310,8 @@ The prompt is a readline-style editor: `ctrl+a`/`ctrl+e` for line start and end,
 `ctrl+b`/`ctrl+f` by character, `alt+b`/`alt+f` by word, `ctrl+w` and `alt+d` to
 kill a word, `ctrl+u` and `ctrl+k` to kill to the start or end of a line, then
 `ctrl+y` to yank it back and `alt+y` to walk further down the kill ring.
-`ctrl+z` undoes, `ctrl+shift+z` redoes.
+`ctrl+_` undoes, `ctrl+shift+z` redoes - `ctrl+z` belongs to the shell, and
+suspends HX.
 
 Typing `/` or `@` opens a completion list above the prompt; `tab` cycles it,
 `enter` accepts, `esc` dismisses.
@@ -399,18 +366,55 @@ than being silently resolved.
 | `/rewind` | go back to an earlier prompt, restoring the files HX changed |
 | `/title [text]` | show or set this session's name |
 | `/prompt` | the system prompt this session is running with |
-| `/todos` | toggle the sidebar |
+| `/todos` | show the current plan |
 | `/skills` | installed skills |
 | `/agents` | subagent types |
 | `/mcp` | server status |
 | `/theme [name]` | `dark`, `light`, `ansi`, or any theme in `~/.hx/themes` |
 | `/queue [steer <n>\|clear]` | messages waiting for the turn to end, and what to do with them |
 | `/copy` | copy the last reply to the clipboard |
+| `/fullscreen [on\|off]` | take the whole window, with the prompt pinned to the bottom |
 | `/mouse [on\|off]` | mouse reporting, and with it your terminal's own text selection |
 | `/init` | generate an `AGENTS.md` for the project |
 | `/help` | list commands and keys |
 | `/quit` | exit (also `/exit`, `/q`) |
 
+### The two screens
+
+By default HX draws into your terminal's own scrollback. Finished output belongs
+to the terminal while the session runs: it scrolls it, selects it, copies it and
+pipes it. Nothing is repainted above the fold, so a long session costs the same
+to draw as a short one.
+
+The prompt and the status bar still open on the bottom row of the window: a
+conversation too short to fill the screen is padded above them rather than
+below, so the dock stays where you last saw it instead of creeping down the
+screen a block at a time. The padding is gone by the time the terminal starts
+scrolling.
+
+Leaving takes the whole interface off the screen: the banner, the conversation
+and the dock are erased and your shell prompt comes back on the row HX started
+on, the terminal as it was found. The erase stops at the top of the window -
+lines that had already scrolled above it stay in your scrollback, because the
+only sequence that reaches them takes everything the terminal remembers,
+including what was there before HX ran. `/clear` is the command that asks for
+that.
+
+`/fullscreen` switches to the alternate screen instead - the whole window, the
+prompt pinned to the bottom row, the transcript scrolling above it with `pgup`,
+`pgdn`, `ctrl+home` and `ctrl+end`. The trade is the thing the default was
+chosen for: the alternate screen is not scrollback, so your terminal cannot
+scroll or select it, and it is gone when HX exits. `/fullscreen off` gives it
+back, and either way the choice is written to `tui.fullscreen` for the next
+session. Quitting from fullscreen leaves the same clean terminal as quitting
+from the default screen: the alternate screen goes, and so does the frame HX
+had drawn underneath it before the switch.
+
+`/clear` wipes the screen and the scrollback above it. Terminals that do not
+implement scrollback erasure - macOS Terminal.app is the one people hit - clear
+the screen only, and the old conversation stays above it until you clear it the
+terminal's own way (`cmd+k`).
+
 ### Selecting and copying text
 
 Drag to select and `ctrl+c` to copy. HX copies through `pbcopy`, `wl-copy` or
@@ -524,7 +528,8 @@ along with the `.hx/.gitignore` it added to hide it.
   },
 
   "tui": {
-    "enterWhileBusy": "queue"         // queue | steer - what enter does mid-turn
+    "enterWhileBusy": "queue",        // queue | steer - what enter does mid-turn
+    "fullscreen": false               // true takes the whole window (see /fullscreen)
   }
 }
 ```
@@ -796,7 +801,8 @@ src/hx/
   permissions/  rule engine, shell decomposition, Seatbelt/bubblewrap
   skills/ agents/ mcp/
   keys.py       keybinding registry: ids, defaults, descriptions, user overrides
-  tui/          Textual app, commands, per-tool renderers, widgets
+  term/         the renderer: raw mode, input decoding, the differ, the screen
+  tui/          views, commands, per-tool renderers, themes
     themes/     the shipped palettes, as JSON
 ```
 

{hx_cli-0.1.9 → hx_cli-0.2.0}/install.sh

@@ -28,43 +28,86 @@ should_animate() {
     [ -t 1 ] && [ -z "${HX_NO_ANIMATION:-}" ] && [ -z "${CI:-}" ]
 }
 
+paint_logo_row() {
+    row=$1
+    text=$2
+    visible=$3
+    highlight=$4
+    clear_prefix=$5
+
+    if [ "$visible" -ne 0 ] && [ "$row" -gt "$visible" ]; then
+        text=
+    fi
+
+    if [ "$highlight" -eq 0 ]; then
+        colour='\033[0;36m'
+    elif [ "$row" -eq "$highlight" ]; then
+        colour='\033[1;96m'
+    else
+        colour='\033[2;36m'
+    fi
+
+    printf '%b%b%s\033[0m\n' "$clear_prefix" "$colour" "$text"
+}
+
 render_logo() {
-    padding=$1
+    # visible=0 renders the whole logo. highlight=0 uses the settled colour.
+    visible=${1:-0}
+    highlight=${2:-0}
     clear_prefix=
-    [ "${2:-}" = clear ] && clear_prefix='\033[2K\r'
-
-    printf '\033[0;36m'
-    printf '%b%s%s\n' "$clear_prefix" "$padding" ' _   _  __  __'
-    printf '%b%s%s\n' "$clear_prefix" "$padding" '| | | | \ \/ /'
-    printf '%b%s%s\n' "$clear_prefix" "$padding" '| |_| |  >  <'
-    printf '%b%s%s\n' "$clear_prefix" "$padding" "|  _  | / /\\ \\"
-    printf '%b%s%s\n' "$clear_prefix" "$padding" "|_| |_|/_/  \\_\\"
-    printf '\033[0m'
+    if [ "${3:-}" = clear ]; then
+        clear_prefix='\033[2K\r'
+    fi
+
+    paint_logo_row 1 '    __  __  _  __' "$visible" "$highlight" "$clear_prefix"
+    paint_logo_row 2 '   / / / / | |/ /' "$visible" "$highlight" "$clear_prefix"
+    paint_logo_row 3 '  / /_/ /  |   /' "$visible" "$highlight" "$clear_prefix"
+    paint_logo_row 4 ' / __  /  /   |' "$visible" "$highlight" "$clear_prefix"
+    paint_logo_row 5 '/_/ /_/  /_/|_|' "$visible" "$highlight" "$clear_prefix"
+}
+
+render_boot_prompt() {
+    typed=$1
+    clear_prefix='\033[2K\r'
+
+    printf '%b\n' "$clear_prefix"
+    printf '%b\n' "$clear_prefix"
+    printf '%b\033[2;36m  > \033[1;96m%s\033[0;36m_\033[0m\n' "$clear_prefix" "$typed"
+    printf '%b\n' "$clear_prefix"
+    printf '%b\n' "$clear_prefix"
+}
+
+rewind_logo() {
+    printf '\033[5A'
 }
 
 animate_logo() {
     if ! should_animate; then
-        render_logo ''
+        render_logo
         return
     fi
 
-    # Slide in, overshoot slightly, then settle into place.
-    render_logo '            ' clear
-    sleep 0.07
-    printf '\033[5A'
-    render_logo '        ' clear
-    sleep 0.07
-    printf '\033[5A'
-    render_logo '    ' clear
-    sleep 0.07
-    printf '\033[5A'
-    render_logo '' clear
-    sleep 0.07
-    printf '\033[5A'
-    render_logo '  ' clear
-    sleep 0.07
-    printf '\033[5A'
-    render_logo '' clear
+    # Type the command, draw the mark one scanline at a time, then bounce a
+    # highlight back through it. Every frame is five rows so redraws never jump.
+    for typed in '' h hx; do
+        render_boot_prompt "$typed"
+        sleep 0.055
+        rewind_logo
+    done
+
+    for row in 1 2 3 4 5; do
+        render_logo "$row" "$row" clear
+        sleep 0.045
+        rewind_logo
+    done
+
+    for row in 4 3 2 1; do
+        render_logo 0 "$row" clear
+        sleep 0.035
+        rewind_logo
+    done
+
+    render_logo 0 0 clear
 }
 
 stream_text() {

{hx_cli-0.1.9 → hx_cli-0.2.0}/pyproject.toml

@@ -20,8 +20,6 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
-  "textual>=0.85",
-  "rich>=13.7",
   "httpx>=0.27",
   "pydantic>=2.7",
   "pyyaml>=6.0",
@@ -29,6 +27,13 @@ dependencies = [
   # System trust store, so a corporate proxy CA the machine already trusts is
   # enough - certifi alone is why `hx` fails on networks where browsers work.
   "truststore>=0.10",
+  # Cell widths for the terminal renderer. Pure Python, tables generated from
+  # the Unicode data files - the one thing hx.term does not hand-roll.
+  "wcwidth>=0.2.13",
+  # Syntax highlighting. Was transitive through rich; now asked for directly.
+  "pygments>=2.17",
+  # CommonMark parsing. The renderer is ours; the parser is not worth writing.
+  "markdown-it-py>=3.0",
 ]
 
 [project.optional-dependencies]
@@ -38,10 +43,11 @@ dev = [
   "pytest-cov>=5.0",
   "ruff>=0.6",
   "mypy>=1.11",
-  "textual-dev>=1.5",
   "types-PyYAML",
   "types-Pygments",
-  "pytest-textual-snapshot>=1.0",
+  # A VT emulator, so tests can assert what the differ actually paints rather
+  # than what it claims to have written.
+  "pyte>=0.8",
 ]
 
 [project.scripts]
@@ -90,7 +96,7 @@ disallow_untyped_defs = true
 plugins = []
 
 [[tool.mypy.overrides]]
-module = ["textual.*", "textual_dev.*"]
+module = ["pyte.*", "wcwidth.*", "markdown_it.*"]
 ignore_missing_imports = true
 
 [tool.pytest.ini_options]

{hx_cli-0.1.9 → hx_cli-0.2.0}/src/hx/__init__.py

@@ -1,5 +1,5 @@
 """HX - a terminal coding agent."""
 
-__version__ = "0.1.9"
+__version__ = "0.2.0"
 
 __all__ = ["__version__"]

{hx_cli-0.1.9 → hx_cli-0.2.0}/src/hx/config.py

@@ -141,6 +141,14 @@ class TuiSettings:
     """Queueing is the default because it cannot surprise anyone: a steer cuts
     off the model mid-sentence, which is worth asking for deliberately."""
 
+    fullscreen: bool = False
+    """Draw into the alternate screen, with the prompt pinned to the bottom.
+
+    Off by default: in the normal screen the transcript is the terminal's own
+    scrollback, which it can scroll, select, copy and keep after HX exits.
+    ``/fullscreen`` turns it on for a session and writes it here for the next
+    one, for anyone who would rather have the window back."""
+
 
 @dataclass(frozen=True, slots=True)
 class Settings:
@@ -397,6 +405,7 @@ def _build_settings(data: dict[str, Any], cwd: Path) -> Settings:
         enter_while_busy = EnterWhileBusy(busy_raw)
     except ValueError as exc:
         raise ConfigError(f"unknown tui.enterWhileBusy: {busy_raw!r}") from exc
+    fullscreen = bool(tui.get("fullscreen", False))
 
     return Settings(
         cwd=cwd,
@@ -447,7 +456,7 @@ def _build_settings(data: dict[str, Any], cwd: Path) -> Settings:
             system=prompt.get("system"),
             append=tuple(_as_list(prompt.get("append", ()))),
         ),
-        tui=TuiSettings(enter_while_busy=enter_while_busy),
+        tui=TuiSettings(enter_while_busy=enter_while_busy, fullscreen=fullscreen),
         theme=data.get("theme", "dark"),
         quiet_startup=bool(data.get("quietStartup", data.get("quiet_startup", False))),
         telemetry=bool(data.get("telemetry", False)),

{hx_cli-0.1.9 → hx_cli-0.2.0}/src/hx/core/loop.py

@@ -609,13 +609,15 @@ class AgentLoop:
         from hx.permissions.engine import PermissionRequest
 
         tool = self.tools.get(call.name)
+        detail, detail_kind = _permission_detail(call)
         request = PermissionRequest(
             tool_name=call.name,
             specifier=tool.permission_specifier(call.input),
             params=call.input,
             mutating=tool.mutating,
             description=f"{call.name}({_brief(call.input)})",
-            detail=_permission_detail(call),
+            detail=detail,
+            detail_kind=detail_kind,
             origin=self.origin,
         )
         allowed, reason = await self.permissions.request(
@@ -711,14 +713,19 @@ def _parse_tool_input(raw: str | None) -> dict[str, Any]:
     return parsed if isinstance(parsed, dict) else {}
 
 
-def _permission_detail(call: ToolUseBlock) -> str:
-    """What the approval modal shows: the command, or the exact edit.
+def _permission_detail(call: ToolUseBlock) -> tuple[str, str]:
+    """What the approval shows, and what kind of thing it is.
 
     For an edit this previews the change against the file on disk, so the user
     approves a diff rather than a filename.
+
+    The kind is returned rather than left for the UI to infer. Guessing from
+    the text meant a file whose first line was ``---`` - YAML front matter, a
+    markdown rule - was treated as a diff and run through a painter that
+    strips exactly those lines, leaving the user approving a blank space.
     """
     if call.name == "Bash":
-        return str(call.input.get("command", ""))
+        return str(call.input.get("command", "")), "command"
 
     if call.name in {"Edit", "Write"} and (raw_path := call.input.get("file_path")):
         from pathlib import Path
@@ -736,12 +743,13 @@ def _permission_detail(call: ToolUseBlock) -> str:
                     after = after.replace(
                         edit.old_string, edit.new_string, -1 if edit.replace_all else 1
                     )
-            return unified_diff(before, after, str(path)) or f"{path} (no change)"
+            diff = unified_diff(before, after, str(path))
+            return (diff, "diff") if diff else (f"{path} (no change)", "text")
         except Exception:
             # Previewing is best effort; never block the prompt on it.
-            return str(raw_path)
+            return str(raw_path), "text"
 
-    return _brief(call.input, limit=400)
+    return _brief(call.input, limit=400), "text"
 
 
 def _brief(params: dict[str, Any], limit: int = 80) -> str: