Skip to content

Reading the repo

Opening the box…

How to install Pi-Bolt on macOS (opensec-git/Pi-Bolt) · gitmanual

How to install on macOS

opensec-git/Pi-Bolt

⚡ Pi, the coding agent, compiled ahead of time to one native executable. 10× faster to start, 7× less CPU and 4.5× less memory than Pi on Node. Linux, macOS, Windows, ARM64 and Android (Termux).

Node.js#ahead-of-time#ai-agent#ai-coding-assistant#android

Difficulty: Easy
Time: about 5 min
Stars: ★ 730
Activity: Updated this month
License: MIT
Open issues: 14
Got it running: Be the first
Looked up: 9 h ago

Saved setup from 9 h ago

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change today. Latest release bolt-v1.1.2, today.
Can I trust it?: Some track record730 stars. Get it from the official repo and read what it installs.

Start here

Website ↗pi-bolt.opensec.inThe project's own site.

Setup script in the repo

The maintainers included install.sh. Run it from the cloned folder after reading it.

bash install.sh

Also: install.ps1

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

macOS Windows Linux

Download for macOS

Pi-Bolt 1.1.2 · 11/6/2026 ↗

pi-bolt-runtime-darwin-arm64.tar.gz

tar.gz · Apple Silicon · 30.1 MB · 36 downloads · best match

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/opensec-git/Pi-Bolt/releases/download/bolt-v1.1.2/pi-bolt-runtime-darwin-arm64.tar.gz"
tar -xzf "pi-bolt-runtime-darwin-arm64.tar.gz"

Other macOS downloads (5)

pi-bolt-darwin-arm64-jit.tar.gz

tar.gz · Apple Silicon · 81.6 MB · 2 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/opensec-git/Pi-Bolt/releases/download/bolt-v1.1.2/pi-bolt-darwin-arm64-jit.tar.gz"
tar -xzf "pi-bolt-darwin-arm64-jit.tar.gz"

pi-bolt-darwin-arm64.tar.gz

tar.gz · Apple Silicon · 81.6 MB · 11 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/opensec-git/Pi-Bolt/releases/download/bolt-v1.1.2/pi-bolt-darwin-arm64.tar.gz"
tar -xzf "pi-bolt-darwin-arm64.tar.gz"

pi-bolt-kit-darwin-arm64.tar.gz

tar.gz · Apple Silicon · 7.5 MB · 19 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/opensec-git/Pi-Bolt/releases/download/bolt-v1.1.2/pi-bolt-kit-darwin-arm64.tar.gz"
tar -xzf "pi-bolt-kit-darwin-arm64.tar.gz"

pi-bolt-darwin-arm64-jit.tar.xz

tar.xz · Apple Silicon · 45.4 MB · 3 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/opensec-git/Pi-Bolt/releases/download/bolt-v1.1.2/pi-bolt-darwin-arm64-jit.tar.xz"
tar -xJf "pi-bolt-darwin-arm64-jit.tar.xz"

pi-bolt-darwin-arm64.tar.xz

tar.xz · Apple Silicon · 45.5 MB · 15 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/opensec-git/Pi-Bolt/releases/download/bolt-v1.1.2/pi-bolt-darwin-arm64.tar.xz"
tar -xJf "pi-bolt-darwin-arm64.tar.xz"

Install with a package manager

install script

curl -fsSL https://pi-bolt.opensec.in/install.sh | sh

Pipes a remote script into your shell. Read it before running.

Homebrew

brew install opensec-git/tap/pi-bolt

npm

npm install -g --allow-scripts=pi-bolt pi-bolt

npm

bun add -g --trust pi-bolt

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js >=22.19.0runtime
1×npm package manager

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/opensec-git/Pi-Bolt/badge.svg)](https://gitmanual.com/opensec-git/Pi-Bolt)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: npm/package.json, packages/agent/package.json, packages/ai/package.json, packages/chord/package.json and 11 more

package.json scripts (44)

cleannpm run clean --workspaces
buildcd packages/telemetry && npm run build && cd ../schema && npm run build && cd ../chord && npm run build && cd ../tui && npm run build && cd ../codemode && npm run build && cd ../mcp && npm run build && cd ../ai && npm run build && cd ../durable && npm run build && cd ../env && npm run build && cd ../agent && npm run build && cd ../coding-agent && npm run build
build:offlinecd packages/telemetry && npm run build && cd ../schema && npm run build && cd ../chord && npm run build && cd ../tui && npm run build && cd ../codemode && npm run build && cd ../mcp && npm run build && cd ../ai && npm run build:offline && cd ../durable && npm run build && cd ../env && npm run build && cd ../agent && npm run build && cd ../coding-agent && npm run build
build:native:darwinnpm --prefix packages/tui run build:native:darwin
build:native:linuxnpm --prefix packages/tui run build:native:linux
build:native:win32npm --prefix packages/tui run build:native:win32
checknpm run generate:catalog-modules && node scripts/biome-check.mjs --write && npm run check:pinned-deps && npm run check:runtime-deps && npm run check:ts-imports && npm run check:entry-graphs && npm run check:install-lock:coding-agent && tsc --noEmit && tsc --noEmit -p packages/coding-agent/examples/tsconfig.json && npm run check:browser-smoke
check:browser-smokenode scripts/check-browser-smoke.mjs
check:pinned-depsnode scripts/check-pinned-deps.mjs
check:runtime-depsnode scripts/check-runtime-deps.mjs
check:package-installnode scripts/check-package-install.mjs
check:install-lock:coding-agentnode scripts/generate-coding-agent-install-lock.mjs --check
check:ts-importsnode scripts/check-ts-relative-imports.mjs
check:entry-graphsnode scripts/check-entry-graphs.mjs
generate:modelsnpm --prefix packages/ai run generate-models
generate:catalog-modulesnpm --prefix packages/ai run generate-catalog-modules
hydrate:model-datanpm --prefix packages/ai run hydrate-model-data
check:model-datanpm --prefix packages/ai run check:model-data
generate:model-catalognpm --prefix packages/ai run generate-model-catalog
diff:model-catalognode scripts/diff-model-catalog.mjs
update:model-catalog-pinnode scripts/update-model-catalog-pin.mjs
evalnpm run eval --workspace=@earendil-works/pi-evals --
check:model-catalognode scripts/publish-model-catalog.mjs --input .artifacts/model-catalog --dry-run
check:model-catalog-compatnode scripts/check-model-catalog-compat.mjs
profile:tuinode scripts/profile-coding-agent-node.mjs --mode tui

Files we read (9)

.github/workflows/android.yml

.github/workflows/ci.yml

.github/workflows/codeql.yml

.github/workflows/heap-profile.yml

.github/workflows/publish.yml

.github/workflows/release.yml

README.md

docs/BUILDING.md

package.json

Branch pi-bolt · 3,979 files in the repo