@@ -16,25 +16,39 @@ on:
 jobs:
   test:
     # The type of runner that the job will run on
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
 
     # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - uses: actions/checkout@v3
 
+      # pin the Python the project requires (>=3.12)
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
       # Runs a single command using the runners shell
       - name: Install dependencies
         run: |
           sudo apt update -y
-          sudo apt install gnome-keyring curl
+          sudo apt install -y gnome-keyring curl ripgrep
           curl -sSL https://install.python-poetry.org | python3 -
           poetry --version
           poetry config --local virtualenvs.create true
           poetry install
 
 
 
+      # SystemPaths and the entries loader fail fast without these, so point them at this checkout
+      # and at a fresh project made from the bundled entries_main.py template
+      - name: Configure PythonSearch
+        run: |
+          mkdir -p ~/.config/python_search ~/python_search_entries
+          echo "PYTHON_SEARCH_PATH=$GITHUB_WORKSPACE" > ~/.config/python_search/config
+          cp python_search/init/entries_main.py ~/python_search_entries/
+          echo "$HOME/python_search_entries" > ~/.config/python_search/current_project
+
       # Runs a set of commands using the runners shell
       - name: Run a multi-line script
         run: |
 
@@ -19,20 +19,8 @@ graph LR
     E --> F[InterpreterMatcher]
 ```
 
-## Terminal UI (fallback)
-
-`python_search search` opens a Kitty window running `term_ui`, a hand rolled ANSI UI that loads
-entries by shelling out to the Python entries loader and ranks them with BM25.
-
-```mermaid
-graph LR
-    A[User] -- python_search search --> B[Kitty window]
-    B --> C[term_ui: BM25 over entries]
-    C -- Enter --> D[run_key]
-```
-
 ## Entries
 
-Both front ends read the same database: `entries_main.py` in the entries project, which is
+The launcher reads the database: `entries_main.py` in the entries project, which is
 executable Python. The native launcher consumes a JSON dump of it
 (`python_search _entries_loader dump_entries`) rather than importing Python on every launch.
@@ -90,16 +90,10 @@ On Linux (X11 or Wayland) build it with `cargo build --release -p ps-ui` in `rus
 `ps_ui daemon` at login, and bind `ps_ui show` to a key through an entry shortcut. See
 [`rust/README.md`](rust/README.md#linux).
 
-| | terminal UI (`term_ui`) | native launcher (`ps_ui`) |
-|---|---|---|
-| Startup | two Python interpreters per launch | resident, ~10 ms to show |
-| Search | BM25 in Python over the full corpus | in-memory fuzzy match, 0.1–2 ms |
-| Rendering | full ANSI repaint per keystroke | GPU (a macOS panel, or a window on Linux) |
-| Host | a Kitty window | its own borderless window |
-
-Both read the same entries and run the same executor; `term_ui` is untouched and remains available
-via `python_search search`. See [`rust/README.md`](rust/README.md) for the source layout, key
-bindings, ranking, and platform notes.
+`ps_ui` is resident (~10 ms to show), fuzzy matches in memory (0.1–2 ms) and renders on the GPU.
+`python_search search` (and `pys`) open it too. It follows `~/.python_search/theme` (`dark` or
+`light`) when present, otherwise the time of day. See [`rust/README.md`](rust/README.md) for the
+source layout, key bindings, ranking, and platform notes.
 
 ## Documentation
 
@@ -144,8 +138,7 @@ puts these console scripts on your `PATH`. They are defined in `pyproject.toml`
 | Binary | What it does |
 |---|---|
 | `python_search` | Main CLI: `search`, `shortcuts`, `register_new`, `new_project`, and more. Run it with no arguments for the full list |
-| `pys` | Shortcut for `python_search search` |
-| `term_ui` | The terminal search UI on its own |
+| `pys` | Shortcut for `python_search search` (opens `ps_ui`) |
 | `run_key` | Run one entry by key, e.g. `run_key 'open mail'` |
 | `run_shortcut` | Run the entry that owns a shortcut, e.g. `run_shortcut '⌘⇧E'` |
 | `entries_editor` | Open an entry's definition in the editor (`edit_key`) or delete it (`delete_key`) |
 
@@ -32,7 +32,6 @@ tiny-data-warehouse = ">=0.1.5"
 datadog = "*"
 rank-bm25 = "^0.2.2"
 nltk = "^3.9.1"
-getch = "^1.0"
 PySimpleGUI = "*"
 [tool.poetry.dev-dependencies]
 pytest = "^7.1.2"
@@ -68,7 +67,6 @@ notify_send = 'python_search.apps.notification_ui:main'
 browser = 'python_search.apps.browser:main'
 run_key = 'python_search.entry_runner:main'
 run_shortcut = 'python_search.shortcut.runner:main'
-term_ui = 'python_search.search.search_ui.terminal_ui:main'
 register_new_launch_ui = 'python_search.entry_capture.entry_inserter_gui.register_new_gui:launch_ui'
 google_it = 'python_search.apps.google_it:main'
 share_entry = 'python_search.share_entry:main'
 
@@ -1,5 +1,6 @@
 from python_search.configuration.loader import ConfigurationLoader
 from python_search.environment import is_mac
+from python_search.host_system.system_paths import SystemPaths
 
 
 def get_terminal():
@@ -74,6 +75,4 @@ def wrap_cmd_into_terminal(self, cmd, title=None, hold_terminal_open_on_end=True
         return final_cmd
 
     def get_kitty_cmd(self):
-        from python_search.search.search_ui.kitty_for_search_ui import get_kitty_cmd
-
-        return get_kitty_cmd()
+        return SystemPaths.KITTY_BINNARY