From 637003d70c6f1e5dfb3750df407d04be04c6c95c Mon Sep 17 00:00:00 2001
From: David Kong <davkon@gmail.com>
Date: Fri, 24 Jul 2026 22:20:44 +1000
Subject: [PATCH] docs: add repo details and fj CLI usage to AGENTS.md

---
 AGENTS.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 7cc49a4..18fc3c8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,35 @@
 # AGENTS.md — pi-worktree Extension
 
+## Repo Details
+
+| Property | Value |
+|----------|-------|
+| **Host** | `git.excelera.net` |
+| **Remote** | `https://git.excelera.net/david/pi-worktrees.git` |
+| **Owner** | david |
+| **Repo** | pi-worktrees |
+
+## Using `fj` CLI to Pull Issues
+
+This repo uses the [`fj`](https://git.excelera.net/david/fj) CLI tool (Forgejo CLI) for issue operations. It's auto-detected from the git remote, so `-H` is optional inside this repo:
+
+```bash
+# Search open issues in this repo
+fj issue search --repo pi-worktrees
+
+# View a specific issue
+fj issue view <ISSUE_NUM>
+
+# List all open issues
+fj issue search --state open
+```
+
+### Prerequisites
+
+- `fj` must be installed and authenticated (`fj whoami`)
+- Credentials stored at `~/.local/share/forgejo-cli/keys.json`
+- Auth via OAuth login or application token on `git.excelera.net`
+
 ## Project Structure
 
 ```