Setup
Install
Install threadpoint
threadpoint is the free public project-scoped foundation. Current v0 install paths support Linux and macOS on amd64 and arm64.
Go install
Use the public Go module path when Go is available locally.
go install github.com/threadgrid/threadpoint/cmd/threadpoint@latest
Installer script
Download the public installer, inspect it, then run it. The installer verifies release checksums before installing.
curl -fsSLO https://raw.githubusercontent.com/threadgrid/threadpoint/main/scripts/install.sh sh install.sh
Release archive
Download archives only from official GitHub Releases and verify the matching checksums file before extracting.
sha256sum --check --ignore-missing checksums.txt
Prepare threadgrid
threadgrid is the paid product for personal and user-level memory, private project stores, cross-project archive, curation, recall, review, publication, and license-aware workflows as they ship. The v0 distribution baseline is the official installer backed by release archives with signed checksums, GitHub Artifact Attestations, and version metadata. Linux and macOS on amd64 and arm64 are the v0 threadgrid targets. Windows is deferred for v0. Homebrew and package-manager channels remain planned until their release tasks are complete.
Installer
Download the installer from the release tag, inspect it, then run it for the selected version. The installer verifies signed release metadata, checksums, and GitHub Artifact Attestations before writing installer metadata for future self-update and uninstall commands.
version=v0.1.0
curl -fsSLO "https://raw.githubusercontent.com/threadgrid/threadgrid/${version}/threadgrid/scripts/install.sh"
sh install.sh --version "$version"Release archive
Manual archive installs remain supported when you need to place the binary yourself. They are not installer-managed, so update by replacing the archive binary manually or re-run the installer to move onto the installer-managed path.
version=v0.1.0
archive=threadgrid_linux_amd64.tar.gz
curl -fsSLO "https://github.com/threadgrid/threadgrid/releases/download/${version}/${archive}"
curl -fsSLO "https://github.com/threadgrid/threadgrid/releases/download/${version}/checksums.txt"
curl -fsSLO "https://github.com/threadgrid/threadgrid/releases/download/${version}/checksums.txt.sig"
awk -v file="$archive" '$2 == file { print; found = 1 } END { if (!found) exit 1 }' checksums.txt | sha256sum --check -
tar -xzf "$archive" threadgridActivation
Download or extraction alone does not grant local access. Store the license key from the Polar order email in a local secret manager or shell environment. If the email is missing, use the customer portal link on this page to recover order and license details. The activation command validates the supplied key and writes a redacted local receipt; status still reads THREADGRID_LICENSE_KEY.
export THREADGRID_LICENSE_KEY="..." threadgrid license activate threadgrid license status
Planned channels
Homebrew, package-manager channels, SBOMs, and notarization remain planned work until their release and supply-chain tasks are complete.
Verify
Run local checks before changing shared agent files or trying paid threadgrid workflows. If THREADGRID_LICENSE_KEY is not set, the current threadgrid status check should return {"status":"unconfigured"}.
threadpoint validate --root . threadpoint doctor --root . threadgrid license status
Updates and removal
threadpoint and threadgrid update checks and self-update are explicit, user-driven commands for installer-managed installs. Manual threadgrid archive installs update by replacing the binary or by moving to the installer-managed path.
threadpoint update check threadpoint self-update --dir "$HOME/.local/bin" threadpoint uninstall --dir "$HOME/.local/bin" threadgrid update check threadgrid self-update --dir "$HOME/.local/bin" threadgrid uninstall --dir "$HOME/.local/bin"