Kimi Code CLI Cheatsheet - Moonshot Terminal AI Coding Agent
Kimi Code CLI is an agent that ships the model wiring with the binary: installed, it works, with no base_url to fill in, no SDK to configure, no PATH juggling, and little risk of colliding with global modules. That turnkey state suits two kinds of people - developers already inside the Kimi ecosystem, and anyone who simply wants a working terminal agent with zero setup. It is not closed, though: switching to another vendor's model means editing a user-level config file with the corresponding API key, with no need to migrate your workflow. This sheet covers installation and launch, interactive and one-shot execution, sessions and models, and subcommands and operations. A sensible order is to confirm one interactive session works, then learn single-shot execution for scripts, and only then handle session resumption and model switching. One practice is worth doing early: generating a project conventions file before a large change, so the agent starts work already knowing the repository's naming and layout habits - cheaper than correcting its style afterwards.
Install & Launch 4
npm install -g @moonshot-ai/kimi-codecurl -fsSL https://code.kimi.com/kimi-code/install.sh | bashkimi --versionkimiInteractive & Single Instructions 5
kimi -p "Show this project directory structure"kimi -C/login/logout/initSessions & Models 5
/model/compact/fork/sessionskimi acpSubcommands & Ops 20
kimi --session <id> / -Skimi --model <model> / -mkimi --yolo / -ykimi --autokimi --plankimi --skills-dir <dir>kimi --add-dir <dir>kimi --work-dir <dir> / -wkimi --thinking / --no-thinkingkimi --agent <name>kimi loginkimi server runkimi server statuskimi webkimi doctorkimi doctor configkimi doctor tuikimi export [sessionId]kimi upgradekimi providerTips
- Kimi Code CLI ships as a zero-dependency binary: one script install and it just works — no PATH fiddling, no conflicts with global modules.
kimi -pruns a single instruction andkimi -Cresumes a session — these are the workhorses for scripts and automation. Run/initbefore big tasks to generate AGENTS.md so the agent understands the project.- To use other vendors (Anthropic/OpenAI/Google), just edit
~/.kimi-code/config.tomlwith the corresponding API key.
FAQ
What is the relationship between the kimi command and the kimi-cli package?
This sheet covers Moonshot official Kimi Code CLI (npm package @moonshot-ai/kimi-code); the installed command is kimi. There is also a separate community Python package named kimi-cli, which is a different project.
Can Kimi Code CLI run on Windows?
Yes. On Windows run the install script irm https://code.kimi.com/kimi-code/install.ps1 | iex in PowerShell. Install Git for Windows first; the CLI uses its Git Bash as the shell environment.
Official References
Each command links to its official documentation below, so you can verify the latest usage and read deeper.
Maintained by LaoHand
Publicly updated on Aug 26, 2026, continuously proofread against official docs.
Contact Us
Wrong command or description? Send us corrections, business inquiries or product feedback by email.
Contact Us