playmaker-cli 0.10.0__tar.gz → 0.12.0__tar.gz

{playmaker_cli-0.10.0 → playmaker_cli-0.12.0}/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.0] - 2026-09-04
+
+### Added
+
+- **Kimi Code usage in `playmaker quotas`.** The table reads Kimi Code's
+  managed OAuth usage endpoint and shows its rolling 5-hour Session and weekly
+  buckets beside the other provider pools.
+
+## [0.11.0] - 2026-09-04
+
+### Added
+
+- **`kimi` lane — the Kimi Code CLI as a first-class agent.**
+  `playmaker dispatch kimi -m kimi-code/k3-256k` runs `kimi -p …
+  --output-format stream-json`, tracks the session, resumes with `-S`, and
+  reads the per-cwd `wire.jsonl` for `summary`. K3 is a senior-tier model on a
+  subscription nobody else on the machine draws from, and routing it through
+  opencode would have needed a second credential; the native CLI reuses its
+  own OAuth login.
+
 ## [0.10.0] - 2026-09-04
 
 ### Added

{playmaker_cli-0.10.0 → playmaker_cli-0.12.0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.5
 Name: playmaker-cli
-Version: 0.10.0
-Summary: Playing-coach CLI for orchestrating Claude Code, Codex, Antigravity and opencode sub-agents in parallel.
+Version: 0.12.0
+Summary: Playing-coach CLI for orchestrating Claude Code, Codex, Antigravity, Kimi Code and opencode sub-agents in parallel.
 Project-URL: Homepage, https://github.com/vladsafedev/playmaker
 Project-URL: Repository, https://github.com/vladsafedev/playmaker
 Project-URL: Issues, https://github.com/vladsafedev/playmaker/issues
 Author-email: Vladislav Shulyugin <vladislav.shulyugin@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
-Keywords: agents,ai,antigravity,claude,claude-code,cli,codex,gemini,glm,opencode,orchestration,subagents
+Keywords: agents,ai,antigravity,claude,claude-code,cli,codex,gemini,glm,kimi,kimi-code,opencode,orchestration,subagents
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -32,7 +32,7 @@ Description-Content-Type: text/markdown
 [![Python](https://img.shields.io/pypi/pyversions/playmaker-cli.svg?cacheSeconds=3600)](https://pypi.org/project/playmaker-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**Run Claude Code, Codex, Antigravity and opencode as parallel sub-agents from one terminal — and spend separate quotas instead of one.**
+**Run Claude Code, Codex, Antigravity, Kimi Code and opencode as parallel sub-agents from one terminal — and spend separate quotas instead of one.**
 
 You stay in your Claude Code session doing the part only you can do. `playmaker`
 fans the rest out to other agent CLIs as detached processes, tracks them,
@@ -74,10 +74,11 @@ in one serial session:
 1. **Wall-clock speed.** A task that decomposes into 3–5 independent
    work-streams (schema, backend, frontend, tests, docs) finishes 2–4× faster
    when each stream runs as its own parallel agent.
-2. **Provider arbitrage.** Codex, Antigravity and opencode quotas are entirely
-   separate pools from your Anthropic plan. Every slice you hand them is
-   capacity your main session never spends — and Antigravity's roster includes
-   Claude Sonnet/Opus, so even Claude-quality work can run on Google's pool.
+2. **Provider arbitrage.** Codex, Antigravity, Kimi Code and opencode quotas
+   are entirely separate pools from your Anthropic plan. Every slice you hand
+   them is capacity your main session never spends — and Antigravity's roster
+   includes Claude Sonnet/Opus, so even Claude-quality work can run on Google's
+   pool. Kimi Code brings its own subscription with the senior-tier K3.
    `opencode` widens this the most: one CLI fronting ~75 providers, from a z.ai
    GLM coding plan to models running locally on your own machine.
 3. **Bucket arbitrage inside one plan.** Headless `claude -p` draws on the same
@@ -146,6 +147,10 @@ The other agents differ, because their CLIs do:
   { "permission": { "edit": "allow", "bash": "allow", "webfetch": "deny" } }
   ```
 
+- **kimi** has no permission flags at all in headless mode — `kimi -p` refuses
+  `--auto`, `--yolo` and `--plan`, and already runs with auto-approval, so
+  there is no read-only mode below the prompt.
+
 - **gemini** (legacy) runs with `--yolo`.
 
 ## Install
@@ -183,6 +188,7 @@ playmaker agents          # which agent CLIs are reachable
 | **Codex CLI** | `npm i -g @openai/codex` | the model roster depends on your plan; omit `--model` to use the account default |
 | **Antigravity (`agy`)** | bundled with [Antigravity](https://antigravity.google) | `--model claude-opus-4-6-thinking` — the roster moves, so read it from `agy models` |
 | **opencode** | `brew install sst/tap/opencode` (or see [opencode.ai](https://opencode.ai)) | `--model provider/model`, e.g. `zai-coding-plan/glm-5.2`; roster from `opencode models`, providers from `opencode auth login` |
+| **Kimi Code CLI** | `npm i -g @moonshot-ai/kimi-code` | needs Node ≥ 22.19 (a wrapper that pins a newer Node is fine — point `[agents.kimi] binary` at it); `--model kimi-code/k3-256k` — 256k window at half the quota cost of `k3`; log in once with `kimi login --region global`; model ids from `~/.kimi-code/config.toml` |
 | **Gemini CLI** (legacy) | `npm i -g @google/gemini-cli` | still supported, superseded by `agy` |
 
 At least one is required; `playmaker agents` tells you which it can see.
@@ -317,6 +323,7 @@ and locates the session file the tool writes locally. Empirically:
 | Codex | `~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-<ts>-<thread_id>.jsonl` |
 | Antigravity | `~/.gemini/antigravity-cli/brain/<conversation-id>/.system_generated/logs/transcript_full.jsonl` |
 | opencode | SQLite — `~/.local/share/opencode/opencode.db` (`session` / `message` / `part`); playmaker keeps a pointer at `~/.playmaker/opencode/<id>.session` |
+| kimi | `~/.kimi-code/sessions/wd_<cwd-basename>_<hash>/session_<id>/agents/main/wire.jsonl` (per-cwd; `KIMI_CODE_HOME` overrides the root) |
 | Gemini | `~/.gemini/tmp/<cwd-basename>/chats/session-<ts>-<short_id>.{json,jsonl}` |
 
 `thread` and `summary` normalize all of them into the same turn list, so every
@@ -439,6 +446,10 @@ whole Z.ai block. Routing a subtask is choosing which of them to spend.
   lane pointed at a local model spends nothing here. Shows *unsupported* rather
   than an error when no Z.ai credential exists. `MCP tools` is the monthly
   web-search/reader pool, not inference.
+- **Kimi Code** — managed usage API; OAuth token from
+  `~/.kimi-code/credentials/kimi-code-env-*.json` (`$KIMI_CODE_HOME` overrides
+  the root). Its 5-hour `Session` and weekly rows are separate percentage
+  buckets; no credential reads as *unsupported* rather than a failed probe.
 
 Reading these at *model* granularity is the point: they are the load-balancing
 input the coach skill uses to route each subtask.

{playmaker_cli-0.10.0 → playmaker_cli-0.12.0}/README.md

@@ -5,7 +5,7 @@
 [![Python](https://img.shields.io/pypi/pyversions/playmaker-cli.svg?cacheSeconds=3600)](https://pypi.org/project/playmaker-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**Run Claude Code, Codex, Antigravity and opencode as parallel sub-agents from one terminal — and spend separate quotas instead of one.**
+**Run Claude Code, Codex, Antigravity, Kimi Code and opencode as parallel sub-agents from one terminal — and spend separate quotas instead of one.**
 
 You stay in your Claude Code session doing the part only you can do. `playmaker`
 fans the rest out to other agent CLIs as detached processes, tracks them,
@@ -47,10 +47,11 @@ in one serial session:
 1. **Wall-clock speed.** A task that decomposes into 3–5 independent
    work-streams (schema, backend, frontend, tests, docs) finishes 2–4× faster
    when each stream runs as its own parallel agent.
-2. **Provider arbitrage.** Codex, Antigravity and opencode quotas are entirely
-   separate pools from your Anthropic plan. Every slice you hand them is
-   capacity your main session never spends — and Antigravity's roster includes
-   Claude Sonnet/Opus, so even Claude-quality work can run on Google's pool.
+2. **Provider arbitrage.** Codex, Antigravity, Kimi Code and opencode quotas
+   are entirely separate pools from your Anthropic plan. Every slice you hand
+   them is capacity your main session never spends — and Antigravity's roster
+   includes Claude Sonnet/Opus, so even Claude-quality work can run on Google's
+   pool. Kimi Code brings its own subscription with the senior-tier K3.
    `opencode` widens this the most: one CLI fronting ~75 providers, from a z.ai
    GLM coding plan to models running locally on your own machine.
 3. **Bucket arbitrage inside one plan.** Headless `claude -p` draws on the same
@@ -119,6 +120,10 @@ The other agents differ, because their CLIs do:
   { "permission": { "edit": "allow", "bash": "allow", "webfetch": "deny" } }
   ```
 
+- **kimi** has no permission flags at all in headless mode — `kimi -p` refuses
+  `--auto`, `--yolo` and `--plan`, and already runs with auto-approval, so
+  there is no read-only mode below the prompt.
+
 - **gemini** (legacy) runs with `--yolo`.
 
 ## Install
@@ -156,6 +161,7 @@ playmaker agents          # which agent CLIs are reachable
 | **Codex CLI** | `npm i -g @openai/codex` | the model roster depends on your plan; omit `--model` to use the account default |
 | **Antigravity (`agy`)** | bundled with [Antigravity](https://antigravity.google) | `--model claude-opus-4-6-thinking` — the roster moves, so read it from `agy models` |
 | **opencode** | `brew install sst/tap/opencode` (or see [opencode.ai](https://opencode.ai)) | `--model provider/model`, e.g. `zai-coding-plan/glm-5.2`; roster from `opencode models`, providers from `opencode auth login` |
+| **Kimi Code CLI** | `npm i -g @moonshot-ai/kimi-code` | needs Node ≥ 22.19 (a wrapper that pins a newer Node is fine — point `[agents.kimi] binary` at it); `--model kimi-code/k3-256k` — 256k window at half the quota cost of `k3`; log in once with `kimi login --region global`; model ids from `~/.kimi-code/config.toml` |
 | **Gemini CLI** (legacy) | `npm i -g @google/gemini-cli` | still supported, superseded by `agy` |
 
 At least one is required; `playmaker agents` tells you which it can see.
@@ -290,6 +296,7 @@ and locates the session file the tool writes locally. Empirically:
 | Codex | `~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-<ts>-<thread_id>.jsonl` |
 | Antigravity | `~/.gemini/antigravity-cli/brain/<conversation-id>/.system_generated/logs/transcript_full.jsonl` |
 | opencode | SQLite — `~/.local/share/opencode/opencode.db` (`session` / `message` / `part`); playmaker keeps a pointer at `~/.playmaker/opencode/<id>.session` |
+| kimi | `~/.kimi-code/sessions/wd_<cwd-basename>_<hash>/session_<id>/agents/main/wire.jsonl` (per-cwd; `KIMI_CODE_HOME` overrides the root) |
 | Gemini | `~/.gemini/tmp/<cwd-basename>/chats/session-<ts>-<short_id>.{json,jsonl}` |
 
 `thread` and `summary` normalize all of them into the same turn list, so every
@@ -412,6 +419,10 @@ whole Z.ai block. Routing a subtask is choosing which of them to spend.
   lane pointed at a local model spends nothing here. Shows *unsupported* rather
   than an error when no Z.ai credential exists. `MCP tools` is the monthly
   web-search/reader pool, not inference.
+- **Kimi Code** — managed usage API; OAuth token from
+  `~/.kimi-code/credentials/kimi-code-env-*.json` (`$KIMI_CODE_HOME` overrides
+  the root). Its 5-hour `Session` and weekly rows are separate percentage
+  buckets; no credential reads as *unsupported* rather than a failed probe.
 
 Reading these at *model* granularity is the point: they are the load-balancing
 input the coach skill uses to route each subtask.

{playmaker_cli-0.10.0 → playmaker_cli-0.12.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "playmaker-cli"
-version = "0.10.0"
-description = "Playing-coach CLI for orchestrating Claude Code, Codex, Antigravity and opencode sub-agents in parallel."
+version = "0.12.0"
+description = "Playing-coach CLI for orchestrating Claude Code, Codex, Antigravity, Kimi Code and opencode sub-agents in parallel."
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
@@ -19,6 +19,8 @@ keywords = [
     "codex",
     "antigravity",
     "gemini",
+    "kimi",
+    "kimi-code",
     "opencode",
     "glm",
     "subagents",

{playmaker_cli-0.10.0 → playmaker_cli-0.12.0}/skills/playmaker-coach/references/agent-gotchas.md

@@ -65,6 +65,22 @@ line from `agy models` / `opencode models` rather than typing it.
 - Neither trap applies to **review** dispatches, which write nothing — which makes opencode a
   perfectly good reviewer even where it is a shaky implementer.
 
+## kimi (Kimi Code CLI)
+
+- There is **no read-only mode below the prompt**: `-p` refuses `--auto`, `--yolo` and `--plan`
+  (exit 1) and already runs with auto-approval. Only dispatch work you would run unattended anyway.
+- The session id arrives **only in the trailing `session.resume_hint` line**, so `playmaker list`
+  shows the agent session late — do not conclude a dispatch failed just because the id has not
+  appeared yet.
+- Sessions are **per-cwd**: `kimi session list` from another directory shows nothing. Track the
+  session through playmaker, not through the CLI.
+- The stream carries **no token/cost fields** — there is nothing to budget against mid-run.
+- Exit codes: **exit 1 is non-retryable** (auth, quota, unknown model — "is not configured in
+  config.toml"); **exit 75 is retryable**. Fix the cause on 1, re-dispatch on 75.
+- K3 is **slow on real tickets** — never `--sync` a big WP; dispatch detached and poll.
+- Needs **Node ≥ 22.19** — hence the wrapper binary; point `[agents.kimi] binary` at it.
+- **Always pass `-m kimi-code/k3-256k`** — the CLI default is the weaker K2.7 `kimi-for-coding`.
+
 ## Worktrees
 
 Parallel WPs that touch the same files collide. Give each its own git worktree and dispatch with

{playmaker_cli-0.10.0 → playmaker_cli-0.12.0}/skills/playmaker-coach/references/lanes.md

@@ -18,8 +18,9 @@ pays. Four lanes:
    (`haiku` for trivial mechanical work). playmaker runs it in `acceptEdits`: it writes freely
    inside `--cwd` and is refused outside it, so keep every path in the prompt inside `--cwd`.
 
-4. **External dispatch — `codex` / `agy` / `opencode`.** Each on its own subscription or plan — the
-   home for write-heavy parallel implementation that can leave the Anthropic subscription.
+4. **External dispatch — `codex` / `agy` / `opencode` / `kimi`.** Each on its own subscription or
+   plan — the home for write-heavy parallel implementation that can leave the Anthropic
+   subscription.
    - **`agy` (Antigravity)** carries more than Google models: alongside Gemini Flash and Pro tiers it
      serves **Claude Sonnet/Opus (Thinking)** and a GPT-OSS tier. Its Claude runs on *Google's*
      pool and spends none of the Anthropic bucket — but that roster has trailed Anthropic's own
@@ -29,6 +30,8 @@ pays. Four lanes:
    - **`opencode`** is the widest lane: one CLI over ~75 providers addressed as `provider/model` — a
      GLM coding plan, or a model running locally on this machine, which spends no subscription quota
      at all.
+   - **`kimi`** runs the Kimi Code CLI on its own subscription: senior tier (K3), native login, no
+     opencode.
 
 **Never write an agy or opencode model name from memory** — run `agy models` / `opencode models` and
 copy a line. Both rosters and their spelling move with releases, and playmaker validates `--model`

{playmaker_cli-0.10.0 → playmaker_cli-0.12.0}/skills/playmaker-coach/references/quotas.md

@@ -24,6 +24,9 @@ several tiers with independent buckets, and the whole point of pulling quotas is
 - **Codex:** the main block is the primary Codex window; `Codex — Spark` is a separate block with
   its own `Session` / `Weekly` rows for the Spark model, the junior Codex lane — route Spark work
   off that block, not off the main one.
+- **Kimi Code:** `Session` is its rolling 5-hour bucket and `Weekly` is the subscription's weekly
+  percentage bucket. They are independent of Claude, Codex and the opencode-backed plans, so Kimi
+  is a useful alternate lane when either of those two rows still has headroom.
 - **opencode:** the quota belongs to the *plan behind the provider*, not to the CLI — it appears
   under that provider (e.g. a GLM coding plan's session and weekly credit windows) and reads
   unsupported without a credential. A dispatch pointed at a **local** model spends nothing and never