Install¶

contextd is a single static binary — no runtime, no daemon required, no external services for the default setup.

After installing, run contextd init for guided setup. The install scripts offer to do that for you.

Installed before the move to ORKCOM?

The project moved to the orkcom-tech organisation. A tap or bucket added under the old owner still resolves, but no longer receives updates — so brew upgrade will quietly keep you on an old version rather than tell you anything is wrong. Repoint it once:

# Homebrew
brew untap abyssmemes/tap
brew tap orkcom-tech/tap
brew install orkcom-tech/tap/contextd

# Scoop
scoop bucket rm contextverse
scoop bucket add contextverse https://github.com/orkcom-tech/scoop-bucket
scoop update contextd

The winget package is now OrkcomTech.Contextd; an install from the old identifier will not upgrade across the rename, so reinstall from the new one. Installs from install.sh, install.ps1 or a release archive need nothing — they fetch from the repository, and GitHub redirects the old path.

Your context space is untouched by any of this. ~/.context is yours and knows nothing about where the binary came from.

macOS¶

Homebrew (recommended)Install script

brew tap orkcom-tech/tap
brew install orkcom-tech/tap/contextd

Our own tap — not homebrew-core. Source: orkcom-tech/homebrew-tap.

curl -fsSL https://raw.githubusercontent.com/orkcom-tech/contextverse/main/scripts/install.sh | bash

Linux¶

Install scriptdeb / rpm

curl -fsSL https://raw.githubusercontent.com/orkcom-tech/contextverse/main/scripts/install.sh | bash

Every release publishes .deb and .rpm packages (GoReleaser nFPM). Grab the one for your architecture from Releases.

sudo dpkg -i contextd_*_amd64.deb     # Debian / Ubuntu
sudo rpm -i contextd_*_x86_64.rpm     # Fedora / RHEL

Pin a specific version:

CONTEXTD_VERSION=v0.1.0 bash -c \
  "$(curl -fsSL https://raw.githubusercontent.com/orkcom-tech/contextverse/main/scripts/install.sh)"

Windows¶

Scoop (recommended)Install script

scoop bucket add contextverse https://github.com/orkcom-tech/scoop-bucket
scoop install contextd

irm https://raw.githubusercontent.com/orkcom-tech/contextverse/main/scripts/install.ps1 | iex

Winget manifests exist as templates under packaging/winget/; submission to winget-pkgs is still a manual PR.

Go¶

go install github.com/orkcom-tech/contextverse/cmd/contextd@latest

From source¶

git clone https://github.com/orkcom-tech/contextverse.git
cd contextverse
make build          # → bin/contextd
make install
go test ./...

Needs a recent Go toolchain. No cgo.

Verify¶

contextd version

Then set up shell completion, so the command groups are discoverable as you type:

zshbashfishPowerShell

contextd completion zsh > "${fpath[1]}/_contextd" && compinit

contextd completion bash | sudo tee /etc/bash_completion.d/contextd

contextd completion fish > ~/.config/fish/completions/contextd.fish

contextd completion powershell | Out-String | Invoke-Expression

Next¶

contextd init

See the Quickstart.

Running as a service¶

Only needed if you are hosting a server for a team.

Linux (systemd)macOS (launchd)Windows (SCM)

contextd server unit --server-dir /srv/contextverse | sudo tee /etc/systemd/system/contextd.service
sudo systemctl enable --now contextd

Use deploy/contextd.plist.

From an Administrator shell, after contextd init server:

contextd server service install --server-dir $env:USERPROFILE\.contextverse-server
contextd server service start
# later: contextd server service stop | uninstall

Details: deploy/contextd.winservice.md.

Containers and Kubernetes: see Deploy.

Repo	Role
`contextverse-templates`	Context-space and client-integration templates (Apache-2.0)
`homebrew-tap`	Homebrew formula
`scoop-bucket`	Scoop manifest