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 on first use.

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