Installation

Quick Install (Recommended)

The easiest way to install Terramind on macOS or Linux:

curl -fsSL https://terramind.com/install | bash

This script will automatically:

Detect your operating system and architecture
Download the correct binary
Install it to the appropriate location
Make it available in your PATH

After installation, restart your terminal and verify:

terramind --version

Package Managers

Alternatively, install via your preferred package manager:

npm install -g terramind

pnpm add -g terramind

yarn global add terramind

bun add -g terramind

Platform-Specific Installation

macOS

Homebrew

brew tap terramind-com/tap
brew install terramind-com/tap/terramind

Install Script

curl -fsSL https://terramind.com/install | bash

Linux

Install Script (Recommended)

curl -fsSL https://terramind.com/install | bash

Manual Download

curl -LO https://registry.npmjs.org/terramind-linux-arm64/-/terramind-linux-arm64-VERSION.tgz
tar -xzf terramind-linux-arm64-VERSION.tgz
sudo mv package/bin/terramind /usr/local/bin/

curl -LO https://registry.npmjs.org/terramind-linux-x64/-/terramind-linux-x64-VERSION.tgz
tar -xzf terramind-linux-x64-VERSION.tgz
sudo mv package/bin/terramind /usr/local/bin/

Windows

Chocolatey

choco install terramind

Scoop

scoop bucket add extras
scoop install extras/terramind

npm

npm install -g terramind

Verify Installation

After installation, verify that Terramind is working:

terramind --version

You should see the version number displayed.

Updating Terramind

Using Install Script

curl -fsSL https://terramind.com/install | bash

Using Package Managers

npm update -g terramind

pnpm update -g terramind

yarn global upgrade terramind

bun update -g terramind

brew upgrade terramind-com/tap/terramind

choco upgrade terramind

scoop update terramind

Using Built-in Upgrade Command

terramind upgrade

This will check for updates and upgrade to the latest version.

System Requirements

Operating System: macOS, Linux, or Windows
Architecture: ARM64 or x64
Node.js: 18.x or higher (only for npm installation)

Troubleshooting

Command not found

If you get a “command not found” error after installation:

Make sure the installation completed successfully
Try closing and reopening your terminal
Check that the binary is in your PATH
Run the install script again: curl -fsSL https://terramind.com/install | bash

Permission denied

If you encounter permission errors:

The install script handles permissions automatically
For npm installations, try using sudo for global installations
Or install without -g flag in a local project
Consider using a Node version manager (nvm, fnm) to avoid permission issues

Version mismatch

If the version command shows an old version:

Clear package cache: npm cache clean --force
Uninstall: npm uninstall -g terramind
Reinstall using the install script: curl -fsSL https://terramind.com/install | bash

Quick Install (Recommended)

Package Managers

Platform-Specific Installation

macOS

Homebrew

Install Script

Linux

Install Script (Recommended)

Manual Download

Windows

Chocolatey

Scoop

npm

Verify Installation

Updating Terramind

Using Install Script

Using Package Managers

Using Built-in Upgrade Command

System Requirements

Troubleshooting

Next Steps

Quick Start

CLI Commands

​Quick Install (Recommended)

​Package Managers

​Platform-Specific Installation

​macOS

​Homebrew

​Install Script

​Linux

​Install Script (Recommended)

​Manual Download

​Windows

​Chocolatey

​Scoop

​npm

​Verify Installation

​Updating Terramind

​Using Install Script

​Using Package Managers

​Using Built-in Upgrade Command

​System Requirements

​Troubleshooting

​Next Steps

Quick Start

CLI Commands

Quick Install (Recommended)

Package Managers

Platform-Specific Installation

macOS

Homebrew

Install Script

Linux

Install Script (Recommended)

Manual Download

Windows

Chocolatey

Scoop

npm

Verify Installation

Updating Terramind

Using Install Script

Using Package Managers

Using Built-in Upgrade Command

System Requirements

Troubleshooting

Next Steps