z-node / docs

← Docs index

Kilo Code

Setup guide for using Z-Node with Kilo Code.

Official docs

Start with Kilo Code's official CLI and OpenAI-compatible provider docs. They document the CLI config locations, OpenCode-compatible provider shape, environment variable references, and kilo run smoke-test path:

Z-Node example (opencode.json)

Copy this into your project root opencode.json. This follows Kilo CLI's OpenCode-compatible provider config shape and defaults to gpt-5.5:

json
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "znode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Z-Node OpenAI-Compatible",
      "options": {
        "baseURL": "https://api.z-node.com/v1",
        "apiKey": "{env:ZNODE_ISSUED_API_KEY}"
      },
      "models": {
        "gpt-5.5": {
          "name": "gpt-5.5",
          "limit": {
            "context": 1050000,
            "output": 128000
          }
        },
        "gpt-5.4": {
          "name": "gpt-5.4",
          "limit": {
            "context": 1050000,
            "output": 128000
          }
        },
        "gpt-5.4-mini": {
          "name": "gpt-5.4-mini",
          "limit": {
            "context": 400000,
            "output": 128000
          }
        },
        "gpt-5.3-codex": {
          "name": "gpt-5.3-codex",
          "limit": {
            "context": 400000,
            "output": 128000
          }
        },
        "gpt-5.2": {
          "name": "gpt-5.2",
          "limit": {
            "context": 400000,
            "output": 128000
          }
        },
        "codex-auto-review": {
          "name": "codex-auto-review"
        }
      }
    }
  },
  "model": "znode/gpt-5.5"
}

Acceptable Z-Node model ids for this example:

Smoke test

bash
ZNODE_ISSUED_API_KEY="$ZNODE_ISSUED_API_KEY" \
kilo run --format json "Reply with exactly: Z-NODE-KILO-OK"