Agent CLI Setup/Config

context7-mcp.sh

#!/usr/bin/env bash
# file location ~/.config/context7-mcp.sh
set -euo pipefail

# The key is stored securely in a separate file.
# `source` reads the file without printing its contents.
# `set -a` ensures that the variables are exported.
set -a
source "$HOME/.config/context7/credentials"
set +a

# Starts Context7.
# This keeps the key out of the process list because it is not passed as a CLI argument.
exec npx -y @upstash/context7-mcp

mcp.json

// ~/.config/mcp/mcp.json      # common MCP definition for pi and other JSON-MCP clients
// ~/.codex/config.toml        # Codex specific MCP definition
// ~/.pi/agent/mcp.json        # in case only pi agents needs a other one
{
  "mcpServers": {
    "context7": {
      "command": "~/.config/context7/context7-mcp.sh",
      "startup_timeout_sec": 20
    },
    "openaiDocs": {
      "url": "https://developers.openai.com/mcp"
    }
  }
}

// {
//   "mcpServers": {
//     "context7": {
//       "command": "bash",
//       "args": [
//         "-lc",
//         "$HOME/.config/context7/context7-mcp.sh"
//       ],
//       "startup_timeout_sec": 20
//     },
//     "openaiDocs": {
//       "url": "https://developers.openai.com/mcp"
//     }
//   }
// }

pi_agent-setup-config.md

pi Agent Setup/Config

Extensions

pi install npm:toast-meter
pi install npm:pi-mcp-adapter

• https://pi.dev/packages/pi-mcp-adapter
• https://pi.dev/packages/toast-meter

MCP

settings.json

// ~/.pi/agent/settings.json
{
  "lastChangelogVersion": "0.78.0",
  "defaultProvider": "openai-codex",
  "defaultModel": "gpt-5.5",
  "defaultThinkingLevel": "low",
  "showHardwareCursor": true,
  "enableInstallTelemetry": false,
  "theme": "light",
  "hideThinkingBlock": false,
  "packages": [
    "npm:toast-meter",
    "npm:pi-mcp-adapter"
  ],
  "enabledModels": [
    "openai-codex/gpt-5.4",
    "openai-codex/gpt-5.5",
    "openai-codex/gpt-5.4-mini",
    "github-copilot/claude-sonnet-4.6",
    "github-copilot/gpt-5.4",
    "github-copilot/gpt-5.5",
    "github-copilot/gpt-5.4-mini"
  ],
  "terminal": {
    "showTerminalProgress": true
  },
  "enableSkillCommands": true
}