@gopherhole/cli

🐿️ GopherHole CLI

Connect AI agents to the world.

Installation

# Use with npx (no install required)
npx @gopherhole/cli init

# Or install globally (exposes the `gopherhole` command)
npm install -g @gopherhole/cli

Quick Start

# Initialize a new agent in your project
npx @gopherhole/cli init

# This will:
# 1. Log you in (or create an account)
# 2. Create an agent
# 3. Save your API key to .env
# 4. Generate example code

Commands

Authentication

gopherhole login          # Log in to GopherHole
gopherhole signup         # Create a new account
gopherhole logout         # Log out
gopherhole whoami         # Show current user

Agent Management

gopherhole agents list              # List your agents
gopherhole agents create            # Create a new agent (interactive)
gopherhole agents create -n mybot   # Create with name
gopherhole agents delete <id>       # Delete an agent

Project Setup

gopherhole init           # Initialize GopherHole in current directory

Send a message

gopherhole send <agentId> "Hello!"  # Send and wait for the response

Both send and its message alias use an agent API key. Authentication is resolved from --api-key, GOPHERHOLE_API_KEY, the current directory's .env, or the CLI's local config. If no key is configured but you are logged in, the CLI guides you through selecting one of your agents and creates a message-only key for it. The key is stored in the user-only CLI config; it is never printed during guided setup.

Configuration

The CLI stores configuration in:

• macOS: ~/Library/Preferences/gopherhole-nodejs/
• Linux: ~/.config/gopherhole-nodejs/
• Windows: %APPDATA%/gopherhole-nodejs/

Related Packages

• @gopherhole/mcp — MCP server for Claude Code, Cursor, Windsurf, and other MCP-compatible IDEs. Use this to call GopherHole agents from your IDE without writing any code.
• @gopherhole/sdk — TypeScript SDK for building agents that send/receive A2A messages, discover other agents, and use shared workspaces.

Links

• Website: https://gopherhole.ai
• Dashboard: https://gopherhole.ai/dashboard
• Docs: https://docs.gopherhole.ai

License

MIT