docs: document managed Enterprise setup

Lead installation guidance with managed SASE plugin install routes and
add an ordered GitHub Enterprise setup checklist.

SASE_AGENT=0b2.cld.f1
SASE_MACHINE=athena

Author: bbugyi200

README.md

@@ -14,17 +14,39 @@ management, and submission, along with GitHub-specific xprompt workflows.
 
 ## Installation
 
+For a managed SASE install, install `sase-github` into the same `uv tool` environment as `sase` so its entry points are
+discovered by the `sase` command.
+
+### Recommended: SASE Admin Center Updates tab
+
+If SASE is already installed with `uv tool install sase`, open `sase ace`, press `#` for the SASE Admin Center, then go
+to the **Updates** tab (`5`, or `[` / `]`). Highlight `sase-github` in the plugin list (`j` / `k`, or `/` to filter),
+press `i` to install, and confirm the preview modal. The preview shows the exact `uv` command and resolved package set;
+the install runs as a tracked background task and is discovered on the next `sase` run.
+
+See the core SASE docs for the [Updates tab](https://github.com/sase-org/sase/blob/master/docs/configuration.md#updates-tab)
+and [`sase plugin` commands](https://github.com/sase-org/sase/blob/master/docs/plugins.md).
+
+### Alternative: install SASE and the plugin together
+
 ```bash
-pip install sase-github
+uv tool install sase --python 3.12 --with sase-github
 ```
 
-Or with [uv](https://docs.astral.sh/uv/):
+Repeat `--with` for additional plugins, for example `--with sase-github --with sase-telegram`. Add `--force` to replace
+an existing tool install.
+
+### Equivalent CLI for an existing install
 
 ```bash
-uv pip install sase-github
+sase plugin install github
 ```
 
-Requires `sase>=0.1.3` as a dependency (installed automatically).
+`pip install sase-github` is only an escape hatch for non-managed or library-style environments. It is not the normal
+path for a `uv tool`-managed SASE command.
+
+Requires `sase>=0.1.3` as a dependency. For GitHub Enterprise Server or self-hosted GitHub, follow the
+[GitHub Enterprise setup walkthrough](docs/configuration.md#github-enterprise-setup).
 
 ## What's Included
 
@@ -74,6 +96,9 @@ workflows, and PR submission.
 - [gh](https://cli.github.com/) CLI (for GitHub API operations). For GitHub Enterprise, run
   `gh auth login --hostname <host>` for each configured Enterprise host.
 
+See [Configuration](docs/configuration.md) for `github_hosts`, `github_orgs`, workspace layout, and the ordered GitHub
+Enterprise setup flow.
+
 ## Development
 
 ```bash

docs/configuration.md

@@ -1,5 +1,38 @@
 # Configuration
 
+## GitHub Enterprise setup
+
+Use this checklist for GitHub Enterprise Server or another self-hosted GitHub host:
+
+1. **Install SASE and `sase-github`.** Use the
+   [README installation routes](../README.md#installation): the SASE Admin Center Updates tab is the recommended path
+   for an existing managed install, while `uv tool install sase --python 3.12 --with sase-github` installs SASE and the
+   plugin together. The core SASE [plugin docs](https://github.com/sase-org/sase/blob/master/docs/plugins.md) also cover
+   `sase plugin install github` for existing installs.
+2. **Authenticate `gh` to the Enterprise host.**
+
+   ```bash
+   gh auth login --hostname github.mycompany.com
+   ```
+
+   Repo-scoped `gh` commands auto-detect the host from the git remote, so this host-specific login is enough for PR
+   operations once the repo is cloned.
+3. **Set `github_hosts` in `~/.config/sase/sase.yml`.** **Put your Enterprise host first** if you want bare
+   `#gh(owner/repo)` refs to clone from Enterprise. `github.com` is always included implicitly, but the first configured
+   host is the default for bare refs; listing `github.com` first means bare refs default there instead. See
+   [`github_hosts`](#github_hosts).
+4. **Optionally enable SSH clones.** Add owners to [`github_orgs`](#github_orgs) when you have an SSH key registered on
+   that GitHub host and want SASE to clone those repos with `git@<host>:owner/repo.git`. Owners not listed in
+   `github_orgs` use HTTPS.
+5. **Verify and resolve a repo.** Run:
+
+   ```bash
+   sase doctor -C plugins.github
+   ```
+
+   Then resolve a repo with `#gh(owner/repo)`. Enterprise workspaces are namespaced by host under
+   `~/projects/github/<host>/<user>/<project>/`; see [Workspace Layout](#workspace-layout).
+
 ## `github_hosts`
 
 The `github_hosts` setting controls which GitHub hosts sase-github recognizes. Add it to your sase config file