Installation

hipmmcode ships as prebuilt binaries for macOS (Apple Silicon & Intel), Linux (x64 & arm64), and Windows (x64).

curl (macOS / Linux — recommended)

curl -fsSL https://github.com/HiPMMAI/hipmmcode/releases/latest/download/install.sh | bash

Installs to ~/.local/bin/hipmmcode and prints a PATH hint if needed.

Homebrew (macOS)

brew tap hipmmai/hipmmcode https://github.com/HiPMMAI/hipmmcode
brew install hipmmcode

npm

npm install -g @hipmmai/hipmmcode

The npm wrapper downloads the matching platform binary on install, then syncs the L1 default skills pack into ~/.hipmmcode/skills/ when the tarball includes default-skills/ (v0.14.1+). See Skills — default pack.

Windows (PowerShell)

irm https://github.com/HiPMMAI/hipmmcode/releases/latest/download/install.ps1 | iex

Requires Windows 10+ and PowerShell 5.1+. Installs to %USERPROFILE%\.local\bin\hipmmcode.exe — the same relative location as on macOS/Linux.

If installation succeeds but the current PowerShell window cannot find hipmmcode or run hipmmcode model, either open a new terminal or refresh the current session immediately:

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
hipmmcode --version
hipmmcode model

Windows terminal

hipmmcode works in the legacy console, but Windows Terminal gives the best fullscreen-TUI experience (proper VT rendering, fonts, and mouse support).

Manual

Grab a tarball from the Releases page, verify it against SHA256SUMS, untar, and put hipmmcode on your PATH.

Asset	Platform
hipmmcode-darwin-universal.tar.gz	macOS — runs on both Apple Silicon and Intel
hipmmcode-darwin-arm64.tar.gz	macOS Apple Silicon only
hipmmcode-darwin-x64.tar.gz	macOS Intel only
hipmmcode-linux-x64.tar.gz	Linux x86-64 (static musl — no libc requirements)
hipmmcode-linux-arm64.tar.gz	Linux arm64 (static musl)
hipmmcode-windows-x64.tar.gz	Windows x64

shasum -a 256 -c SHA256SUMS      # verify
tar -xzf hipmmcode-<platform>.tar.gz
# Keep default-skills/ next to the binary (v0.14.1+) — do not install only the binary file
mv hipmmcode ~/.local/bin/
# optional: keep pack beside a versioned install dir so first-launch sync finds it

Release layout (v0.14.1+):

hipmmcode              # executable
default-skills/        # L1 pack (docx, pptx, design skills, …)
LICENSE.txt

After any install channel, you can force-sync skills:

hipmmcode skill install-defaults

Verify

hipmmcode --version    # e.g. hipmmcode 0.18.0
hipmmcode doctor       # environment diagnosis: keys, config path, MCP/skills counts
hipmmcode skills       # list skills (L0 + L1 user dir + project)

First launch also seeds ~/.hipmmcode/settings.json with permissions.defaultMode: "auto" when the file is missing (see Permissions).

Updating

hipmmcode update           # self-update to the latest release (verified, atomic replace)
hipmmcode update --check   # only report whether a newer version exists

brew upgrade hipmmcode and re-running the curl installer also work.

Config is preserved on update (config.json, settings.json, sessions). New defaults (Auto mode seed, default skills sync) apply without wiping your keys. They do not re-import old one-shot allow lists from the package.

Uninstall

rm ~/.local/bin/hipmmcode                    # curl / manual install
brew uninstall hipmmcode                     # Homebrew
npm uninstall -g @hipmmai/hipmmcode      # npm
rm -rf ~/.hipmmcode                          # optional: remove all user data (config, sessions, memory)