How hivecommons/hive works
Hive orchestrates open-source contribution work: it discovers GitHub issues and pull requests, classifies and schedules them, dispatches agents, and governs resulting changes. Its major runtime branches also include operator controls and fleet coordination. The README documents the end-to-end work pipeline; sampled source confirms agent launching and dashboard/TUI behavior, but does not expose every caller, so uncertain wiring is omitted.
Main entry points: main.go Hive runtime · server.go Web dashboard · manager.go Agent manager · client.go GitHub client
Components 22
Work orchestration
- Hive runtime
src/cmd/hive/main.go - Hive config
src/pkg/config/config.go - Issue intake
src/pkg/github/issue_admitter.go - Work classification
src/pkg/classify/classifier.go - Cadence governor
src/pkg/governor/governor.go - Work knowledge
src/pkg/beads/beads.go
Agent runtime
- Agent manager
src/pkg/agent/manager.go - Agent launcher
src/pkg/agent/manager_launch.go
GitHub workflow
- GitHub client
src/pkg/github/client.go - Pull request handling
src/pkg/github/pullrequest.go - Merge gating
src/pkg/github/merge_ci_gate.go - Advisories
src/pkg/advisory/advisory.go - Change convergence
src/pkg/convergence/convergence.go
Operator interfaces
- Web dashboard
src/pkg/dashboard/server.go - Terminal dashboard
src/pkg/tui/app.go - Hive CLI
src/pkg/hivectl/commands/root.go - Discord bot
src/pkg/discord/bot.go
Fleet and knowledge
- Fleet hub
src/pkg/hub/server.go - External work adapters
src/pkg/extwork/adapter.go
Other components
- Operator
- GitHub
- Agent backends
Connections 25
- Operator → Web dashboard: operates
- Operator → Terminal dashboard: operates
- Operator → Hive CLI: commands
- Hive runtime → Hive config: loads
- Hive runtime → Issue intake: orchestrates
- Issue intake → GitHub client: queries
- GitHub client → GitHub: calls
- Issue intake → Work classification: classifies
- Hive runtime → Cadence governor: schedules
- Cadence governor → Agent manager: dispatches
- Agent manager → Agent launcher: launches
- Agent launcher → Agent backends: starts
- Agent manager → Pull request handling: coordinates
- Pull request handling → GitHub client: uses
- Merge gating → GitHub client: checks
- Hive runtime → Merge gating: governs
- Hive runtime → Advisories: coordinates
- Hive runtime → Change convergence: coordinates
- Hive runtime → Work knowledge: persists work
- Web dashboard → Agent manager: controls and observes
- Terminal dashboard → Web dashboard: uses API
- Hive CLI → Web dashboard: uses API
- Discord bot → Web dashboard: bridges status
- Fleet hub → External work adapters: coordinates
- GitHub → Fleet hub: fleet events