wiki / segments / overviewedited 2026-07-19
Segments

A performant, lightweight, single-binary task and project manager, written in Go. Built as a faster, leaner alternative to Beads: same job, LMDB under the hood, no Dolt, no fuss. One binary carries the CLI, a live web UI, and an MCP server for AI coding agents.

Synopsis

sg <command> [flags]

Why

Beads is slow, heavy, and leans on a Dolt DB infrastructure that is miserable to live with. Segments keeps the idea — projects, tasks, priorities, dependency chains — and drops the weight. It is especially nice for solo power users, but nothing stops you from reverse-proxying the dashboard for a team, or orchestrating downstream actions off its state.

Surfaces

cliThe primary interface — see commands and the daily workflow.web-uiLive three-theme dashboard served from the binary — see web UI.mcpTask tools for Claude Code, OpenCode, and Pi — see MCP server.

Features

  • Projects and tasks with priorities, statuses, dependency chains, and rich-text bodies
  • Three interchangeable web themes (Obsidian, Console, Dossier), each with light and dark modes
  • Three views: grouped List, drag-and-drop Kanban, and a top-down dependency Graph
  • Real-time updates over WebSocket — edits from another tab, the CLI, or an MCP agent show up live
  • Command palette and full keyboard-first navigation
  • sg next to pick the best unblocked task, sg stats for a progress dashboard, sg export for JSONL snapshots
  • Beads import for migrating an existing backlog

Status

Work in progress, but stable enough for daily use. Release series so far: 0.1 foundation (LMDB storage, core CLI, first MCP integrations, basic web UI), 0.2 TUI ergonomics and Windows support, 0.3 the three-theme GUI with Graph/Kanban/List views, 0.4 (current) MCP and session polish — globally addressable task IDs, SessionStart hooks, a stdio shim for multi-client MCP. 0.5 targets optimisation, 0.6 GUI polish.

Start with install.

segments card ↗ install →