diff --git a/README.md b/README.md
index 377fbdb..b4177eb 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,22 @@
-# PyGitWeb: Hassle-Free Project Hosting
+# PyGitWeb: Innovative yet simple project hosting
 
 PyGitWeb and its bundled tools allow users to:
 - Self-host git repositories (+ associated settings, permissions, and metadata)
 - Manage projects and teams; built-in issues and kanban boards
 - Assist with info security including code signing and secret scanning
+
+PyGitTools, the dependent package of PyGitWeb, allows users to, without using the web server:
+- Script Python workflows with Tasks, Merge Requests, and Hooks within a repositories
 - Setup hooks and jobs to run on your machine, including server-side hooks for branch protection
+- Use the bundled git terminal app (pgt) to quickly perform git actions
 
 ## Installation and Usage
 
-To setup with UV and a standard virtual environment:
+To setup with UV:
 ```
-git clone <url>; cd distgit;
-python -m venv .venv;
-source .venv/bin/activate; # (just ".venv/Scripts/activate" on Windows)
+git clone https://app.pygitweb.com/html/pygitweb; cd pygitweb;
 uv sync --all-packages;
-uvicorn pygitweb.main:app --host 0.0.0.0 --port 8000
+uv run uvicorn pygitweb.main:app --host 0.0.0.0 --port 8000
 ```
 
 ## Installation with Docker
@@ -23,13 +25,14 @@ uvicorn pygitweb.main:app --host 0.0.0.0 --port 8000
 
 ## Installation for Development
 
-With the venv set up, instead run:
 ```
 uv sync --all-packages --all-groups;
-uvicorn pygitweb.main:app --reload --host 0.0.0.0 --port 8000
+uv run uvicorn pygitweb.main:app --reload --host 0.0.0.0 --port 8000
 ```
 
-Setting up your precommit hooks is recommended, but to manually run precommit checks, do:
+Setting up your pre-commit hooks is recommended, but to manually run pre-commit checks, do:
 ```
-ruff format --preview; ruff check; mypy .;
+uv run ruff check --fix;
+uv run ruff format --preview;
+mypy .;
 ```
diff --git a/pygittools/README.md b/pygittools/README.md
index 2e1750f..6786f8f 100644
--- a/pygittools/README.md
+++ b/pygittools/README.md
@@ -1,6 +1,16 @@
 # PyGitTools
 
-Authentication, hooks, and pygit2 workflows used by PyGitWeb. Can be used headless for many purposes.
+Hooks, tooling, and pygit2 workflows used by PyGitWeb. Can be used headless for many purposes.
+
+## PGT
+
+PGT is a command line curses application you can use to make commits, switch branches and repos, and do other basic git tasks. Keybinds:
+ - Arrow keys or `j`/`k` to navigate
+ - `Enter` to confirm actions, stage or unstage files or categories
+ - `Space` to collapse menus
+ - `ctrl-c` or `esc` to exit.
+
+To run from the repo root, use `uv run pgt`.
 
 ## Hook framework
 
@@ -14,3 +24,4 @@ long-poll `updates=true` subscribers wake up immediately on each push. Notificat
 failures never reject the push.
 
 See `hook_samples/` for ready-to-use scripts.
+
diff --git a/pygitweb/README.md b/pygitweb/README.md
index dbfdf7b..7cd903e 100644
--- a/pygitweb/README.md
+++ b/pygitweb/README.md
@@ -2,32 +2,6 @@
 
 Gitweb reimplementation using **Python**, **FastAPI**, and **Pygit2**, ported from `git/gitweb/gitweb.perl`.
 
-## Setup
-
-```bash
-uv sync --package pygitweb
-```
-
-Or install everything in the workspace (all members + dev tools):
-
-```bash
-uv sync --all-packages --group dev
-```
-
-## Run
-
-From the repository root (after `uv sync`), with the workspace `.venv` activated:
-
-```bash
-uvicorn pygitweb.main:app --reload --host 0.0.0.0 --port 8000
-```
-
-Or:
-
-```bash
-python -m pygitweb.main
-```
-
 ## Config
 
 Settings load from `~/.pygitweb/settings.json` (or `PYGITWEB_SETTINGS_CONFIG`), `PYGITWEB_*`