Install

Prerequisites

• Node.js 22.5+ (node --version to check)
• A user-managed Node install such as Homebrew, nvm, or Volta if you want npm install -g to work without sudo
• Git (for source install)
• Optional: Flutter SDK (for mobile app development)

From npm

For the default Codex path:

npm install -g sidemesh @openai/codex

From Source

git clone https://github.com/mukhtharcm/sidemesh.git
cd sidemesh
npm install
npm run build
npm link

npm link makes sidemesh available as a global CLI command.

Verify Installation

sidemesh --help
sidemesh up --help

On first run, sidemesh up auto-detects ready providers on the machine and defaults to Codex when it is ready.

Provider Prerequisites

Codex

npm install -g @openai/codex

Pi

npm install -g @mariozechner/pi-coding-agent
pi /login          # authenticate
pi /model          # select default model

Copilot

Install GitHub Copilot CLI and authenticate via gh auth login.

Install Troubleshooting

• If npm install -g fails with EACCES, switch to a user-managed Node install or configure a user-local npm prefix before retrying.
• If you see Unsupported engine or ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite, upgrade Node to 22.5 or newer and rerun the install.

Build the Mobile App

cd apps/mobile
flutter pub get
flutter run --flavor dev