### Install Node.js via Homebrew

Source: https://docs.supasidebar.com/features/mcp

Use Homebrew to install Node.js if it is not already present on the system.

```bash
brew install node
```

--------------------------------

### Verify Node.js and npx installation

Source: https://docs.supasidebar.com/features/mcp

Check that the required Node.js version is installed and the npx command is available.

```bash
node --version    # should print v18.x or higher
npx --version     # should print a version number, not "command not found"
```

--------------------------------

### Install SupaSidebar via Homebrew

Source: https://docs.supasidebar.com/gettingStarted

Use this command to install the SupaSidebar application on macOS using the Homebrew package manager.

```bash
brew install --cask supasidebar
```

--------------------------------

### Example output of profile diagnostic command

Source: https://docs.supasidebar.com/troubleshooting/browserProfilesMissing

The expected output format when running the diagnostic command, showing the internal profile key and the display name.

```text
Default    ->  Personal
Profile 1  ->  Work
Profile 3  ->  Side project
```

--------------------------------

### Configure Claude Desktop for MCP

Source: https://docs.supasidebar.com/features/mcp

Add the SupaSidebar server configuration to the Claude Desktop settings file.

```json
{
  "mcpServers": {
    "supasidebar": {
      "command": "npx",
      "args": ["-y", "supasidebar-mcp"]
    }
  }
}
```

--------------------------------

### Register SupaSidebar MCP server for a single project

Source: https://docs.supasidebar.com/features/mcp

Register the MCP server specifically for the current project directory.

```bash
claude mcp add supasidebar -- npx -y supasidebar-mcp
```

--------------------------------

### Manually configure MCP server in .claude.json

Source: https://docs.supasidebar.com/features/mcp

Add the server configuration manually to the ~/.claude.json file if not using the CLI command.

```json
{
  "mcpServers": {
    "supasidebar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "supasidebar-mcp"]
    }
  }
}
```

--------------------------------

### List registered MCP servers

Source: https://docs.supasidebar.com/features/mcp

Verify that the SupaSidebar server is correctly registered and connected.

```bash
claude mcp list
# expected: supasidebar    ✓ Connected
```

--------------------------------

### Register MCP Server in Codex

Source: https://docs.supasidebar.com/features/mcp

Use the Codex CLI to register the SupaSidebar MCP server.

```bash
codex mcp add supasidebar -- npx -y supasidebar-mcp
```

--------------------------------

### Verify and Register MCP Server

Source: https://docs.supasidebar.com/troubleshooting/mcp

Commands to check the current MCP registration status and re-register the SupaSidebar server if missing.

```bash
claude mcp list
# expected: supasidebar    ✓ Connected
```

```bash
claude mcp add -s user supasidebar -- npx -y supasidebar-mcp
```

--------------------------------

### Configure MCP with Shell Login Profile

Source: https://docs.supasidebar.com/troubleshooting/mcp

Update your MCP configuration to use zsh with the -lc flag to ensure the Node.js version manager PATH is correctly loaded.

```json
"command": "/bin/zsh",
"args": ["-lc", "npx -y supasidebar-mcp"]
```

--------------------------------

### Download Larger Ollama Models

Source: https://docs.supasidebar.com/features/tags/localModels

Commands to pull larger, more accurate models for use with Ollama.

```bash
ollama pull qwen2.5:7b    # 4.4 GB, very accurate
ollama pull llama3.1:8b   # 4.7 GB, excellent quality
```

--------------------------------

### Download Ollama Model

Source: https://docs.supasidebar.com/features/tags/localModels

Command to pull a specific model into the local Ollama environment via Terminal.

```bash
ollama pull qwen2.5:3b
```

--------------------------------

### Register SupaSidebar MCP server with Claude Code

Source: https://docs.supasidebar.com/features/mcp

Register the MCP server at the user scope to make it available across all projects.

```bash
claude mcp add -s user supasidebar -- npx -y supasidebar-mcp
```

--------------------------------

### Inspect MCP Tools

Source: https://docs.supasidebar.com/troubleshooting/mcp

Run the official MCP Inspector to view all exposed tools and their schemas independently of the AI client.

```bash
npx @modelcontextprotocol/inspector npx -y supasidebar-mcp
```

--------------------------------

### Diagnose browser profile registration via Terminal

Source: https://docs.supasidebar.com/troubleshooting/browserProfilesMissing

Use this command to list all profiles currently registered by the browser in its 'Local State' file. Replace the path fragment for browsers other than Chrome.

```python
python3 -c "import json,os; d=json.load(open(os.path.expanduser('~/Library/Application Support/Google/Chrome/Local State'))); [print(f'{k}  ->  {v.get("name")}') for k,v in d['profile']['info_cache'].items()]"
```