Smithery is now a part of Arcade.dev! Read more in our announcement here
Generate changelog entries for code changes.
Generate changelog entries for changes on the current branch relative to main, then sync to the docs site.
git log main..HEAD --oneline + git diff main..HEAD --stat.## Unreleased in CHANGELOG.md using the prefix table below. For changes scoped to a subpackage under packages/ or sdks/, also update that subpackage's CHANGELOG.md โ subpackage CHANGELOGs follow their own prefix conventions (e.g. packages/kosong/CHANGELOG.md uses provider prefixes like Kimi: / Anthropic:); only the root CHANGELOG follows the table below.node docs/scripts/sync-changelog.mjs.## ๆชๅๅธ in docs/zh/release-notes/changelog.md. Use the full-width colon ๏ผ. Follow docs/AGENTS.md terminology.## Unreleased in docs/en/release-notes/breaking-changes.md with Affected + Migration subsections, and under ## ๆชๅๅธ in docs/zh/release-notes/breaking-changes.md with ๅๅฝฑๅ + ่ฟ็งป subsections.- <Prefix>: <verb-led sentence, readable standalone> โ <optional rationale / before-after / migration>
; also, ; and, or nested em-dashes. Two changes = two bullets.Fix โฆ / Add โฆ / Switch โฆ / Bump โฆ.Lib: for SDK-facing changes.| Prefix | Scope |
|---|---|
Shell |
Interactive TUI: keys, status bar, slash commands, terminal rendering |
Web |
kimi web |
Vis |
kimi vis tracing visualizer |
CLI |
Top-level flags, subcommands, --print / --yolo / --afk |
ACP |
Zed / JetBrains and other ACP integrations |
Core |
Agent runtime, step loop, approval, quota, turns, background tasks |
Tool |
Any built-in tool; name the specific tool in the body (ReadFile, Grep, Todo, Plan, โฆ) |
Skill |
Skill discovery/loading, Flow, Loop (always singular โ not Skills:) |
MCP |
MCP server integration |
Plugin |
Plugin system, kimi plugin subcommands |
LLM |
Provider-agnostic or cross-provider; name the provider in the body (Kimi / Anthropic / OpenAI / DeepSeek โฆ). Do not create per-provider prefixes |
Kosong |
Changes to the kosong LLM abstraction layer surfaced in the root CHANGELOG (the subpackage's own CHANGELOG uses provider prefixes) |
Wire |
Wire protocol events, version |
Auth |
OAuth, token refresh, /login |
Config |
Config schema, env vars |
Lib |
SDK-facing API changes |
Build |
Nix / Rust / Python / packaging |
When unsure, match an existing entry of the same kind. Prefer this list; if you genuinely need a new prefix, raise it with maintainers and update this table in the same PR so the convention stays single-sourced.
Ordering: within each version, group bullets by prefix in the order of the table above. Order within a prefix is free โ keep the development order.
Starting from the next release, add **Highlights**: โฆ under each version header (1โ3 items most users will notice); mirror it as **ไบฎ็น**๏ผโฆ in Chinese. Skip on releases that are only internal or Lib:. Highlights summarize โ every highlighted item still needs its full bullet below. Do not backfill historical versions.
