Quick start

Installation

Install the CLI using your preferred package manager or directly via our install script:

curl -fsSL https://grip.theshoaib.me/install | bash

When this finishes, you can run grip --help in your terminal to verify the installation.

Run grip then /setup

grip

Then, inside the interactive shell, run:

grip ❯ /setup

If you face any issues automatically connecting the MCP server, see the Manual Configuration section below.

Manual Configuration

If you experience any issues with the automatic setup, or your client isn't supported by the setup wizard, add grip-cli to your configuration file manually. Here is a minimal example (works in Cursor and most mcpServers clients):

{
  "mcpServers": {
    "grip": {
      "command": "grip-cli",
      "args": ["mcp"],
      "env": {
        "GRIP_CHROME_PORT": "9222",
        "GRIP_LOG_LEVEL": "info"
      }
    }
  }
}

See the full MCP configuration guide for detailed manual setups for other clients like OpenCode and Zed.

Check it works

You can use the built-in diagnostic tool to check if the CLI is successfully communicating with your browser:

grip

Then run the diagnostic command inside the shell:

grip ❯ /dev

This command will ping the browser's CDP port (9222) and display the connection status, confirming the full loop is working.