1 Install CLI and Desktop apps#

# OpenCode 2 CLI and destop
brew install anomalyco/tap/opencode-v2 && brew install --cask opencode-desktop

# Check MCP's
opencode mcp list

• Command palette shortcuts, press Cmd + Shift + P (or Cmd + P) and search for

• Press ⌘⇧A (Command + Shift + A): Toggle Auto-Approve to bypass terminal execution prompts for that active session

• The main shared configuration is: ~/.config/opencode/opencode.json

• CLI-specific configuration is: ~/.config/opencode/cli.json

2 Guide: Configuring a 64k Context in Ollama and OpenCode v2#

For local coding agents, a larger context window can accommodate instructions, tool results, and conversation history. Ollama recommends at least 64k tokens for agent and coding tasks, but this uses more memory; confirm that the model and hardware can handle it. Ollama’s default allocated context varies with available VRAM (currently 4k below 24 GiB, 32k at 24–48 GiB, and 256k at 48 GiB or more).

Installing and Launching Pi (pi.dev)#

Follow these steps to set up the Pi coding agent on your Mac Studio and link it straight to your custom local short-context models.

1 Environment Preparation#

Because Pi is a JavaScript terminal application, it runs on Node.js. If you do not have Node installed yet, use Homebrew to get it ready.

1.1 Install Node.js via Homebrew#

brew install node

2 Installation#

Install the official global Pi command-line tool. As noted in the documentation, we include the security flag to bypass unnecessary third-party package scripts.

Hermes#

1 Projects#

Hermes Projects are named workspaces that can include folders or repositories. Project data is per profile. In this desktop version, use the built-in terminal for project and folder commands (Ctrl + ` opens it). Quote paths containing spaces.

# Create a project
hermes project create "Project Name" --primary "/absolute/path/to/folder" --use

# Use a project
hermes project use dockdash

# Add a folder
hermes project add-folder PROJECT "/absolute/path/to/folder"

# Add a PRIMARY folder
hermes project add-folder PROJECT "/absolute/path/to/folder" --primary

# Remove a folder
hermes project remove-folder PROJECT "/absolute/path/to/folder"

# List projects
hermes project list

# Show a project's configured folders
hermes project show PROJECT

# Use a project in CLI
hermes project use dockdash

2 Project Management#

Create projects and add folders

Installing Hermes Agent on Mac Studio#

1. Install Hermes Agent#

Official documentation:

https://hermes-agent.nousresearch.com

GitHub repository:

https://github.com/NousResearch/hermes-agent

1.1 Run the installer#

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

The installer handles the Hermes repository, Python environment, and required dependencies.

Expected installation paths:

~/.hermes/
~/.hermes/config.yaml
~/.hermes/.env
~/.hermes/hermes-agent/
~/.local/bin/hermes

1.2 Verify installation#

hermes --version

The MacBook Air installation used Hermes Agent v0.21.1.

The Mac Studio should use the current available release.

2. Hermes Setup Wizard#

Run:

hermes setup

Recommended selections are based on the previous successful installation.