Installation

Semantica is available for macOS and Linux (x86_64 and arm64). Windows is not currently supported.

Requirements:

• Git (any reasonably recent version)
• macOS or Linux
• At least one supported AI provider for capture

---

Homebrew (macOS)

The recommended method for macOS. Installs the binary plus shell completions for Bash, Zsh, and Fish automatically.

brew install semanticash/tap/semantica

To upgrade later:

brew upgrade semantica

---

Shell script (macOS / Linux)

Downloads and installs the latest release binary. Verifies the SHA-256 checksum before installing.

curl -fsSL https://semantica.sh/install.sh | sh

The script:

1. Detects your OS and architecture
2. Downloads the correct binary from GitHub Releases
3. Verifies the checksum against checksums.txt
4. Installs to the first writable directory on your $PATH, or ~/.local/bin as a fallback

To install a specific version:

VERSION=1.5.2 curl -fsSL https://semantica.sh/install.sh | sh

To install to a specific directory:

INSTALL_DIR=/usr/local/bin curl -fsSL https://semantica.sh/install.sh | sh

---

From source

Requires Go 1.26 or later.

git clone https://github.com/semanticash/cli.git
cd cli
make build      # binary at ./bin/semantica
make install    # installs to /usr/local/bin

---

Shell completions

Homebrew installs completions automatically. For shell script or source installs, load them from the CLI:

# Zsh
source <(semantica completion zsh)

# Bash
source <(semantica completion bash)

# Fish
semantica completion fish | source

# PowerShell
semantica completion powershell

To make completions permanent, add the appropriate line to your shell's config file (.zshrc, .bashrc, etc.).

---

Verify the installation

semantica --version

Expected output:

semantica v1.5.2 (abc1234)

---

Updating

Homebrew:

brew upgrade semantica

Shell script install: Re-run the install script. It will overwrite the existing binary.

Source: Pull the latest changes and rebuild with make build && make install.

---

Uninstalling

Semantica only places files in two locations: the binary itself, and .semantica/ directories inside any repos you've enabled. To fully remove it:

1. Disable Semantica in each repo: semantica disable
2. Remove the binary (e.g. brew uninstall semantica or rm $(which semantica))
3. Optionally remove the .semantica/ directories from your repos
4. Optionally remove ~/.config/semantica/ which holds authentication credentials