Skip to content

feat(cli): restyle the shell in black and white - #16

Merged
kottinov merged 2 commits into
mainfrom
feat/cli-tui-mono
Nov 17, 2026
Merged

kottinov merged 2 commits into
mainfrom
feat/cli-tui-mono

Conversation

@kottinov

Copy link
Copy Markdown
Collaborator

Why

pnpm evorca opened a shell with a teal-to-indigo banner on the terminal's own colors. The goal is a calmer black-and-white look in the style of opencode, with a little motion. This PR restyles the shell in grays and adds three short animations. The commands and replies stay the same.

What changed

  • shell.tsx draws every color from one gray palette. It shows a home screen with the wordmark and the input box until the first line, then the transcript view with the input box at the bottom.
  • wordmark.ts replaces banner.ts with a three-row block font for "evorca". motion.ts times the wordmark's sweep and shimmer and the placeholder that types out example questions.
  • One animation clock drives all three. It stops when nothing on screen moves.

Scope

  • The look of the shell only. /help, /exit, ctrl+c, the replies, the terminal check, and the on-demand import of the shell stay as they were.
  • No settings, themes, or flags. In a narrow terminal, a long example question is cut off at the edge of the input box.

Blast Radius

Only the interactive shell changes. evorca fetch and evorca reproduce never load the shell module, and their exit codes in the verification run are unchanged.

Verification

  • pnpm check passes. The shell tests drive the real component under a manual clock, including the typewriter, the sweep, the gray-only colors, and the stopped clock.
  • A run in a real terminal at 100x30 and 40x30 passes 64 checks, including gray colors in every cell and a restored terminal after /exit and ctrl+c.
  • CPU on the home screen with an empty input box: 4.4% of one core, median of 5 runs. In the transcript view with text typed: 0.0%.

Home screen, 1 s after start, at 100x30 (OpenTUI's test renderer, directory set to ~/incidents):










                                 █▀▀▀█ █   █ █▀▀▀█ █▀▀▀ █▀▀▀▀ ▀▀▀▀█
                                 █▄▄▄█ ▀▄ ▄▀ █   █ █    █     █▀▀▀█
                                 █▄▄▄▄  ▀▄▀  █▄▄▄█ █    █▄▄▄▄ █▄▄▄█

                                  autonomous incident investigation


             ╭─────────────────────────────────────────────────────────────────────────╮
             │ ❯ Why did ch                                                            │
             ╰─────────────────────────────────────────────────────────────────────────╯
               enter send   /help commands   ctrl+c exit








  ~/incidents                                                                        evorca v0.0.0

Transcript view after hello and /help, same setup:


  ┃
  ┃  hello
  ┃

  ┃  No agent is connected yet.

  ┃
  ┃  /help
  ┃

  ┃  /help  List the commands
  ┃  /exit  Exit evorca










  ╭──────────────────────────────────────────────────────────────────────────────────────────────╮
  │ ❯ What changed bef                                                                           │
  ╰──────────────────────────────────────────────────────────────────────────────────────────────╯
    enter send   /help commands   ctrl+c exit

  ~/incidents                                                                        evorca v0.0.0

The shell paints every cell in grays from one palette, on a near-black
background, so it looks the same in light and dark terminals. It opens
on a home screen with the evorca wordmark, a tagline, and the input box.
Once a line adds to the transcript, the session view replaces the home
screen. A footer shows the working directory and the version.

wordmark.ts draws the wordmark from pixel glyphs in a three-row block
font and replaces banner.ts.
The wordmark sweeps in from the left when the shell opens, and a
lighter band crosses it every 8 s. While the input box is empty, its
placeholder types out example questions, holds each one, and erases it.

motion.ts gives each animation as a pure function of time, with a phase
that says whether it moves and for how long. The shell drives them from
the renderer's animation clock at 30 fps while a phase moves. While none
moves, it sets one timer for the next movement, and it stops when
nothing will move. A resting wordmark keeps one frame, so the frames
that type the placeholder do not redraw it.
@kottinov
kottinov merged commit 2d6e4f9 into main Nov 17, 2026
1 check passed
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