From ca006e15f4e8cabc64b2e3d049de47021ad68933 Mon Sep 17 00:00:00 2001
From: Amolith <amolith@secluded.site>
Date: Fri, 13 Feb 2026 18:57:53 -0700
Subject: [PATCH] docs: add fork section

---
 AGENTS.md |  1 +
 README.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index f6095e44bb08552c8dfa4e429762aa5422228951..0d735475ff8f40c5cd339e00d5c2643a2106aa90 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -88,6 +88,7 @@ internal/
 - **Modernize**: `task modernize` (runs `modernize` which makes code
   simplifications)
 - **Dev**: `task dev` (runs with profiling enabled)
+- **Pre-commit flow**: `task fmt lint-fix test`
 
 ## Code Style Guidelines
 
diff --git a/README.md b/README.md
index 03c9e736a15f7b4d19caa0068232ab9feefde284..ac30547a1199510547ef63fdeca520f79bab5303 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,67 @@
+**NOTE:** This is a personal fork of
+[Crush](https://github.com/charmbracelet/crush) where I'm experimenting with
+things. You'll also find my patches merged here before they're merged into
+upstream. I've also unconditionally disabled metrics and yote the CLA; devs
+shouldn't assign their copyrights to maintainers and hand them the rug they'll
+yank from under you later.
+
+Install my fork either…
+
+- Using [bin](https://github.com/marcosnils/bin) (highly recommended
+  because it's one tool to manage and update myriad CLI tools
+  distributed as statically-linked binaries, like _nasin pali_)
+  ```bash
+  bin install goinstall://git.secluded.site/crush@v0.47.2-fork.1
+  ```
+- Or using the [go toolchain](https://go.dev/dl) (requires tracking updates
+  manually)
+  ```bash
+  go install git.secluded.site/crush@v0.47.2-fork.1
+  ```
+
+I pull upstream changes into the `upstream` branch here, break my
+branches off that, then merge them into my `dev` branch, which gets
+rebased on `upstream` fairly often. `dev` history will get rewritten
+frequently.
+
+Contributions are welcome (see following section) and I'll try to
+maintain anything I accept here.
+
+## Contributions
+
+Patch requests are in [amolith/llm-projects] on [pr.pico.sh]. You don't
+need a new account to contribute, you don't need to fork this repo, you
+don't need to fiddle with `git send-email`, you don't need to faff with
+your email client to get `git request-pull` working...
+
+You just need:
+
+- Git
+- SSH
+- An SSH key
+
+```sh
+# Clone this repo, make your changes, and commit them
+# Create a new patch request with
+git format-patch origin/main --stdout | ssh pr.pico.sh pr create amolith/llm-projects
+# After potential feedback, submit a revision to an existing patch request with
+git format-patch origin/main --stdout | ssh pr.pico.sh pr add {prID}
+# List patch requests
+ssh pr.pico.sh pr ls amolith/llm-projects
+```
+
+See "How do Patch Requests work?" on [pr.pico.sh]'s home page for a more
+complete example workflow.
+
+[amolith/llm-projects]: https://pr.pico.sh/r/amolith/llm-projects
+[pr.pico.sh]: https://pr.pico.sh
+
+---
+
+_Everything from here on is from the original Crush README._
+
+---
+
 # Crush
 
 <p align="center">