🐕 Gitea IssueHound

Sniff out issue dependencies — Interactive dependency graph visualizer for Gitea

Implements Gitea Feature Request #20838 — Issue dependency graph as an external tool

📖 日本語 | 中文 | 한국어

---

Why IssueHound?

Gitea lets you set dependencies between issues, but there's no way to see the big picture.

IssueHound turns dependency data into an interactive graph:

• 🔴 Find bottlenecks — High-dependency nodes glow red
• 🔗 Trace chains — See what blocks what at a glance
• 🏝️ Spot orphans — Unconnected issues separated automatically
• 🏢 Org-wide view — Cross-repository dependency map

---

Features

Feature	Description
📊 Dependency graph	D3.js force-directed + DAG hierarchical layout
🔍 Filters	ALL / OPEN / CLOSED state toggle
🏢 Cross-repo	Visualize dependencies across all org repositories
📋 Detail panel	Click a node to preview body, labels, assignees
🔴 Priority coloring	Nodes colored by inbound dependency count
🏝️ Orphan separation	Unconnected issues aligned on the right
⌨️ Keyboard shortcuts	R, F, 1-3, Q/W, Esc
🌐 8 languages	EN, JA, ZH, KO, DE, FR, ES, RU
🔒 Security	CSP, rate limiting, token protection
🐳 Docker	One-command setup

---

Quick Start

Docker (recommended)

git clone https://github.com/Resolver-TNG/gitea-issuehound.git
cd gitea-issuehound
cp .env.example .env
# Edit .env — set GITEA_URL and GITEA_TOKEN
docker compose up -d

Open http://localhost:3100

Node.js

npm install
GITEA_URL=http://your-gitea:3000 GITEA_TOKEN=your_token node server.js

---

Environment Variables

Variable	Required	Default	Description
GITEA_URL	✅	—	Gitea instance URL
GITEA_TOKEN	✅	—	API token (⚠️ read-only recommended)
PORT	—	3100	Server port
CACHE_TTL	—	300	Cache TTL in seconds
ADMIN_TOKEN	—	—	Auth token for cache clear API

---

Screenshots

DAG hierarchical layout — 10 issues, 5-layer dependency chain from Database → Release

---

Keyboard Shortcuts

Key	Action
R	Refresh data (bypass cache)
F	Fit graph to view
1 / 2 / 3	Filter: ALL / OPEN / CLOSED
Q / W	Layout: Force / DAG
Esc	Close detail panel

---

API

Method	Path	Description
GET	/api/health	Health check
GET	/api/repos	Repository list
GET	/api/repos/:owner/:repo/graph	Dependency graph
GET	/api/orgs/:org/graph	Org-wide dependency graph
DELETE	/api/cache	Clear cache (ADMIN_TOKEN auth)

Query params: ?state=open|closed|all ?refresh=true

---

Tech Stack

Layer	Technology
Backend	Node.js 22+ / Express 5
Graph	D3.js v7 + dagre
Frontend	Vanilla ES Modules
Container	Docker (node:22-alpine)
Design	Industrial HUD Design System

---

Requirements

• Gitea 1.20+ (dependency API support)
• Node.js 22+ or Docker

---

Development

npm install
GITEA_URL=http://your-gitea:3000 GITEA_TOKEN=your_token node server.js

# Docker dev mode (live reload via volume mount)
docker compose -f docker-compose.dev.yml up -d

# Deploy to NAS
./deploy.sh           # sync only (instant)
./deploy.sh --rebuild # rebuild image

---

Security

See SECURITY.md. GITEA_TOKEN should have read-only permissions only.

---

License

MIT — Resolver-TNG

---

Built by 404-squad 🦊