diff --git a/CLAUDE.md b/CLAUDE.md
index f312c9d..89278cd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -10,6 +10,27 @@ This repository contains configurations, prompts, and tools to improve the Claud
 - `scripts/` - Automation scripts
 - `hooks/` - Claude Code hooks (pre/post tool execution)
 
+## Forgejo Integration
+
+Uses `fj` CLI (forgejo-cli) for issue/PR management:
+
+```bash
+# Setup (one-time)
+brew install forgejo-cli
+echo "YOUR_TOKEN" | fj -H code.flowmade.one auth add-key username
+
+# Token needs scopes: read:user, read:repository, write:issue, write:repository
+```
+
+### Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `/work-issue <n>` | Fetch issue, create branch, implement, create PR |
+| `/dashboard` | Show open issues and PRs |
+| `/review-pr <n>` | Review PR with diff and comments |
+| `/create-issue` | Create single or batch issues |
+
 ## Usage
 
 This project is meant to be used alongside Claude Code to enhance productivity and maintain consistent workflows.