Verified
New since your last visit
Unverified

Keyboard & TUI

General input

ItemDescription
#EnterSubmit the current input
#Shift-Enter / Ctrl-JInsert a newline in the input
#Up / DownBrowse input history
#EscClose a popup, cancel completion, or interrupt streaming and compaction
#Ctrl-CInterrupt streaming output, or clear the input box
#Ctrl-DExit when the input box is empty
#Ctrl-TExpand or collapse the todo list when it is truncated
#Ctrl-P / Ctrl-NPage through the experimental Updates panel

Mode switching

ItemDescription
#Shift-TabToggle Plan mode
#!Enter shell mode from an empty input box

Input & editing

ItemDescription
#Ctrl-GEdit the current input in an external editor
#Ctrl-VPaste an image or video from the clipboard (Unix, macOS)
#Ctrl--Undo
#Esc EscOpen the undo selector (double-press while idle)

During streaming

ItemDescription
#Ctrl-SSteer: inject the current input into the running turn

Tool output

ItemDescription
#Ctrl-OExpand or collapse tool output, shell output and compaction summaries

Approval panel

ItemDescription
#1 / 9Select the option at that index directly
#Ctrl-EExpand or collapse a diff or file preview in the panel
#Esc / Ctrl-C / Ctrl-DReject the current request

Slash Commands (Core)

Account & configuration

ItemDescription
#/loginPick an account or platform and sign in
#/logoutClear credentials for the selected account
#/providerOpen the interactive provider manager
#/modelSwitch the model used in this session
#/secondary-model / /subagent-modelPick the default model for subagents
#/settings / /configOpen the settings panel in the TUI
#/permissionSelect a permission mode
#/editorConfigure the external editor launched by Ctrl-G
#/themeSwitch the terminal colour theme
#/experiments / /experimentalOpen the experimental feature panel

Session management

ItemDescription
#/new / /clearStart a fresh session, discarding the current context
#/sessions / /resumeBrowse and switch to a historical session
#/forkFork a new session from this one, keeping full history
#/title / /renameShow or set the session title (max 200 characters)
#/compactCompact the conversation context to free tokens
#/undoUndo recent prompts from the active context
#/reload / /reload-tuiReload the session and apply the latest config.toml and tui.toml
#/tasks / /taskBrowse the background task list
#/add-dirAdd an extra workspace directory to this session
#/exit / /quit / /qExit the CLI

Modes & run control

ItemDescription
#/yolo / /yesPreselect Ask When Needed in the permission list
#/autoPreselect Never Ask in the permission list
#/planToggle Plan mode, or force it with on / off

Export & sharing

ItemDescription
#/export-md / /exportExport the session as a Markdown file
#/export-debug-zipExport the session as a debug ZIP archive
#/copyCopy the last assistant message to the clipboard
#/webOpen the current session in the web UI
#/desktop / /install-desktopOpen the Kimi Code desktop app page in your browser

Information & status

ItemDescription
#/help / /h / /?Show keyboard shortcuts and all available commands
#/statusShow version, model, working directory and permission mode
#/usageShow token usage, context consumption and quota
#/versionDisplay the CLI version number
#/btwOpen a side conversation in a forked sub-agent
#/feedback / /bugSubmit feedback with optional diagnostic logs and codebase context

Slash Commands (Tools)

Swarm & goals

ItemDescription
#/swarm on / /swarm offTurn swarm mode on or off without sending a prompt
#/swarm <task>Turn swarm mode on and send the task as a prompt
#/goalStart or manage an autonomous goal
#/goal pause / /goal resume / /goal cancel / /goal replacePause, resume, cancel or replace the saved goal
#/goal nextQueue an upcoming goal for this session

Extensibility

ItemDescription
#/mcpList MCP servers and their connection status
#/pluginsOpen the interactive plugin manager
#/initAnalyse the codebase and generate AGENTS.md

Built-in skill commands

ItemDescription
#/mcp-configConfigure MCP servers and handle MCP OAuth login
#/custom-themeCreate or edit a custom TUI colour theme
#/update-configInspect or edit config.toml and tui.toml
#/check-kimi-code-docsAnswer Kimi Code product questions against the official docs
#/import-from-cc-codexImport Claude Code and Codex instructions, skills and MCP settings
#/sub-skillReorganise the local skill inventory into hierarchical bundles

Skill commands

ItemDescription
#/skill:<name>Invoke an activated external skill
#/<parent>.<sub-skill>Invoke an external sub-skill by its dotted name

CLI & Subcommands

Flags

ItemDescription
#-V, --version / -h, --helpPrint the version number
#-S, --session [id]Resume a session; with no id, pick interactively
#-c, --continueContinue the previous session for this working directory
#-m, --model <model>Model alias for this invocation
#-p, --prompt <prompt>Run one prompt non-interactively and print the response
#--output-format <format>Output format for prompt mode: text or stream-json
#-y, --yoloStart in Ask When Needed mode
#--autoStart in Never Ask mode — nothing interrupts you
#--planStart in Plan mode
#--skills-dir <dir>Load skills from this directory instead of auto-discovery; repeatable
#--agent <name>Agent profile for the new session
#--agent-file <path>Load an agent definition from a Markdown file for this launch
#--add-dir <dir>Add an extra workspace directory for this session; repeatable

Subcommands

ItemDescription
#kimi exportExport a session as a ZIP archive
#kimi forkFork a session into a new session
#kimi sessionManage sessions non-interactively
#kimi providerManage LLM providers non-interactively
#kimi loginAuthenticate via the device-code flow
#kimi doctorValidate the configuration files
#kimi webRun the local Kimi server and open the web UI
#kimi serverDeprecated — use kimi web instead
#kimi acpRun Kimi Code as an Agent Client Protocol server over stdio
#kimi visLaunch the session visualiser in your browser
#kimi install-desktopPrint the desktop app page and open it in your browser
#kimi migrateMigrate data from a legacy kimi-cli installation
#kimi upgrade / kimi updateUpgrade Kimi Code to the latest version

Settings (config.toml)

Files

ItemDescription
#~/.kimi-code/config.tomlMain config, created on first run
#~/.kimi-code/tui.tomlTerminal-UI and client preferences, alongside config.toml
#.kimi-code/local.tomlProject-local settings that should not be shared
#$KIMI_CODE_HOME/SYSTEM.mdPermanently replaces the main agent’s system prompt
#kimi doctorValidate the configuration files

Top-level

ItemDescription
#default_modelDefault model alias; must be defined in models
#default_permission_modePermission mode for new sessions: manual, yolo or auto
#default_plan_modeWhether new sessions start in Plan mode
#merge_all_available_skillsMerge skills from all available directories
#extra_skill_dirs / extra_agent_dirsExtra skill search directories layered on the defaults
#builtin_product_skillsOffer the built-in skills documenting Kimi Code to the model
#telemetryAnonymous telemetry; disabled only when explicitly set to false

Models & providers

ItemDescription
#[providers."<id>"]API provider entry: type, base_url, api_key
#[models."<alias>"]Model alias entry
#[secondary_model]Subagent model pool
#[thinking]Thinking-mode defaults: enabled, effort, keep
#[token_counting]How context tokens are reported externally

Runtime

ItemDescription
#[loop_control]Agent loop limits
#[background]Background task runtime
#[subagent] / [swarm]Subagent and AgentSwarm limits such as timeout_ms
#[tools]Global tool switch
#[read]Character limits and resumable long-line file reads
#[image]Image compression parameters such as max_edge_px
#[database]Session-index read model and global search worker
#[watch]Filesystem watchers that reload local.toml, AGENTS.md, skills and MCP config
#[services]Built-in external services
#[identity]Custom agent identity — the name it calls itself and its client slug

Permissions & hooks

ItemDescription
#[[permission.rules]]Initial permission rules, each a decision plus a pattern
#[[hooks]]Lifecycle hooks, declared as an array of tables

tui.toml

ItemDescription
#themeColour theme: auto, dark, light or a custom theme name
#render_latex / disable_paste_burstRender LaTeX in messages as Unicode text; false keeps the raw source
#cache_expiry_hint / disable_feedback_surveyWarn that the context cache may have expired on resume or after a long idle
#[editor].commandExternal editor command; empty falls back to $VISUAL / $EDITOR
#[notifications].enabledSend desktop notifications
#[upgrade].auto_installInstall new versions automatically
#[status_line].itemsFooter slots and order: mode, goal, model, tasks, cwd, git, tips
#[status_line].commandCustom status-line command; its first stdout line replaces the footer
#[markdown].mermaidRender fenced mermaid code blocks in the terminal as diagrams; "off" disables it

Project-local

ItemDescription
#[workspace].additional_dirExtra absolute workspace directories for every session of this project

Environment Variables

Core paths

ItemDescription
#KIMI_CODE_HOMEData root; defaults to ~/.kimi-code
#KIMI_DISABLE_TELEMETRYTurn off anonymous telemetry reporting
#KIMI_CODE_CUSTOM_HEADERSAttach newline-separated Name: Value headers to every model request
#KIMI_CODE_PASSWORDParallel auth credential for kimi web

Models

ItemDescription
#KIMI_MODEL_NAMESynthesise a temporary in-memory provider and model, without touching config.toml
#KIMI_MODEL_THINKING_EFFORTForce a thinking effort, bypassing the model’s declared support_efforts
#KIMI_MODEL_TEMPERATURE / KIMI_MODEL_TOP_P / KIMI_MODEL_MAX_COMPLETION_TOKENSSampling controls applied to every request

Runtime switches

ItemDescription
#KIMI_CODE_BACKGROUND_KEEP_ALIVE_ON_EXITKeep background tasks when the session closes
#KIMI_CODE_BACKGROUND_MAX_RUNNING_TASKSCap concurrently running background tasks
#KIMI_CODE_AGENT_SWARM_MAX_CONCURRENCYCap AgentSwarm subagents during the initial ramp
#KIMI_SUBAGENT_TIMEOUT_MS / KIMI_CODE_SWARM_TIMEOUT_MSWall-clock ceiling for one Agent subagent
#KIMI_LOOP_MAX_STEPS_PER_TURN / KIMI_LOOP_MAX_ATTEMPTS_PER_STEPMax agent steps per turn; 0 is unlimited
#KIMI_MCP_STARTUP_TIMEOUT_MS / KIMI_MCP_TOOL_TIMEOUT_MSDefault MCP connection timeout
#KIMI_CODE_PLUGIN_MARKETPLACE_URLOverride the marketplace JSON loaded by /plugins
#KIMI_CODE_NO_AUTO_UPDATEDisable the update preflight entirely
#KIMI_DISABLE_CRONDisable the scheduled-task tool
#KIMI_CODE_INFINITE_RETRYRetry failed LLM requests indefinitely
#KIMI_CODE_PERMISSION_MODE_REMINDERSet to 0 to stop injecting the auto permission-mode reminders into the model context
#KIMI_CODE_WATCHDisable filesystem watchers for config and skill files

Experimental (churns between releases)

ItemDescription
#KIMI_CODE_EXPERIMENTAL_FLAGEnable every registered experimental feature for this process
#KIMI_CODE_EXPERIMENTAL_SUBAGENT_FORKStart a subagent from a snapshot of the caller’s history
#KIMI_CODE_TUI_FULL_SCREENExperimental fullscreen UI
#KIMI_CODE_SEARCH_WORKER / KIMI_CODE_PERSISTENCE_MINIDB_READMODELRun the global search index in a dedicated worker thread

Diagnostics

ItemDescription
#KIMI_LOG_LEVELLog level: off, error, warn, info, debug

Skills, Agents & AGENTS.md

Skills

ItemDescription
#SKILL.mdThe main file of a directory-form skill
#$KIMI_CODE_HOME/skills/Kimi-specific user skills; moves with the data root
#~/.agents/skills/Generic user skills, shared across tools
#.kimi-code/skills/ / .agents/skills/Project skills
#--skills-dirLoad skills from an explicit directory instead of auto-discovery
#extra_skill_dirsExtra skill search directories layered on the defaults

Agents

ItemDescription
#$KIMI_CODE_HOME/agents/ / ~/.agents/agents/Kimi-specific user agents
#.kimi-code/agents/ / .agents/agents/Project agents
#override: trueLets an agent file replace a same-name built-in agent
#${base_prompt}Embeds the effective default system prompt inside an agent file
#--agent / --agent-fileSelect an agent profile for a new session

AGENTS.md

ItemDescription
#/initAnalyse the codebase and generate AGENTS.md
#AGENTS.mdProject instructions at the project root
#.kimi-code/AGENTS.mdProject-level Kimi-specific instructions
#$KIMI_CODE_HOME/AGENTS.mdGlobal Kimi-specific instructions; moves with the data root
#~/.agents/AGENTS.mdGeneric cross-tool instructions in the real OS home

Plugins

ItemDescription
#/pluginsPlugin manager with Installed, Official, Curated and Custom tabs
#KIMI_CODE_PLUGIN_MARKETPLACE_URLPoint /plugins at a different marketplace JSON

Hooks & MCP

Hook configuration

ItemDescription
#[[hooks]]One hook entry in config.toml
#matcherRegex filtering which event targets fire the hook
#exit 0 / exit 2Hook exit codes: 0 allows, 2 blocks

Hook events

ItemDescription
#UserPromptSubmit / UserPromptQueuedFires when you send a message; can block the model call this turn
#PreToolUseFires before a tool call, ahead of permission checks; blocking stops the tool
#PostToolUse / PostToolUseFailureFires after a tool succeeds
#PermissionRequest / PermissionResultFires just before waiting for approval
#SessionStart / SessionEndFires after a session starts or resumes
#SessionHeartbeatFires every 60 seconds while the session is alive
#TurnStartedFires when a new turn begins, with its origin kind
#Stop / StopFailureFires when the model is about to end the turn; blocking lets it continue
#InterruptFires when you interrupt the turn, in place of Stop
#SubagentStart / SubagentStopFires around sub-agent runs
#TaskStartedFires when a background task starts
#PreCompactFires before context compaction; return values are ignored entirely

MCP

ItemDescription
#mcp.jsonMCP server configuration, at user and project level
#mcp__<server>__<tool>How MCP tools are named for permission rules
#[mcp] startup_timeout_ms / [mcp] tool_timeout_msGlobal MCP connection timeout, default 30000 ms
#kimi acpRun Kimi Code as an Agent Client Protocol server over stdio
#kimi webRun the local server and web UI
No matches — clear search to see everything.