A Claude-first personal knowledge base for ADHD brains. Claude writes and organises; GitHub is the storage layer.

Stack: SvelteKit PWA · Hono API · GitHub REST API (no git binary) · Claude Sonnet · Gemini Flash · Google OAuth

Ideas, plans, discussions and solutions are stored as Markdown files with YAML frontmatter in a private GitHub repository. The API maintains an in-memory index rebuilt on every PR merge via GitHub webhook. Claude handles reasoning and writing; Gemini handles summarisation and pattern detection.

Content lifecycle: capture → branch + PR → chat/refine → commit to main (merge).

All configuration is via environment variables. Copy .env.example to .env and fill in each value.

cp .env.example .env

Used for single-account authentication. Only the configured email address can sign in.

1. Go to Google Cloud Console → APIs & Services → Credentials
2. Create an OAuth 2.0 Client ID (application type: Web application)
3. Add an authorised redirect URI:
   • Local: http://localhost:8744/auth/callback
   • Production: https://your-domain.com/auth/callback (must match PUBLIC_URL below)

Used for all content storage. You need a private repository for the wiki data (separate from this code repository).

1. Create a private GitHub repo for data (e.g. yourname/minime-data) — leave it empty
2. Go to github.com/settings/tokens → Generate new token (classic)
3. Grant scopes: repo (full), delete:repo is not needed

Webhook setup (required for the index to refresh on merge):

1. Go to your data repo → Settings → Webhooks → Add webhook
2. Payload URL: https://your-domain.com/webhook (or http://host.docker.internal:8744/webhook for local testing via a tunnel)
3. Content type: application/json
4. Secret: the same value as GITHUB_WEBHOOK_SECRET
5. Events: select Pull requests only

Note: Anthropic API billing is separate from Claude Code subscription billing.

In production with a reverse proxy, set PUBLIC_URL and PWA_ORIGIN to your public HTTPS URLs and PUBLIC_API_URL to the same API URL the browser will use.

The recommended deployment is Docker Compose pulling pre-built images from GHCR. GitHub Actions builds and pushes new images on every push to main that touches apps/api/** or apps/web/**.

Images:

• ghcr.io/nokternol/minime-api:latest
• ghcr.io/nokternol/minime-web:latest

Create a docker-compose.prod.yml on your server:

services:
  api:
    image: ghcr.io/nokternol/minime-api:latest
    restart: unless-stopped
    ports:
      - "8744:8744"
    env_file: .env
    environment:
      API_PORT: "8744"

  web:
    image: ghcr.io/nokternol/minime-web:latest
    restart: unless-stopped
    ports:
      - "8743:8743"
    env_file: .env
    environment:
      PORT: "8743"
    depends_on:
      - api

Deploy:

# Pull latest images and restart
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

Reverse proxy: Point your reverse proxy (nginx, Caddy, Traefik) at ports 8743 (web) and 8744 (api). Both services must be reachable from the browser — the web app calls the API directly from the browser, not server-side.

GHCR authentication: If the repository is private, log in first:

echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdin

• Node.js 22+
• A .env file with all required values (see Configuration above)

npm install

Open two terminals:

# Terminal 1 — API (hot-reload)
cd apps/api
npm run dev

# Terminal 2 — Web (hot-reload)
cd apps/web
npm run dev

API is available at http://localhost:8744, web at http://localhost:8743.

For Google OAuth to work locally, http://localhost:8744/auth/callback must be in your Google OAuth client's authorised redirect URIs.

The skills/ directory contains Claude Code skills for the main workflows:

Tests cover the API only (unit + integration with mocked GitHub client).

# Run all tests
cd apps/api
npm test

# Run with coverage report
npm run test -- --coverage

Coverage is reported in the terminal. Key modules tested: frontmatter parsing, index builder, context assembler, auth middleware, content/lifecycle/chat routes.