Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

docs(readme): restore the star history chart with a sealed token (#3844)

Maximilian Roos2aab2ba1a278
diff --git a/README.md b/README.md
index 91dd8e613..d113ddba7 100644
--- a/README.md
+++ b/README.md
@@ -245,6 +245,21 @@ The `-x` flag runs a command after switching; arguments after `--` are passed to
### Star history
+<!-- `sealed_token` is a GitHub token of ours encrypted with star-history's public
+ key, from "Generate embed code" on star-history.com. Without one the chart
+ renders a "GitHub restricted access to star data" placeholder: GitHub limits
+ stargazer data to a repo's admins and collaborators, and their servers are
+ neither.
+
+ The token is fine-grained and reaches only this repo. Its Contents permission
+ has to be read *and write* — write access is what GitHub accepts as proof of
+ collaborator status, so rotating to a read-only token brings the placeholder
+ straight back. Publishing the ciphertext is safe on its own; what the scope
+ buys is a bound on star-history, which decrypts it and so holds a credential
+ that can push here until it expires 2027-08-16 — at which point the chart
+ reverts to the placeholder with nothing else to signal it. star-history
+ reports GitHub is working on restoring access, so drop this parameter once
+ the plain URL renders a chart again. -->
<a href="https://star-history.com/#max-sixty/worktrunk&Date">
- <img src="https://api.star-history.com/svg?repos=max-sixty/worktrunk&type=Date" width="500" alt="Star History Chart">
+ <img src="https://api.star-history.com/svg?repos=max-sixty/worktrunk&type=Date&sealed_token=2ySbQiVbkVrGmwgDsJya-xr4ApbVVvR0siYI46d22Xj_1kPCcgA9X0YpUGc3__aMuZ0ZAWzG4NBhJtqepYjlkoYrVwmKbgaPmGpNZTCfSyVp8EDA_IXaOOYW2whsOXDAi6g7HD9ezsnqSl58n7AqW2_4IQ4hY2p3h7tNv_3k4am5ASq1NdpbfrOUazCl" width="500" alt="Star History Chart">
</a>
diff --git a/plugins/worktrunk/skills/worktrunk/reference/README.md b/plugins/worktrunk/skills/worktrunk/reference/README.md
index 91dd8e613..d113ddba7 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/README.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/README.md
@@ -245,6 +245,21 @@ The `-x` flag runs a command after switching; arguments after `--` are passed to
### Star history
+<!-- `sealed_token` is a GitHub token of ours encrypted with star-history's public
+ key, from "Generate embed code" on star-history.com. Without one the chart
+ renders a "GitHub restricted access to star data" placeholder: GitHub limits
+ stargazer data to a repo's admins and collaborators, and their servers are
+ neither.
+
+ The token is fine-grained and reaches only this repo. Its Contents permission
+ has to be read *and write* — write access is what GitHub accepts as proof of
+ collaborator status, so rotating to a read-only token brings the placeholder
+ straight back. Publishing the ciphertext is safe on its own; what the scope
+ buys is a bound on star-history, which decrypts it and so holds a credential
+ that can push here until it expires 2027-08-16 — at which point the chart
+ reverts to the placeholder with nothing else to signal it. star-history
+ reports GitHub is working on restoring access, so drop this parameter once
+ the plain URL renders a chart again. -->
<a href="https://star-history.com/#max-sixty/worktrunk&Date">
- <img src="https://api.star-history.com/svg?repos=max-sixty/worktrunk&type=Date" width="500" alt="Star History Chart">
+ <img src="https://api.star-history.com/svg?repos=max-sixty/worktrunk&type=Date&sealed_token=2ySbQiVbkVrGmwgDsJya-xr4ApbVVvR0siYI46d22Xj_1kPCcgA9X0YpUGc3__aMuZ0ZAWzG4NBhJtqepYjlkoYrVwmKbgaPmGpNZTCfSyVp8EDA_IXaOOYW2whsOXDAi6g7HD9ezsnqSl58n7AqW2_4IQ4hY2p3h7tNv_3k4am5ASq1NdpbfrOUazCl" width="500" alt="Star History Chart">
</a>