Kimi Release Notes

Changed

• Conversation content now supports displaying images

Fixed

• Improved remote control experience: you can now select and switch between Agent Swarm modes
• Improved the annotation experience for third-party apps, now consistent with Office file annotations
• Fixed inaccurate citation matching and highlight positioning in PDFs
• Fixed an issue where WeChat scan-code login retry was triggered by mistake
• Fixed abnormal hover action button background on Markdown tables
• Fixed an issue where, in some cases, accounts were not reported to the device management page after login
• Fixed several bugs and improved some interactions and stability

Open a new Desktop chat from the terminal

The new kimi app [path] command opens Kimi Code Desktop with a new draft in the current or specified directory, making it easy to move from the CLI into the graphical interface. →

Experimental progress updates

NotifyUser lets the Agent post short progress updates mid-turn. It is off by default and can be enabled in the TUI /experiments panel or in the Web / Desktop settings Lab, applying only to sessions created afterward. →

Interruptible background waits

WaitFor is capped at 90 seconds. While it waits, pressing Enter or Ctrl-S steers your message into the current turn and ends the wait early, while background tasks keep running. →

Also in this release

Fullscreen mode keeps a one-line summary of each user message and lets you jump back to it; user skill cards are now highlighted prompts that can be sent with Ctrl-S.

Linux support

Desktop is now available for x86_64 Linux, with AppImage, deb, and RPM packages. →

Remote Control

Enable it under Settings → Remote Control, then use a link or QR code to control the local Agent from a phone, tablet, or another computer. Tasks and local tools still run on the computer running Desktop. →

File Tree panel

The new File Tree in the right sidebar browses, searches, and refreshes workspace files, with click-to-preview. Toggle it with Cmd + Shift + E on macOS or Ctrl + Shift + E on Windows and Linux.

Also in this release: experimental progress updates can be enabled under Settings → Lab for newly created sessions; the new kimi app command opens a new Desktop session in the current or a specified directory. → ·

Minor Changes

• #4159 0a3a2fb Thanks @RealKai42! - Add an opt-in NotifyUser progress update feature (off by default): new sessions can show the agent's mid-turn progress with an optional one-line title, enabled in the TUI /experiments or the web/Desktop settings' Lab section; set [experimental] notify_user = true or KIMI_CODE_EXPERIMENTAL_NOTIFY_USER=1 to turn it on.
• #4145 242ac23 Thanks @wbxl2000! - Add kimi app [path] to open a new desktop chat in the current or specified directory.
• #4061 20a2cea Thanks @chengluyu! - Cap the agent's in-turn wait for background tasks at 90 seconds (longer timeouts are no longer accepted), discourage repeated waits, and let a new message end the wait immediately.
• #3998 09af3b4 Thanks @tpoisonooo! - Tower mode: a message sent while the agent is running aborts the in-progress turn and runs as its own turn.
• #4031 33e368a Thanks @Grapedge! - Add sticky user message summaries in fullscreen mode; click a summary to jump to the original message.
• #4074 c9f01f0 Thanks @tpoisonooo! - Tower mode: deterministic orchestration with TowerRebase and LLM-free status, goal/tower mutual exclusion, and workspace protection.
• #4059 1f6f0b1 Thanks @7Sageer! - Add the KIMI_CODE_TRUST_WORKSPACE environment variable to mark the workspace as trusted.
• #4165 afd95f6 Thanks @Grapedge! - Replace user skill cards with highlighted prompts and support Ctrl-S for skill prompts.

Patch Changes

• #4183 c15638b Thanks @RealKai42! - Cancel in-flight video uploads when a media read is interrupted.
• #4081 06ebfc8 Thanks @sailist! - Fix shifted turns and lost replies when a UserPromptSubmit hook injects text; hook JSON output without a "message" field is no longer added to the conversation.
• #4154 419aced Thanks @7Sageer! - Fix media file reading on the first turn after resuming a session.
• #4083 f409caa Thanks @sailist! - Cron tasks from the source session no longer fire inside a forked session.
• #4152 f0bc988 Thanks @7Sageer! - Forked subagents now inherit the parent's available agent types, including custom agents.
• #4057 a940f2f Thanks @huangzheng2016! - Fix the permission mode switch in the goal-start approval prompt not taking effect on the v2 engine.
• #4081 06ebfc8 Thanks @sailist! - Fix messages rendering out of place in sessions with a UserPromptSubmit hook.
• #4153 7091138 Thanks @RealKai42! - Let the agent write one- or two-sentence progress notes between tool calls instead of bare status lines; in the experimental Updates panel (KIMI_CODE_EXPERIMENTAL_NOTIFY_USER=1), stop asking the agent to repost its mid-turn text as an update and remind it to post updates less often.
• #4054 4fbe065 Thanks @RealKai42! - Stop prompting the agent to send NotifyUser updates when a session is opened in a host that does not display them.
• #4091 21406fb Thanks @sailist! - Omit max_tokens for models without an explicit output limit, fixing repeated 400 errors on strict serving stacks (e.g. bare vLLM) when the model's max output size is unknown.
• #4184 cbd7540 Thanks @7Sageer! - Remove the never-implemented executor = "kaos" option from MCP stdio server configuration; configs using it now fail validation at load time.
• #2919 0f052fe Thanks @duyphan154! - Sanitize foreground Bash tool output so captured terminal escape sequences no longer change the host terminal state.
• #4164 3395f5b Thanks @huangzheng2016! - Show a "Shutting down" status hint while shutdown hooks run during exit, and let a Ctrl+C during that window force an immediate exit instead of waiting for the hook timeout.
• #4033 eec9bbd Thanks @Grapedge! - Feedback surveys now appear less often.
• #4160 72fc1d0 Thanks @kimi-agent-bot! - Show "Working…" in the status spinner while thinking.
• #4056 395d537 Thanks @7Sageer! - Replace inline MCP commands in the workspace trust prompt with activation summaries and configuration paths for manual inspection.
• #4076 e3bf50c Thanks @7Sageer! - Remove interruption reminders from the conversation when their interrupted turns are undone.
• #4031 33e368a Thanks @Grapedge! - Replace the user message bullet ✨ with ❯.
• #4221 2e6821d Thanks @kimi-agent-bot! - web: Improved interactions and fixed known bugs.

Changed

• PDF preview engine upgraded: fixed zoom, citation controls, and text selection gestures
• The built-in browser no longer gets interrupted when running tasks in the background
• Improved the styling of file, goal, and URL chips in the input box

Fixed

• Fixed naming and annotation issues with PPT files
• Improved position handling when dragging widgets and the desktop pet
• Quote annotation bubbles now expand / collapse on click
• Fixed an issue where side chats could be submitted twice
• Fixed the restoration of archived project folders
• Fixed an occasional freeze when locating citations
• Strengthened Windows storage recovery and migration protection
• Fixed an issue where using a plugin/skill while typing would clear the input box
• Fixed several bugs and improved some interactions and stability

New

• Notion and Lark docs now support human-AI co-editing:
  • Quickly open Notion and Lark docs from the homepage sidebar
  • Notion and Lark docs created via plugins are shown as artifact cards
  • Open Notion and Lark docs in the built-in browser, with support for editing comments and page Q&A

Changed

• Streamlined Agent process display: the Agent execution process is now collapsed by default, showing only the final reply — expand to view details
• Projects in the left sidebar now support drag-to-reorder
• You will be asked to confirm before signing out if tasks are still running

Fixed

• Fixed an issue where concurrent PPT editing could corrupt files
• Fixed an issue where console windows flashed when running tasks on Windows
• Opening a non-existent file now clearly prompts “File not found”
• Improved launch speed
• Fixed several bugs and improved some interactions and stability

New

• Remote control feature updates:
  • Preview Office, HTML, and other file types directly on your phone
  • Upload attachments from your phone to Kimi Work
• Added Side Chat: “Side Chat” has been added to the “+” panel — open an independent side conversation within a session, inheriting the original conversation's context
• Quote in conversations: select text in a conversation to quote and add it to the conversation
• Office files now support version history management — your changes are never lost and can be traced back
• Web annotations in the browser: annotate web pages in the browser and quote them into the input box

Changed

• “Keep Awake” now engages only on demand, reducing background power consumption

Fixed

• Fixed an issue where the window could not be restored after being closed from the Windows taskbar
• Fixed several bugs and improved some interactions and stability

Fullscreen mode (experimental)

A new experimental fullscreen interface: the transcript scrolls independently, text can be selected with the mouse, fold blocks expand or collapse on click, and a clickable "Jump to bottom" indicator sits at the bottom. Enable it under /settings → TUI mode, or set tui_mode = "fullscreen" in ~/.kimi-code/tui.toml, then restart Kimi Code. →

Faster startup, lower memory

Shorter CLI startup time and reduced memory usage — first paint arrives noticeably sooner in large projects.

File watching is now off by default

Filesystem watching for config and workspace files no longer runs by default; to hot-reload AGENTS.md, skills, or MCP config, set [watch] enabled = true or KIMI_CODE_WATCH=1. →

Also in this release: hardened workspace trust boundaries — file tools can no longer reach outside the working directory through symbolic links, and project-local config only takes effect after the workspace is trusted; new auto_session_title config to turn off automatic session title generation by clients. →

Minor Changes

• #3990 32000d0 Thanks @Grapedge! - In fullscreen, click a folded block to open or close it.
• #4004 e17ff67 Thanks @Grapedge! - Add a TUI mode setting to /settings with an experimental fullscreen layout; switching modes takes effect after restarting Kimi Code. You can also set tui_mode in ~/.kimi-code/tui.toml directly: "regular" renders into the terminal scrollback, while "fullscreen" makes parts of the UI mouse-interactive for a smoother experience.

Patch Changes

• #3964 6451f1e Thanks @7Sageer! - Block file tools from accessing files outside the working directory through symlinks.
• #3975 bb96d80 Thanks @RealKai42! - Reduce the CLI's startup time and memory usage.
• #3957 6a214b8 Thanks @huangzheng2016! - Fix a "Maximum call stack size exceeded" error when opening large sessions.
• #3974 994287a Thanks @liruifengv! - Fix forked sessions getting their titles overwritten by auto-generated titles.
• #3964 6451f1e Thanks @7Sageer! - Apply project-local configuration only after the workspace is trusted.
• #3964 6451f1e Thanks @7Sageer! - Block repository git configuration from executing commands during background git operations.
• #3969 b3212fd Thanks @sailist! - Skip cloud telemetry on the global login until its collector is live, and keep shutdown from aborting TUI exit.
• #3979 e796bb5 Thanks @sailist! - Fix MCP OAuth not requesting the offline_access scope, which caused hourly browser re-authorization with providers like Vercel.
• #3969 b3212fd Thanks @sailist! - Fix Remote Control failing to start after kimi login --region global.
• #3964 6451f1e Thanks @7Sageer! - Reject additional directories that resolve to the home directory or filesystem root.
• #3995 a54e6f6 Thanks @7Sageer! - Turn off repeat reminders and forced stops with KIMI_CODE_REPEAT_BREAKER=0.
• #3970 895e9d9 Thanks @chengluyu! - Fix missing Swarm members after reopening an interrupted conversation.
• #3989 a268ad7 Thanks @Grapedge! - Show a Thinking… spinner and keep the status row height steady during streaming.
• #3989 a268ad7 Thanks @Grapedge! - Add a clickable "Jump to bottom" indicator to the fullscreen TUI.
• #3976 f7012aa Thanks @tpoisonooo! - Tower mode: smaller missions, stricter completion and review checks, and review history in rework briefings.
• #3847 65ae3e3 Thanks @tpoisonooo! - Tower mode: mission titles must be ASCII, and task cards show the mission id.
• #3931 f17a22e Thanks @sailist! - Turn off filesystem watchers for config and workspace files by default. Set [watch] enabled to true or KIMI_CODE_WATCH=1 to turn them back on.
• #4005 ba41d07 Thanks @liruifengv! - web: Improved interactions and fixed known bugs.

Patch Changes

• #3922 9df7a9c Thanks @sailist! - Fix new messages occasionally landing at an old position in the conversation after resuming a session.
• #3911 88a7d93 Thanks @Grapedge! - Fix compaction failing after switching to a model with a smaller context window.
• #3929 6ffdf0d Thanks @7Hanrui! - The agent no longer assumes the current working directory is the project root.
• #3933 9721259 Thanks @liruifengv! - Fix a message sent while the agent was running sometimes appearing twice in the chat.
• #3934 2e605b1 Thanks @liruifengv! - web: Improved interactions and fixed known bugs.

Patch Changes

• #3878 f233f9d Thanks @7Sageer! - Stop listing unavailable media tools in subagent menus and clarify Read errors for images and videos.
• #3762 c5ad17f Thanks @7Sageer! - Providers can read their API key from a named environment variable (api_key_env in config.toml or the provider API).
• #3896 73ebe9a Thanks @sailist! - Keep follow-up messages sent during a turn from appearing twice after a session reload.
• #3889 5108cad Thanks @huangzheng2016! - Compact the session index on startup when many entries point to deleted sessions.
• #3889 5108cad Thanks @huangzheng2016! - Start the CLI faster by removing a duplicate skills directory scan.
• #3889 5108cad Thanks @huangzheng2016! - Open the session list and resume sessions faster on workspaces with many sessions.
• #3889 5108cad Thanks @huangzheng2016! - Resume long sessions faster.
• #3889 5108cad Thanks @huangzheng2016! - Index sessions for search in capped, incremental background passes, tunable via the [database] searchSyncSessionCap and searchSyncDebounceMs settings.
• #3864 25dd4ce Thanks @wbxl2000! - Rename the kimi install-app subcommand to kimi install-desktop; the old name keeps working as a hidden alias.
• #3910 7dc253c Thanks @sailist! - Restore thinking display for OpenAI-compatible providers that send a reasoning string next to an unrecognized reasoning_details array.
• #3875 c1047a6 Thanks @7Sageer! - Fix kimi -p exiting early and cancelling the active turn when a cron task fires.
• #3894 910aba2 Thanks @7Sageer! - Drop literal decision clauses from the system prompt and the auto permission mode reminder.
• #3889 5108cad Thanks @huangzheng2016! - Restore sessions with large file-edit histories faster.
• #3889 5108cad Thanks @huangzheng2016! - Serve session transcript APIs faster on repeated calls.
• #3885 5acc863 Thanks @starquakee! - select_tools now points out already-available tools to call directly and suggests announced names for near-miss selections.
• #3887 e3f48a2 Thanks @RealKai42! - Fix deleting or archiving a session sometimes never finishing.
• #3891 53e5e3f Thanks @sailist! - Keep follow-up messages sent during a turn attached to that turn in the conversation history.
• #3906 60f2a63 Thanks @sailist! - Keep a follow-up sent during a turn as one message, and undo the host turn instead of the follow-up alone.
• #3879 1fddc16 Thanks @7Sageer! - Remove the system-prompt rule that forbade all file access outside the working directory.
• #3892 a80fe31 Thanks @sailist! - Stop workspace file watchers from scanning an unbounded project root, and add [watch] enabled / KIMI_CODE_WATCH to disable watching entirely.
• #3869 86e0820 Thanks @sailist! - Stop asking for approval of bash commands that cannot be statically analyzed in Ask When Needed permission mode.

The Kimi Code desktop client is officially available: it carries the Agent core of Kimi Code CLI into a graphical interface, where you open a project, talk to the Agent, and ship changes in one window. Available now for macOS (Apple Silicon / Intel) and Windows. →

Every step stays visible

Tool calls, thinking, and the files changed in each turn are all presented in the interface; sensitive operations raise approval prompts, and three permission modes (Always Ask / Ask When Needed / Never Ask) keep you in control. →

A complete workflow from conversation to delivery

Goal mode keeps long-running objectives moving and can be paused, resumed, or cancelled; plan mode proposes an approach before touching files, and the plan can be reviewed and refined; long tasks can move to the background, where you can check progress or stop them at any time. →

Built-in browser and visual annotation

The browser lives in the right panel, with tabs that stay with the session and page context shared with the Agent; screenshot annotation, text selection comments, @ file mentions, and element picking on web pages tell the Agent exactly what to change. →

Download:

macOS · Apple Silicon · macOS · Intel · Windows