kime

[!IMPORTANT] This project uses encoding/json/v2. You must build with GOEXPERIMENT=jsonv2.

A beautiful CLI tool to display your Kimi Code Console stats in the terminal.

Features

• Weekly Usage – real-time API call
• Rate Limit Details – real-time API call
• My Benefits – cached for 7 days
• Model Permissions – cached for 7 days
• Beautiful Unicode-box UI powered by Lipgloss
• Multilingual output: Chinese (default), Traditional Chinese, English, and Japanese
• Mock mode for safe testing without hitting real APIs

Installation

Via go install

go install github.com/MysticalDevil/kime@latest

Via mise

# using the Go backend
mise use -g go:github.com/MysticalDevil/kime@latest

# or using the GitHub backend (prebuilt binary)
mise use -g github:MysticalDevil/kime@latest

Build from source

git clone https://github.com/MysticalDevil/kime.git
cd kime
go mod tidy
GOEXPERIMENT=jsonv2 go build -o kime

Then move the binary to a directory in your $PATH:

mv kime ~/.local/bin/

Configuration

kime reads credentials from ~/.config/kime/config.json (created automatically if you use browser extraction, or you can create it manually).

Interactive setup

The easiest way to configure kime is via the built-in interactive wizard:

kime init

This will prompt you for your token and auto-extract device_id, session_id, and user_id from the JWT payload. You can also set your preferred language and other options.

How to obtain credentials (DevTools)

1. Open https://www.kimi.com/code/console?from=kfc_overview_topbar and log in.

2. Open Developer Tools (F12 or Ctrl+Shift+I).

3. Go to the Console tab and run:

   copy(localStorage.getItem('access_token'))
   

   This copies your JWT token to the clipboard. Paste it as the token field.

4. (Optional) If you want to fill the other fields manually, paste the token into jwt.io to decode the payload, or run in Console:

   const parts = localStorage.getItem('access_token').split('.');
   const payload = JSON.parse(atob(parts[1].replace(/-/g, '+').replace(/_/g, '/')));
   console.log('device_id:', payload.device_id);
   console.log('session_id (ssid):', payload.ssid);
   console.log('user_id (sub):', payload.sub);
   

   kime can auto-extract device_id, session_id, and user_id from the JWT, so providing only token is usually enough.

Config file example

{
  "token": "eyJhbGciOiJIUzUxMiIs...",
  "device_id": "1234567890123456789",
  "session_id": "9876543210987654321",
  "user_id": "your_user_id_here",
  "language": "zh",
  "show_progress": false
}

Environment variables (override config)

If device_id or user_id is missing, kime will try to extract them from the JWT payload automatically.

Usage

# Show help
kime
kime --help

# Check stats (Chinese UI, default)
kime check

# English UI
KIME_LANG=en kime check   # or set "language": "en" in config

# Mock mode (no network requests)
KIME_MOCK=1 kime check

Cache

• Cache file: ~/.cache/kime/membership.json
• TTL: 7 days
• "My Benefits" and "Model Permissions" are served from cache when valid; "Weekly Usage" and "Rate Limit" are always fetched live.

License

BSD 3-Clause License. See LICENSE for details.