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@latest

Update with hipmmcode update. The 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 1.3.1
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).

Desktop 1.2.0

Desktop and CLI versions are independent. The current desktop release is 1.2.0, tag desktop-v1.2.0, and it bundles CLI v1.2.0. Download it from the downloads page and check SHA256SUMS before installing. hipmmcode update replaces the CLI only, and GitHub Latest for the CLI is also v1.2.0. This desktop release has no Windows installer.

System	Package	Signing
macOS Apple Silicon	aarch64-apple-darwin-HiPMMCode_1.2.0_aarch64.dmg	Developer ID signed, not notarized. Check SHA-256 before opening. Gatekeeper may ask on first launch
macOS Intel	x86_64-apple-darwin-HiPMMCode_1.2.0_x64.dmg	Developer ID signed, not notarized. Check SHA-256 before opening. Gatekeeper may ask on first launch
Linux x64	x86_64-unknown-linux-gnu-HiPMMCode_1.2.0_amd64.AppImage and the matching .deb	Unsigned

When the phone asks the desktop app for files:

• One matched file is sent immediately.
• Two or more matches wait. Name one file, or tap its name, and only that file is sent.
• “所有”, “都发”, or several full filenames sends that set.
• “其他的也发” or “剩下的也发” sends the files from this choice that have not gone out yet.
• If the request does not say which files, the app asks and sends nothing until you confirm. A different sentence cancels the choice and is answered as a normal message.
• A shorter name nested inside a longer filename counts as the longer file only. A rejected send is reported.

Files the phone asks the agent to generate are returned from that agent's workspace. If a tool writes outside the workspace, the desktop copies that file in and then sends it. Sensitive paths such as .ssh, .aws, and keychains are not sent.

After LocalScribeBot is installed, meeting-notes status is ready without an extra configure click. Returning to the start page reattaches a local runtime that is already running.

Updating

hipmmcode update           # self-update the CLI to GitHub Latest (currently v1.3.1)
hipmmcode update --check   # only report whether a newer CLI 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)