Documentation

Setup

Install Pier, load the extension, and validate your first run.

Install (Published Package)

npm install -g @malviyahimanshu/pier

Initialize Pier

pier setup

pier setup creates ~/.pier/config.json if missing, starts the local bridge server, starts the Portless proxy, and prints the WebSocket URL and token for the extension.

Use pier setup --manual-extension if you want setup to cache the unpacked extension bundle for manual loading.

Install Extension (Recommended)

Install Pier from the Chrome Web Store: https://chromewebstore.google.com/detail/pier/gfhbagnaafeefbkjcocmpnepfggbbdpj

Manual Unpacked Extension (Optional)

pier extension install
pier extension path
  1. Open chrome://extensions
  2. Enable Developer mode
  3. Click Load unpacked and select the printed directory

Configure Extension Settings

Open Pier Settings and paste the WebSocket URL and access token from setup. Use Test Bridge before opening localhost pages.

First-run Validation

  1. Verify pier bridge status reports running
  2. Start an app with pier myapp pnpm dev
  3. Open your localhost URL and press Ctrl+` on macOS or Ctrl+` on Windows/Linux
  4. Confirm terminal opens in the mapped project directory