Skip to content

The127/hivetrack

Repository files navigation

Hivetrack

Hivetrack

Lean, self-hosted task planning for high-performing software teams.

A Jira alternative that helps the people doing the work — not the people watching it.
Fast, opinionated, open source.

hivetrack.vercel.app

Hivetrack preview

Quick start

just dev-deps   # start postgres
just dev        # start backend + frontend

Backend runs at http://localhost:8080, frontend at http://localhost:5173.

You'll need an OIDC provider for auth. Keyline is the recommended companion — see docs/architecture.md for setup.

Repository layout

hivetrack/       Go backend (HTTP API)
hivetrack-ui/    Vue 3 frontend
docs/            Architecture and design documentation
justfile         Task runner — run `just` to see all recipes

Development

just dev              # start everything locally
just test             # run all tests (no DB needed)
just check            # lint + tests — run before pushing
just install-hooks    # install git pre-push hook

Documentation

Doc Contents
docs/architecture.md System architecture, auth, deployment
docs/domain-model.md Full entity definitions and relationships
docs/engineering-principles.md TDD, patterns, coding conventions
docs/api-and-ai.md API design, webhooks, AI integration

MCP (AI integration)

Hivetrack ships an MCP server so AI assistants (Claude, Cursor, etc.) can read and write issues directly. Auth is handled automatically — the HTTP transport includes an OAuth proxy that redirects to your OIDC provider, and the local binary uses device flow.

Claude Code — one command installs and registers the server:

claude mcp add hivetrack -e HIVETRACK_URL=https://your-hivetrack -- npx hivetrack-mcp

If you already have the binary installed via Homebrew or Go:

claude mcp add hivetrack -e HIVETRACK_URL=https://your-hivetrack -- hivetrack-mcp

Other clients — install the binary first:

npx hivetrack-mcp                                                      # npm
brew install The127/tap/hivetrack-mcp                                  # Homebrew
go install github.com/the127/hivetrack/mcp/cmd/hivetrack-mcp@latest   # Go

Then add it to your client's MCP config with HIVETRACK_URL pointing at your instance. Refer to your client's documentation for the exact config format.

Stack

Backend: Go 1.24 · PostgreSQL · CQRS + mediator · IoC DI Frontend: Vue 3 · Vite · TanStack Query · Tailwind CSS v4 Auth: OIDC — Keyline, Keycloak, Authentik, or any compliant provider

About

Lean, self-hosted task planning for high-performing software teams.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors