diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6db9fae..6a2398a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
 
+## [2.1.1] - 2025-09-04
+
+### Fixed
+
+- README: converted example links to absolute GitHub URLs so they render correctly on npmjs.com.
+
 ## [2.1.0] - 2025-08-28
 
 ### Breaking
diff --git a/README.md b/README.md
index 8eb13ad..3fd8a91 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,8 @@ Lightweight, model-agnostic chat history compression utilities for AI assistants
 
 ## Examples
 
-- OpenAI: see `examples/OPENAI_EXAMPLE.md` (copy-paste snippet; BYOM, no deps added here).
-- LangChain: see `examples/LANGCHAIN_EXAMPLE.md` and `examples/LANGCHAIN_COMPRESS_HISTORY.md`.
+- OpenAI: see [examples/OPENAI_EXAMPLE.md](https://github.com/agentailor/slimcontext/blob/main/examples/OPENAI_EXAMPLE.md) (copy-paste snippet; BYOM, no deps added here).
+- LangChain: see [examples/LANGCHAIN_EXAMPLE.md](https://github.com/agentailor/slimcontext/blob/main/examples/LANGCHAIN_EXAMPLE.md) and [examples/LANGCHAIN_COMPRESS_HISTORY.md](https://github.com/agentailor/slimcontext/blob/main/examples/LANGCHAIN_COMPRESS_HISTORY.md).
 
 ## Features
 
@@ -127,9 +127,9 @@ You can chain strategies depending on token thresholds or other heuristics.
 
 ## Example Integration
 
-- See `examples/OPENAI_EXAMPLE.md` for an OpenAI copy-paste snippet.
-- See `examples/LANGCHAIN_EXAMPLE.md` for a LangChain-style integration.
-- See `examples/LANGCHAIN_COMPRESS_HISTORY.md` for a one-call LangChain history compression helper.
+- See [examples/OPENAI_EXAMPLE.md](https://github.com/agentailor/slimcontext/blob/main/examples/OPENAI_EXAMPLE.md) for an OpenAI copy-paste snippet.
+- See [examples/LANGCHAIN_EXAMPLE.md](https://github.com/agentailor/slimcontext/blob/main/examples/LANGCHAIN_EXAMPLE.md) for a LangChain-style integration.
+- See [examples/LANGCHAIN_COMPRESS_HISTORY.md](https://github.com/agentailor/slimcontext/blob/main/examples/LANGCHAIN_COMPRESS_HISTORY.md) for a one-call LangChain history compression helper.
 
 ## Adapters
 
@@ -170,7 +170,7 @@ const compact = await langchain.compressLangChainHistory(history, {
 });
 ```
 
-See `examples/LANGCHAIN_COMPRESS_HISTORY.md` for a fuller copy-paste example.
+See [examples/LANGCHAIN_COMPRESS_HISTORY.md](https://github.com/agentailor/slimcontext/blob/main/examples/LANGCHAIN_COMPRESS_HISTORY.md) for a fuller copy-paste example.
 
 ## API
 
diff --git a/package.json b/package.json
index ca575a4..71fa999 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "slimcontext",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Lightweight, model-agnostic chat history compression (trim + summarize) for AI assistants.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",