octopus-cli

🥈Silver

Octopus CLI is a command-line tool for managing and forwarding Claude Code API requests. It enables operations teams to automate API interactions, streamline workflows, and integrate with existing systems. The tool is built in Go and supports dynamic API management.

2210Updated 1mo ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/VibeAny/octopus-cli.git

Works with:

Claude

Overview

About This Skill

Octopus CLI is a Go-based command-line proxy tool designed for coding agents like Claude Code, enabling seamless API provider switching without downtime. The tool provides transparent HTTP proxy services with dynamic API management, allowing teams to switch between API endpoints instantly and route requests intelligently. It features TOML-based configuration, health checking, request logging, and multi-platform support across Windows, macOS, and Linux. Built for DevOps teams and automation workflows, Octopus CLI streamlines API integration with a modern CLI interface and automatic upgrade capabilities.

How to Use

Install via the one-command script or pre-built binaries, then add API configurations using `octopus config add`, start the proxy with `octopus start`, and configure Claude Code to use localhost:8080 via environment variables (ANTHROPIC_BASE_URL). Switch APIs dynamically with `octopus config switch` and monitor status with `octopus status` and `octopus health`.

Use Cases

Switch between multiple Claude Code API providers without restarting services

Monitor API endpoint health and availability in real-time

Automate API routing and request forwarding for coding agent teams

Manage multi-agent configurations from a single unified interface

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/VibeAny/octopus-cli

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I'm using Octopus CLI to automate API interactions for [COMPANY] in the [INDUSTRY] sector. I need to forward requests to the Claude Code API with the following [DATA]. Can you provide a step-by-step guide on how to set up and use Octopus CLI for this specific use case?

Example Output

# Octopus CLI Setup and Usage Guide for [COMPANY]

## Prerequisites
- Go installed on your system
- Octopus CLI downloaded and installed
- Valid API credentials for Claude Code API

## Step 1: Install Octopus CLI

```bash
# Download the latest version of Octopus CLI
curl -LO https://github.com/octopus-cli/octopus/releases/latest/download/octopus-cli_linux_amd64.tar.gz

# Extract the binary
tar -xvzf octopus-cli_linux_amd64.tar.gz

# Move the binary to your PATH
sudo mv octopus-cli /usr/local/bin/
```

## Step 2: Configure API Credentials

```bash
# Set up your API credentials
octopus configure --api-key YOUR_API_KEY --api-secret YOUR_API_SECRET
```

## Step 3: Forward API Requests

```bash
# Forward a request to the Claude Code API
octopus forward --endpoint /v1/code --method POST --data '{"code": "print('Hello, World!')"}'
```

## Step 4: Automate Workflows

```bash
# Create a workflow to automate API interactions
octopus workflow create --name code_analysis --schedule "0 0 * * *" --command "octopus forward --endpoint /v1/analyze --method POST --data '{"code": "$(cat /path/to/code/file)"}'"
```