Kimi Provider

Tracks usage for Kimi For Coding in CodexBar.

Features

• Displays weekly request quota (from membership tier)
• Shows current 5-hour rate limit usage
• API-key, automatic cookie, and manual cookie authentication methods
• Automatic refresh countdown

Setup

Choose one of three authentication methods:

Method 1: Kimi Code API Key (Recommended)

Create an API key in the Kimi Code Console, then save it in CodexBar:

codexbar config set-api-key --provider kimi --api-key "kimi-api-key-here"

Or provide it through the environment:

export KIMI_CODE_API_KEY="kimi-code-api-key-here"

CodexBar calls GET https://api.kimi.com/coding/v1/usages with the API key. Set KIMI_CODE_BASE_URL only when testing a compatible HTTPS proxy or alternate host.

Method 2: Automatic Browser Import

No setup needed! If you're already logged in to Kimi in Arc, Chrome, Safari, Edge, Brave, or Chromium:

1. Open CodexBar settings → Providers → Kimi
2. Set "Cookie source" to "Automatic"
3. Enable the Kimi provider toggle
4. CodexBar will automatically find your session

Note: Requires Full Disk Access to read browser cookies (System Settings → Privacy & Security → Full Disk Access → CodexBar).

Method 3: Manual Token Entry

For advanced users or when automatic import fails:

1. Open CodexBar settings → Providers → Kimi
2. Set "Cookie source" to "Manual"
3. Visit https://www.kimi.com/code/console in your browser
4. Open Developer Tools (F12 or Cmd+Option+I)
5. Go to Application → Cookies
6. Copy the kimi-auth cookie value (JWT token)
7. Paste it into the "Auth Token" field in CodexBar

Cookie Environment Variable

Alternatively, set the KIMI_AUTH_TOKEN environment variable:

export KIMI_AUTH_TOKEN="jwt-token-here"

Authentication Priority

When multiple sources are available, CodexBar uses this order:

1. API key (providers[].apiKey or KIMI_CODE_API_KEY) in Auto mode
2. Manual cookie/token (from Settings UI) when web fallback is used
3. Cookie environment variable (KIMI_AUTH_TOKEN)
4. Browser cookies (Arc → Chrome → Safari → Edge → Brave → Chromium)

Note: Browser cookie import requires Full Disk Access permission.

API Details

Kimi Code API key

Endpoint: GET https://api.kimi.com/coding/v1/usages

Authentication: Bearer token (from providers[].apiKey or KIMI_CODE_API_KEY)

Response:

{
  "usage": {
    "limit": "2048",
    "used": "214",
    "remaining": "1834",
    "resetTime": "2026-01-09T15:23:13.716839300Z"
  },
  "limits": [{
    "window": {"duration": 300, "timeUnit": "TIME_UNIT_MINUTE"},
    "detail": {
      "limit": "200",
      "used": "139",
      "remaining": "61",
      "resetTime": "2026-01-06T13:33:02.717479433Z"
    }
  }]
}

Kimi web cookie fallback

Endpoint: POST https://www.kimi.com/apiv2/kimi.gateway.billing.v1.BillingService/GetUsages

Authentication: Bearer token (from kimi-auth cookie)

Response:

{
  "usages": [{
    "scope": "FEATURE_CODING",
    "detail": {
      "limit": "2048",
      "used": "214",
      "remaining": "1834",
      "resetTime": "2026-01-09T15:23:13.716839300Z"
    },
    "limits": [{
      "window": {"duration": 300, "timeUnit": "TIME_UNIT_MINUTE"},
      "detail": {
        "limit": "200",
        "used": "139",
        "remaining": "61",
        "resetTime": "2026-01-06T13:33:02.717479433Z"
      }
    }]
  }]
}

Membership Tiers

All tiers have a rate limit of 200 requests per 5 hours.

Troubleshooting

"Kimi auth token is missing"

• Ensure "Cookie source" is set correctly
• If using Automatic mode, verify you're logged in to Kimi in your browser
• Grant Full Disk Access permission if using browser cookies
• Try Manual mode and paste your token directly

"Kimi auth token is invalid or expired"

• Your token has expired. Paste a new token from your browser
• If using Automatic mode, log in to Kimi again in your browser

"No Kimi session cookies found"

• You're not logged in to Kimi in any supported browser
• Grant Full Disk Access to CodexBar in System Settings

"Failed to parse Kimi usage data"

• The API response format may have changed. Please report this issue.

Implementation

• Core files: Sources/CodexBarCore/Providers/Kimi/
• UI files: Sources/CodexBar/Providers/Kimi/
• Login flow: Sources/CodexBar/KimiLoginRunner.swift
• Tests: Tests/CodexBarTests/KimiProviderTests.swift