How nick040791/sourcehub works
SourceHub is a self-hosted forge for a local repository collection. The operator uses its web UI to browse and manage repositories, work on Git changes, handle issues and pull requests, run local workflows, and delegate coding or reviews to Helper. The daemon routes HTTP and Git Smart HTTP requests to backend capabilities, which use SQLite, local Git repositories, and optional AI providers. The README documents capabilities beyond the sampled excerpts; uncertain internal routing is not expanded into finer call chains.
Main entry points: api.ts API Client · agentService.ts Agent Service · vitePluginGitApi.ts API And Git Router · workflowService.ts Workflow Runner
Components 22
Operator Surface
- Forge UI
src/App.tsx - API Client
src/services/api.ts
Forge Workflows
- Git Workbench
src/components/desktop/DesktopView.tsx - Issue Tracker
src/components/issues/IssuesView.tsx - Pull Requests
src/components/pr/PullRequestsView.tsx - Actions UI
src/components/actions/ActionsView.tsx - Helper UI
src/components/agents/AgentsView.tsx - Security And Settings
src/components/settings/SettingsView.tsx
Daemon Services
- HTTP Daemon
server/index.ts - API And Git Router
server/vitePluginGitApi.ts - Git Service
server/gitService.ts - Workflow Runner
server/workflowService.ts - Agent Service
server/agentService.ts - AI Provider Service
server/aiProviderService.ts - Auth And Crypto
server/auth.ts - Webhook Service
server/webhookService.ts
Local State And Integrations
- SQLite
server/db.ts - Git Repositories
- Workflow Definitions
.sourcehub/workflows
Other components
- Operator
- Git CLI
- Ollama / AI API
Connections 28
- Operator → Forge UI: uses
- Git CLI → HTTP Daemon: Git Smart HTTP
- Forge UI → API Client: requests
- API Client → HTTP Daemon: HTTP API
- HTTP Daemon → API And Git Router: routes requests
- API And Git Router → Git Service: dispatches Git operations
- API And Git Router → Workflow Runner: dispatches workflows
- API And Git Router → Agent Service: dispatches agent tasks
- API And Git Router → Auth And Crypto: checks access
- Git Workbench → API Client: requests Git actions
- Issue Tracker → API Client: requests issue actions
- Pull Requests → API Client: requests PR actions
- Actions UI → API Client: requests workflow runs
- Helper UI → API Client: requests agent tasks
- Security And Settings → API Client: manages settings
- Git Service → Git Repositories: reads and writes
- Workflow Runner → Git Service: reads repository
- Workflow Runner → Workflow Definitions: loads definitions
- Agent Service → Git Service: uses worktrees
- Agent Service → Workflow Runner: runs workflows
- Agent Service → AI Provider Service: requests completions
- AI Provider Service → Ollama / AI API: calls provider
- Agent Service → Webhook Service: dispatches events
- Git Service → SQLite: persists forge data
- Workflow Runner → SQLite: stores run records
- Agent Service → SQLite: stores run and PR data
- AI Provider Service → SQLite: stores provider settings
- Auth And Crypto → SQLite: uses credentials