A personal, single-user development command board. DevHub pulls open GitHub issues from
your repos, shows them as cards on a board, and lets you dispatch an opencode
session on code.lehel.xyz to implement an issue and open a pull request — with all status
streamed live to the UI.
Strictly personal. Access is gated by GitHub OAuth: only members of the
bumblefliesorg can sign in.
- Sign in — GitHub OAuth (scopes
repo+read:org). The callback only creates a session if you're a member ofGITHUB_ALLOWED_ORG; the org membership is re-checked on each refresh. - Ingest —
POST /api/issues(Refresh) fetches open issues from all repos you can access whose GitHub topics intersectGITHUB_TOPICS(PRs and bot-authored issues are skipped). - Board — each project draws one funnel:
idea(shaping topics) →ready(ready topics + backlog issues) →realizing(refinement + developing) →rollout(open PRs + released) — with delivered history collapsed below. Marking an idea ready files its GitHub issue automatically. - Develop — "Work" on a card calls
POST /api/issues/[id]/develop. The server runs a refinement check first (auto-refining unclear issues, surfacing blocking questions as "Needs input"), then implements and opens a PR. Failures keep the card in its stage withblocked_reason; the next Work click resumes. - Live status —
GET /api/streamis a Server-Sent Events feed the board subscribes to on load, so cards update without polling.
State lives entirely server-side in a SQLite database (better-sqlite3).
- Next.js 15 (App Router, React 19, TypeScript)
- SQLite via
better-sqlite3 undicifor opencode HTTP callsvitestfor tests
- Node.js >= 20
- A C toolchain (
make,g++,python3) —better-sqlite3is a native module - Tokens (see below)
cp .env.example .env
# edit .env with your OAuth app credentials and opencode settings
npm install
npm run devYou need a GitHub OAuth App (Settings → Developer settings → OAuth Apps) with
the callback URL set to GITHUB_REDIRECT_URI (default http://localhost:3000/api/auth/callback).
Scopes requested on login: repo (read/write your repos + issues) and read:org
(membership check). Localhost and production need separate apps — the callback URL
is fixed at app creation.
| Variable | Default | Purpose |
|---|---|---|
OPENCODE_BASIC_USER |
opencode |
Basic-auth user for code.lehel.xyz |
OPENCODE_BASIC_PASSWORD |
— | Basic-auth password for code.lehel.xyz |
OPENCODE_API_KEY |
— | X-Api-Key for local opencode servers |
OPENCODE_BASE_URL |
https://code.lehel.xyz |
opencode base URL |
GITHUB_CLIENT_ID |
— | OAuth App client ID |
GITHUB_CLIENT_SECRET |
— | OAuth App client secret |
GITHUB_REDIRECT_URI |
http://localhost:3000/api/auth/callback |
OAuth callback URL |
GITHUB_ALLOWED_ORG |
bumbleflies |
Only members of this org may sign in |
GITHUB_TOPICS |
gh-dash,dachrisch,bumbleflies |
Filter ingested repos by topic |
WORKSPACE_ROOT |
/home/cda/dev |
Where repos are checked out (no cloning) |
OPENCODE_WORKSPACE_ROOT |
/root/dev |
Workspace root as seen by the opencode agent |
DEVHUB_DB |
./devhub.db |
SQLite file (WAL mode) |
OPENCODE_ALLOW_INSECURE_TLS |
false |
Opt-in for self-signed opencode deployments only |
| Command | What it does |
|---|---|
npm run dev |
Next dev server |
npm run build |
Production build |
npm start |
Run the production build |
npm run typecheck |
tsc --noEmit |
npm run lint |
eslint . |
npm test |
vitest run |
Safe change order: typecheck → lint → test → build.
| Method | Route | Purpose |
|---|---|---|
GET |
/api/auth/login |
Start GitHub OAuth (redirect) |
GET |
/api/auth/callback |
OAuth callback (sets session, gates org) |
POST |
/api/auth/logout |
End session |
GET |
/api/auth/me |
Current signed-in user / null |
GET |
/api/issues |
List issues (auth required) |
POST |
/api/issues |
Refresh / ingest open issues (auth) |
GET |
/api/issues/[id] |
Issue detail + event log (auth required) |
POST |
/api/issues/[id]/develop |
Start an opencode session, returns 202 |
POST |
/api/topics/[id]/ready |
Mark an idea ready (auto-files its GitHub issue) |
POST |
/api/topics/[id]/realize |
Realize an idea hands-off (refine → build → merge), returns 202 |
GET |
/api/stream |
SSE feed of status + opencode events |
src/lib/{env,store,github,opencode,sse,develop,types,auth}.ts server logic
src/app/api/auth/... OAuth routes
src/app/api/... route handlers
src/app/(board)/page.tsx board UI
src/components/{logo,auth-ui,use-auth}.tsx UI components
src/components/board/{mobile-card,card-actions-sheet, mobile board UI (<768px) + shared
mobile-status-strip,mobile-search-sheet,use-card-actions, develop/transition logic
use-media-query,develop-modal}.tsx
docs/plans/2026-08-30-devhub-design.md design plan
docs/plans/2026-08-30-github-oauth-login.md auth plan
- Whether opencode on
code.lehel.xyzauto-approves tool calls, or needs a server-side setting /autoflag. - Whether opencode can see the
WORKSPACE_ROOT(/home/cda/dev) checkouts on the same host. - How the operator's OAuth token reaches opencode's
gh pr create(the develop prompt now assumes opencode's own authenticatedgh).
See docs/plans/2026-08-30-devhub-design.md for the full design.