diff --git a/README.md b/README.md
index 8a04d76..f038890 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 Customize OpenCode's compaction prompt to guide which context carries forward, which details are omitted, and what the next session should retain.
 
+[GitHub](https://github.com/bendtherules/opencode-plugin-compaction-prompt) · [npm](https://www.npmjs.com/package/opencode-plugin-compaction-prompt)
+
 ## Install
 
 ```bash
@@ -51,6 +53,21 @@ bun run pack:check
 
 The npm package exposes the compiled entrypoint at `dist/index.js` and TypeScript declarations at `dist/index.d.ts`.
 
+## Publishing
+
+Before publishing a release:
+
+```bash
+bun run format:check
+bun test
+bun run typecheck
+bun run build
+bun run pack:check
+npm publish
+```
+
+Update the version in `package.json` before each release. `npm publish` rebuilds `dist/` automatically.
+
 ## Compatibility
 
 The plugin uses OpenCode's `experimental.session.compacting` hook. OpenCode may change experimental plugin APIs between releases; test the package against the OpenCode version you support.
diff --git a/package.json b/package.json
index 805f858..e89dbb5 100644
--- a/package.json
+++ b/package.json
@@ -3,6 +3,14 @@
   "version": "0.1.0",
   "description": "Customize OpenCode's compaction prompt to preserve important context and omit unnecessary details.",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bendtherules/opencode-plugin-compaction-prompt.git"
+  },
+  "homepage": "https://github.com/bendtherules/opencode-plugin-compaction-prompt#readme",
+  "bugs": {
+    "url": "https://github.com/bendtherules/opencode-plugin-compaction-prompt/issues"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",