HolySheep CLI (hs) is a command-line utility designed to simplify the configuration of various AI coding assistants, such as Claude Code, Codex, and Aider. It targets developers, particularly those in China, by enabling them to unify access to these tools through the HolySheep API, which acts as a relay service for Claude, GPT, and Gemini APIs, thereby eliminating the need for a VPN. The primary benefit is a streamlined, one-command setup for integrating multiple AI coding tools.

How It Works

The hs setup command automates the process of configuring supported AI coding tools. Users are prompted to enter their HolySheep API key and select the tools they wish to integrate. The CLI then modifies the respective configuration files for tools like Claude Code, Codex CLI, Aider, Continue.dev, and OpenCode. For OpenClaw, it additionally launches a gateway service and provides a local web interface, simplifying interaction with AI agents. The HolySheep API serves as a central proxy, routing requests to the appropriate AI models.

Quick Start & Requirements

• Primary install / run command: npx @simonyea/holysheep-cli@latest setup or npm install -g @simonyea/holysheep-cli followed by hs setup.
• Non-default prerequisites and dependencies: Node.js (version 16+ recommended, 20+ for OpenClaw gateway), a HolySheep API Key (cr_xxx) obtained from holysheep.ai.
• Links: npm package, holysheep.ai.

Highlighted Details

• Supported Tools: Automatically configures Claude Code, Codex CLI, Aider, Continue.dev, OpenCode, and OpenClaw. Cursor requires manual GUI configuration, and Gemini CLI is not supported.
• OpenClaw Gateway: Integrates an AI agent gateway with a web dashboard accessible at http://127.0.0.1:18789/, automatically launched after setup. The gateway window must remain open for the UI to function.
• API Endpoints: Provides distinct endpoints for Anthropic SDK/Claude Code (https://api.holysheep.ai) and OpenAI-compatible services like Codex/Aider (https://api.holysheep.ai/v1).
• Commands: Includes hs setup, hs login, hs doctor, hs balance, hs tools, and hs reset for managing configurations and checking status.

Maintenance & Community

The project shows signs of active development with recent updates noted in the changelog, including improvements to OpenClaw installation and authentication. No specific community channels (like Discord or Slack) or major contributor information are detailed in the README.

Licensing & Compatibility

• License type: MIT.
• Compatibility notes: The MIT license generally permits commercial use and integration within closed-source projects without significant restrictions.

Limitations & Caveats

Configuration for Cursor is manual and must be done within its graphical user interface. Gemini CLI is explicitly not supported. The OpenClaw gateway requires its terminal window to remain open to function, and its specific gateway component requires Node.js version 20+. Users on Windows may need to restart their terminal or use npx if the hs command is not recognized after global installation.