Documentation Index
Fetch the complete documentation index at: https://mintlify.com/jolehuit/clother/llms.txt
Use this file to discover all available pages before exploring further.
Global flags
These flags are accepted by the clother management binary for all commands.
| Flag | Short | Description |
|---|
--help | -h | Show full help text and exit |
--version | -V | Print the Clother version and exit |
--verbose | -v | Enable verbose output |
--debug | -d | Enable debug output (implies --verbose) |
--quiet | -q | Suppress non-essential output |
--yes | -y | Skip confirmation prompts |
--no-input | | Disable interactive prompts (non-interactive mode) |
--no-banner | | Suppress the provider banner when launching |
--json | | Output in JSON format (for list, info, status) |
--plain | | Output in plain text format (for list) |
--bin-dir <path> | | Override the bin directory for this invocation |
Management commands
clother
With no arguments, shows brief help output.
clother config [provider]
Configures a provider interactively. Prompts for an API key and, where applicable, lets you choose a default model. When finished, saves configuration and regenerates all launcher symlinks.
If provider is omitted, Clother presents a numbered menu of all available providers to choose from.
Usage
clother config
clother config <provider>
| Argument | Description |
|---|
provider | Provider ID to configure (e.g. zai, kimi, openrouter, custom). Optional — if omitted, an interactive menu is shown. |
# Interactive provider picker
clother config
# Configure Z.AI directly
clother config zai
# Configure OpenRouter (sets API key and adds model aliases)
clother config openrouter
# Configure a custom Anthropic-compatible endpoint
clother config custom
After saving, clother config automatically re-syncs all launcher symlinks so your changes take effect immediately.
clother list
Lists all available profiles and whether each one is configured (i.e. has an API key set).
Usage
Flags
| Flag | Description |
|---|
--json | Output as JSON with profiles array containing name, command, and configured fields. |
--plain | Output one profile name per line (useful for scripting). |
# Human-readable table
clother list
# Machine-readable JSON
clother list --json
# Plain list of profile names
clother list --plain
clother info <provider>
Shows the resolved configuration for a specific provider: profile name, display name, model family, base URL, active model, and credential status.
Usage
Arguments
| Argument | Description |
|---|
provider | Provider ID (e.g. zai, kimi, ollama). Required. |
| Flag | Description |
|---|
--json | Output as JSON. |
# Show resolved config for Z.AI
clother info zai
# Show in JSON
clother info zai --json
# Confirm which model is active for Alibaba
clother info alibaba
clother test [provider]
Tests HTTP connectivity to provider endpoints. With no argument, tests all configured providers (skipping native). With a provider argument, tests only that provider.
Prints whether each endpoint is reachable and the HTTP status code returned.
Usage
clother test
clother test <provider>
| Argument | Description |
|---|
provider | Provider ID to test. Optional — if omitted, all providers are tested. |
# Test all providers
clother test
# Test a single provider
clother test zai
clother test kimi
clother status
Shows the current Clother installation status: version, config directory, data directory, bin directory, and the number of active profiles.
Usage
Flags
| Flag | Description |
|---|
--json | Output as JSON with version, config, data, bin, and profiles fields. |
clother status
clother status --json
clother install
Installs or updates Clother in place. Locates the real claude binary, preserves it, writes config and secrets files, and re-syncs all launcher symlinks. Use this after updating the clother binary or to repair a broken install.
Usage
Examples
# Install or repair
clother install
# Update Clother (re-run after downloading a new binary)
clother install
Requires Claude Code CLI to already be installed. If claude is not found, clother install will exit with an error.
clother uninstall
Removes Clother and all launchers. Deletes all clother-* symlinks, the claude shim, the clother binary, and all config, data, and cache directories.
Prompts for confirmation before proceeding unless --yes is passed.
Usage
Flags
| Flag | Description |
|---|
--yes | Skip the confirmation prompt. |
# Interactive (asks for confirmation)
clother uninstall
# Non-interactive
clother uninstall --yes
This permanently removes all Clother files including saved API keys. Your original Claude CLI installation is not affected.
clother help
Prints the full help text, including all available providers from the catalog.
Launcher commands
For every configured provider, Clother installs a clother-<provider> symlink in your bin directory. Invoking a launcher sets the appropriate ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN environment variables and then executes the real claude binary, passing all arguments through.
clother-<provider>
Launches Claude Code using the specified provider.
clother-<provider> [flags] [claude-args...]
| Command | Provider | Default model |
|---|
clother-native | Anthropic (subscription) | — |
clother-zai | Z.AI International | glm-5 |
clother-zai-cn | Z.AI China | glm-5 |
clother-minimax | MiniMax International | MiniMax-M2.5 |
clother-minimax-cn | MiniMax China | MiniMax-M2.5 |
clother-kimi | Kimi K2 | kimi-k2.5 |
clother-moonshot | Moonshot AI | kimi-k2.5 |
clother-deepseek | DeepSeek | deepseek-chat |
clother-mimo | Xiaomi MiMo | mimo-v2-flash |
clother-alibaba | Alibaba Coding Plan (Singapore) | qwen3.5-plus |
clother-alibaba-us | Alibaba Coding Plan (US) | qwen3.5-plus |
clother-alibaba-cn | Alibaba Coding Plan (China) | qwen3.5-plus |
clother-ve | VolcEngine | doubao-seed-code-preview-latest |
clother-ollama | Ollama (local) | (specify with --model) |
clother-lmstudio | LM Studio (local) | (specify with --model) |
clother-llamacpp | llama.cpp (local) | (specify with --model) |
clother-or-<alias>
Launches Claude Code through OpenRouter using a model alias you defined with clother config openrouter.
clother-or-<alias> [flags] [claude-args...]
# After aliasing moonshotai/kimi-k2.5 as "kimi-k25"
clother-or-kimi-k25
Launcher flags
The following flags are accepted by all launcher commands (clother-<provider> and clother-or-<alias>) and by the claude shim installed by Clother.
--no-banner
Suppresses the provider name banner that Clother prints at the start of a session. Useful for scripting or non-interactive use.
--model <model-id>
Overrides the default model for this invocation. The value is passed directly to the Claude CLI.
clother-zai --model glm-4.7
clother-ollama --model qwen3-coder
clother-alibaba --model kimi-k2.5
--yolo
Shorthand for --dangerously-skip-permissions. Skips all permission prompts for the current session. Accepted by all launchers and by the Clother claude shim.
clother-zai --yolo
clother-kimi --yolo
--resume <session-id>
Passes a session ID through to the Claude CLI to resume a previous session. This is a Claude CLI flag that Clother forwards unchanged.
Clother prints a provider-aware resume command at the end of each session (e.g. clother-kimi --resume <session-id>), so you can resume exactly where you left off with the same provider.
clother-kimi --resume abc123
When resuming a session that was started with a non-Claude provider into clother-native, Clother automatically sanitizes incompatible thinking blocks in the session file before launch, then restores the original session file afterwards.