sidequests

Track all your side projects — health, status, and AI summaries — completely hands-off.

npx @eeshans/sidequests

Requirements: Node.js 20.9+ and git. For GitHub integration: GitHub CLI (gh auth login). For LLM enrichment: Claude Code or Codex CLI. Local models & OpenRouter coming soon.

What it does

Sidequests scans your dev directory, discovers every git repo, and builds a dashboard with:

• Actionable next steps — LLM-powered summaries, next actions, and insights for every project
• GitHub at a glance — open issues, PRs, and CI status pulled from gh CLI
• Status tracking — active, paused, stale, or archived based on commit history
• Git state — dirty files, unpushed commits, current branch

Everything runs locally. Your code never leaves your machine.

Features

| | | |---|---| | Fast Scan | Folders, LOC, git history, GitHub issues/PRs/CI — completes in seconds | | AI Scan | Fast scan + LLM-powered summaries, next actions, insights, tags | | GitHub Integration | Open issues, PRs, CI status, repo visibility via gh CLI | | Smart Status | Classifies projects as active, paused, stale, or archived | | Git Aware | Dirty state, ahead/behind, branch tracking | | Live Refresh | SSE-based streaming progress with real-time activity log | | Pin & Override | Pin favorites, manually override any metadata | | Dark Mode | Automatic or manual theme switching |

LLM providers

LLM enrichment powers the core experience — summaries, next actions, and insights. Configure a provider in Settings to unlock these features:

| Provider | What you need | |---|---| | Claude Code | Claude Code installed and authenticated | | Codex CLI | Codex CLI installed, "Allow Unsafe" enabled | | OpenRouter | Coming soon | | Ollama | Coming soon | | MLX | Coming soon |

CLI options

npx @eeshans/sidequests [options]

--port <n>    Use a specific port (default: auto)
--no-open     Don't open the browser
--help        Show help
--version     Show version

Troubleshooting

| Problem | Fix | |---|---| | "git not found" in preflight | Install git — brew install git or git-scm.com | | Scan finds 0 projects | Make sure Dev Root points to a folder containing git repos | | No GitHub data | Install and authenticate gh — brew install gh && gh auth login | | LLM enrichment fails | Check provider config in Settings, make sure API key or CLI is set up | | No summaries/next actions | Configure an LLM provider in Settings | | Database errors | Delete ~/.sidequests/dev.db and restart |

Contributing

git clone https://github.com/eeshansrivastava89/sidequests.git
cd sidequests
npm install
npm run setup    # creates DB + default settings
npm run dev      # http://localhost:3000

See CONTRIBUTING.md for full guidelines.

Architecture

~/dev repos ➜ enumerate ➜ [scan ➜ derive ➜ store ➜ GitHub] ➜ [LLM one-by-one] ➜ API ➜ dashboard
              pass 1: all projects (fast)             pass 2: sequential

Built with Next.js 16, Prisma 7 + SQLite, React 19, shadcn/ui, and Tailwind CSS.

License

MIT