Skip to content

docs: trim README for launch#4

Merged
lupuletic merged 2 commits into
mainfrom
cleanup/readme-launch
May 19, 2026
Merged

docs: trim README for launch#4
lupuletic merged 2 commits into
mainfrom
cleanup/readme-launch

Conversation

@lupuletic
Copy link
Copy Markdown
Owner

@lupuletic lupuletic commented May 19, 2026

Summary

README cleanup and a fix to the demo asset generator so screenshots look like a real terminal.

README

  • Trim copy: dropped "memory layer" framing in the intro, replaced "designed for local developer recall" tautology in Privacy with plain "runs locally", fixed the awkward "in this repo's integration path" phrasing in the Codex hook explainer.
  • Drop the static tests-count badge — drifts every time tests are added unless wired to CI.
  • Move the Release section (Trusted Publisher table + tag/build recipe) to docs/RELEASE.md. Maintainer docs were burying user-facing content.
  • Restore a trimmed Screenshots section (3 panels: search, why, AI chat) now that the SVGs render faithfully.

Demo SVG fix

Textual's compositor resolves ANSI colors to RGB before Rich's SVG export sees them, so passing theme=SVG_EXPORT_THEME to console.export_svg is a no-op — cyan/magenta come out as harsh #00ffff / #ff00ff instead of the softer values users actually see in iTerm/Ghostty.

Fix in scripts/generate_demo_assets.py: post-process the exported SVG to remap the 16 default-ANSI hex values to the SVG_EXPORT palette (cyan → #398280, magenta → #ff2c7a, green → #98a84b, etc.). Result: README screenshots now match the real TUI palette.

Regenerated docs/assets/code-recall-{search,why,activity,related,ai-chat}.svg and the demo GIF with the fixed palette.

Test plan

  • Render README.md on GitHub and confirm screenshots show soft Claude-cyan and Codex-pink, not pure ANSI
  • Confirm docs/RELEASE.md link resolves
  • Confirm the demo GIF still loads at the top
  • python scripts/generate_demo_assets.py runs clean

- Drop synthetic SVG screenshot grid (the demo GIF above the fold already covers it; the SVGs do not match the real TUI rendering)
- Drop static tests-count badge (drifts without CI wiring)
- Move Trusted Publisher table and release commands to docs/RELEASE.md
- Tighten Privacy and Why intros, fix Codex hook explanation
@lupuletic lupuletic force-pushed the cleanup/readme-launch branch from 958e8c9 to a30dcf5 Compare May 19, 2026 20:55
Textual's compositor resolves ANSI colors to RGB before Rich's SVG export
sees them, so passing theme=SVG_EXPORT_THEME to console.export_svg is a
no-op — cyan/magenta come out as harsh #00ffff/#ff00ff. Post-process the
exported SVG to remap the 16 default-ANSI hex values to the softer
monokai-style SVG_EXPORT palette (cyan -> #398280, magenta -> #ff2c7a,
green -> #98a84b, etc.) so screenshots look like a real iTerm/Ghostty
rendering rather than a 1990s VGA terminal.

Also restore a trimmed Screenshots section to the README (3 panels:
search, why, AI chat) now that the SVGs faithfully represent the TUI.
@lupuletic lupuletic merged commit 4eeeb8c into main May 19, 2026
10 checks passed
@lupuletic lupuletic deleted the cleanup/readme-launch branch May 19, 2026 21:04
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