Documentation / 03

Run Devin Pocket on macOS

Devin Pocket runs on macOS with Node.js 22 or newer and Devin CLI. Install the package using npx, npm or pnpm, then open the local browser UI and authorize your Devin account. The general installer can prepare Node.js when Homebrew is already installed; it does not install a missing Devin CLI.

Last updated ·Node.js 22+

Before you begin

  • macOS, Node.js 22+, npm or pnpm, and a modern browser.
  • Devin CLI and a Devin account. Homebrew already installed if using the general installer to prepare Node.js.

Step by step

  1. 01

    Prepare the agent

    Install the official Devin CLI if absent. Review scripts before running them.

    curl -fsSL https://cli.devin.ai/install.sh | bash
  2. 02

    Choose one install method

    Use npx to launch, or install globally with npm or pnpm. Run pnpm setup for global-bin errors and reload your shell environment.

    npx devin-pocket
    npm i -g devin-pocket
    pnpm add -g devin-pocket
    pnpm setup
  3. 03

    Optional general installer

    Requires existing Homebrew if it needs to install Node.js. Prefers pnpm with npm fallback; missing Devin CLI only produces instructions.

    curl -fsSL https://raw.githubusercontent.com/BOTOOM/devin-pocket/main/install.sh | bash
  4. 04

    Open and sign in

    Start the global installation and open http://127.0.0.1:7777 if the browser does not open. Authorize your Devin account in the PWA; manual host login is available.

    devin-pocket start
    devin auth login
  5. 05

    Inspect or stop

    The host and CLI stay running while you use the PWA. Use doctor and logs to inspect failures, then stop when finished.

    devin-pocket doctor
    devin-pocket logs -n 100
    devin-pocket stop

Keep in mind

  • Pocket is a local browser client, not a macOS native desktop app.
  • A custom --host can expose the UI without client authentication. Read the remote-access guide first.

Source of truth: the Devin Pocket README and implementation.

README