Segments ships as a single binary named sg. The install scripts download a pre-built binary for your platform and fall back to building from source when none is available.

macOS / Linux

curl -fsSL https://git.nocfa.net/NocFA/segments/raw/branch/main/scripts/install.sh | bash

Windows

powershell -ExecutionPolicy Bypass -Command "irm https://git.nocfa.net/NocFA/segments/raw/branch/main/scripts/install.ps1 | iex"

Installs to %USERPROFILE%\.local\bin and adds it to the user PATH. If a source build is needed, the script auto-installs Go and MinGW-w64 via winget.

From source

git clone https://git.nocfa.net/NocFA/segments.git
cd segments
make install

Quick start

sg setup    # configure integrations (Pi, Claude Code, OpenCode)
sg start    # start the server

Then open http://localhost:8765 for the web UI, and sg init inside a project directory to start tracking it. sg setup is the required first step — it wires the MCP server and editor integrations.