Cloudly AI Helper

Configure 17 AI coding tools with any OpenAI-compatible endpoint — in one command.

Overview

cloudly-ai-helper auto-discovers models from any OpenAI-compatible API endpoint and configures them across 11 agents automatically (17 total with manual guides).

No config file hunting. One command sets up Claude Code, Cline, OpenCode, Continue, Zed, Aider, Codex, and more.

cloudly-ai-helper init --api-key sk-... --yes

Features

• Model Auto-Discovery — Fetches all models from GET /v1/models
• Smart Default Selection — Picks the right model per agent:
  • General agents: cheapest capable (kimi > deepseek > haiku)
  • Anthropic (Claude Code): cheapest haiku
  • OpenAI (Codex): first gpt
  • Override with --model
• 11 Auto-Config Agents — Writes config files automatically
• 6 Instruction Guides — Step-by-step for GUI-based tools
• Per-Model Capabilities — Vision/reasoning/tool-use metadata
• Uninstall — Clean removal from any tool
• Health Check — doctor shows everything at a glance
• Multi-language — English, Espanol, Chinese
• Any OpenAI-compatible endpoint — LiteLLM, OpenAI, Anthropic, OpenRouter, custom

Installation

npm install -g cloudly-ai-helper
pnpm add -g cloudly-ai-helper
yarn global add cloudly-ai-helper

Requires: Node.js 18+

Quick Start

# One-command
cloudly-ai-helper init --api-key sk-... --yes

# Custom endpoint + model
cloudly-ai-helper init --base-url https://your-proxy.com/v1 --api-key sk-... --model gpt-5 --yes

# Interactive
cloudly-ai-helper

Commands

init — Setup wizard

| Flag | Description | |---|---| | --base-url <url> | API endpoint (default: https://ai.cloudly.host/v1) | | --api-key <key> | API key | | --model <model> | Default model across all agents | | --yes | Skip prompts, auto-configure all |

doctor — Health check

Shows configured tools, default model, model counts.

cloudly-ai-helper doctor

No args — Interactive menu

Opens a menu to configure individual tools, change settings, run health checks.

Supported Tools

Auto-Config (11 tools — config files written automatically)

| # | Tool | Config File | Default Model | |---|---|---|---| | 1 | Claude Code | ~/.claude/settings.json | cheapest haiku | | 2 | Droid | ~/.factory/settings.json | smart default | | 3 | OpenCode | ~/.config/opencode/opencode.json | smart default | | 4 | Continue | ~/.continue/config.yaml | smart default | | 5 | Crush | ~/.config/crush/crush.json | smart default | | 6 | Codex CLI | ~/.cloudly-ai-helper/bin/codex.sh + .ps1 | first gpt | | 7 | Zed | ~/.config/zed/settings.json | smart default | | 8 | Aider | ~/.aider.conf.yml | smart default | | 9 | Hermes | ~/.hermes/config.yaml + .env | smart default | | 10 | Cline | VS Code settings.json (merged) | smart default | | 11 | Roo Code | VS Code settings.json (merged) | smart default |

Instruction Guides (6 tools — manual steps)

| # | Tool | How | |---|---|---| | 12 | Cursor | Settings > Models > Override OpenAI Base URL | | 13 | Kilo Code | VS Code extension, API Provider: OpenAI Compatible | | 14 | TRAE | Settings > Models > + Add Model | | 15 | Windsurf | AI Provider > Custom OpenAI-compatible | | 16 | Grok CLI | Environment variables | | 17 | Neovim | avante.nvim / codecompanion.nvim |

Smart Default Model Selection

• General (Droid, OpenCode, Continue, Crush, Zed, Aider, Hermes, Cline, Roo Code): kimi > deepseek > claude-haiku > gemini-flash > first model
• Claude Code (Anthropic): always cheapest claude-haiku-*
• Codex (OpenAI): always first gpt-*
• Override: --model gpt-5 sets a specific model for all agents

Configuration

Stored at ~/.cloudly-ai-helper/config.yaml:

lang: en_US
base_url: https://ai.cloudly.host/v1
api_key: sk-...
defaultModel: kimi-k2.7-code
models:
  - claude-haiku-4-5
  - gpt-4o
  - kimi-k2.7-code
  - deepseek-v3
  - ...

Per-Model Capabilities

| Capability | Models | |---|---| | attachment / image_input | claude-, gemini-, gpt-4o, kimi- | | reasoning / can_reason | claude-, gemini-, gpt-5 | | tool_call / tools | All models |

Development

git clone <repo>
cd cloudly-ai-helper
pnpm install
pnpm run build
pnpm run dev      # watch mode

See CONTRIBUTING.md.

Architecture

src/
  cli.ts                         # Entry
  lib/
    command.ts                   # CLI commands (Commander)
    config.ts                    # Config, model discovery, defaults
    wizard.ts                    # Interactive setup
    tools/
      base.ts                    # ToolManager interface
      index.ts                   # Tool registry
      auto-config/               # 11 agent managers
        aider.ts, claude-code.ts, cline.ts, codex.ts,
        continue.ts, crush.ts, droid.ts, hermes.ts,
        opencode.ts, roo-code.ts, zed.ts
      instructions/              # 6 manual guides
      mcp/                       # MCP server support
  locales/                       # en_US, es_ES, zh_CN

License

Apache-2.0