Skip to main content

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.

Clother stores all API keys in a single plaintext file with restricted permissions: 
~/.local/share/clother/secrets.env
The file is created with chmod 600 (owner read/write only) and is never a symlink. Clother refuses to load it if it is.

​
File format

The secrets file uses simple KEY=value pairs, one per line. Blank lines and lines starting with # are ignored. 
# ~/.local/share/clother/secrets.env
ZAI_API_KEY=sk-abc123...
MINIMAX_API_KEY=sk-xyz789...
OPENROUTER_API_KEY=sk-or-...
Values may be unquoted, single-quoted, or double-quoted. Single-quoted values are taken literally. Values with spaces, tabs, backslashes, or single quotes are written by Clother using $'...' quoting.
Edit this file through clother config whenever possible. Clother normalizes and re-saves the file after each configuration change, which ensures correct quoting and sorted key order.

​
API key by provider

ProviderEnvironment variableNotes
Z.AI (international)ZAI_API_KEYz.ai
Z.AI (China)ZAI_CN_API_KEYopen.bigmodel.cn endpoint
MiniMax (international)MINIMAX_API_KEYminimax.io
MiniMax (China)MINIMAX_CN_API_KEYapi.minimaxi.com endpoint
KimiKIMI_API_KEYkimi.com
Moonshot AIMOONSHOT_API_KEYmoonshot.ai
DeepSeekDEEPSEEK_API_KEYplatform.deepseek.com
Xiaomi MiMoMIMO_API_KEYplatform.xiaomimimo.com
Alibaba (all regions)ALIBABA_API_KEYShared by alibaba, alibaba-us, alibaba-cn
VolcEngineARK_API_KEYark.cn-beijing.volces.com endpoint
OpenRouterOPENROUTER_API_KEYopenrouter.ai

​
Providers that do not need API keys

Local providers

Ollama, LM Studio, and llama.cpp run on your machine and do not require any credentials. Just start the local server and pass --model when launching.

Native Anthropic

clother-native uses your existing Claude Pro, Max, or Team subscription. No API key is stored or set by Clother.

​
Setting a key

The recommended way to add or update a key is through clother config: 
clother config zai
# Prompts: API key (empty to keep current)
Clother masks the stored value in the prompt (sk-a****1234) so you can confirm one is already set without exposing it.

Build docs developers (and LLMs) love

Get started for freeTalk to us