z-node / docs

← Docs index

Cline

Setup guide for using Z-Node with Cline.

Official docs

Start with Cline's official CLI, configuration, and OpenAI-compatible provider docs. They document Cline's local config directory, the openai provider id for custom OpenAI-compatible APIs, the base URL override, model id selection, and the model configuration fields Cline needs for custom OpenAI-compatible models:

Z-Node example (~/.cline/data/globalState.json and ~/.cline/data/secrets.json)

Copy this into your shell. It writes Cline's local Z-Node OpenAI-compatible provider config, hardcodes the verified gpt-5.5 model metadata that Cline cannot get from /v1/models, keeps your key in Cline's local secrets file, and defaults both Plan and Act mode to gpt-5.5:

bash
mkdir -p ~/.cline/data/settings

cat > ~/.cline/data/globalState.json <<'JSON'
{
  "remoteRulesToggles": {},
  "remoteWorkflowToggles": {},
  "remoteSkillsToggles": {},
  "actModeApiProvider": "openai",
  "planModeApiProvider": "openai",
  "actModeOpenAiModelId": "gpt-5.5",
  "planModeOpenAiModelId": "gpt-5.5",
  "openAiBaseUrl": "https://api.z-node.com/v1",
  "actModeOpenAiModelInfo": {
    "modelName": "gpt-5.5",
    "contextWindow": 1050000,
    "maxTokens": 128000,
    "supportsImages": false,
    "supportsPromptCache": false,
    "supportsReasoning": true,
    "supportsReasoningEffort": true,
    "supportsTools": true,
    "supportsStreaming": true
  },
  "planModeOpenAiModelInfo": {
    "modelName": "gpt-5.5",
    "contextWindow": 1050000,
    "maxTokens": 128000,
    "supportsImages": false,
    "supportsPromptCache": false,
    "supportsReasoning": true,
    "supportsReasoningEffort": true,
    "supportsTools": true,
    "supportsStreaming": true
  },
  "zNodeModelCatalog": {
    "gpt-5.5": { "contextWindow": 1050000, "maxTokens": 128000 },
    "gpt-5.4": { "contextWindow": 1050000, "maxTokens": 128000 },
    "gpt-5.4-mini": { "contextWindow": 400000, "maxTokens": 128000 },
    "gpt-5.3-codex": { "contextWindow": 400000, "maxTokens": 128000 },
    "gpt-5.2": { "contextWindow": 400000, "maxTokens": 128000 },
    "codex-auto-review": { "verifiedLimits": false }
  },
  "welcomeViewCompleted": true
}
JSON

node -e '
const fs = require("fs");
const path = `${process.env.HOME}/.cline/data/secrets.json`;
fs.writeFileSync(path, JSON.stringify({ openAiApiKey: process.env.ZNODE_ISSUED_API_KEY }, null, 2));
'

[ -f ~/.cline/data/settings/cline_mcp_settings.json ] || \
  printf '{"mcpServers":{}}\n' > ~/.cline/data/settings/cline_mcp_settings.json

Acceptable Z-Node model ids for this example:

Smoke test

bash
cline --json "Reply with exactly: Z-NODE-CLINE-OK"