kimi-cli
Kimi Code CLI is your next CLI agent.
File Explorer
Download Latest Version (.zip)- SKILL.md
- prompt-patterns.md
- inspect_session.py
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- action.yml
- 1-bug-report.yml
- 2-feature-request.yml
- config.yml
- ci-docs.yml
- ci-kimi-cli.yml
- ci-kimi-sdk.yml
- ci-kosong.yml
- ci-pykaos.yml
- docs-pages.yml
- pr-title-checker.yml
- release-kimi-cli.yml
- release-kimi-sdk.yml
- release-kosong.yml
- release-pykaos.yml
- translator.yml
- typos.yml
- dependabot.yml
- pr-title-checker-config.json
- pull_request_template.md
- EvolutionBanner.vue
- index.ts
- style.css
- config.ts
- config-files.md
- data-locations.md
- env-vars.md
- overrides.md
- providers.md
- agents.md
- hooks.md
- mcp.md
- plugins.md
- print-mode.md
- skills.md
- wire-mode.md
- getting-started.md
- ides.md
- integrations.md
- interaction.md
- sessions.md
- use-cases.md
- keyboard.md
- kimi-acp.md
- kimi-command.md
- kimi-info.md
- kimi-mcp.md
- kimi-term.md
- kimi-vis.md
- kimi-web.md
- slash-commands.md
- breaking-changes.md
- changelog.md
- faq.md
- index.md
- acp-integration.gif
- setup.jpg
- shell-mode.gif
- vscode.png
- sync-changelog.mjs
- config-files.md
- data-locations.md
- env-vars.md
- overrides.md
- providers.md
- agents.md
- hooks.md
- mcp.md
- plugins.md
- print-mode.md
- skills.md
- wire-mode.md
- getting-started.md
- ides.md
- integrations.md
- interaction.md
- sessions.md
- use-cases.md
- keyboard.md
- kimi-acp.md
- kimi-command.md
- kimi-info.md
- kimi-mcp.md
- kimi-term.md
- kimi-vis.md
- kimi-web.md
- slash-commands.md
- breaking-changes.md
- changelog.md
- faq.md
- index.md
- .gitignore
- .pre-commit-config.yaml
- AGENTS.md
- bun.lock
- index.md
- package.json
- main.py
- pyproject.toml
- README.md
- main.py
- pyproject.toml
- README.md
- __init__.py
- ls.py
- main.py
- myagent.yaml
- pyproject.toml
- README.md
- main.py
- pyproject.toml
- README.md
- main.py
- pyproject.toml
- README.md
- agent.yaml
- main.py
- pyproject.toml
- README.md
- calc.ts
- greet.py
- plugin.json
- SKILL.md
- .gitignore
- .pre-commit-config.yaml
- klip-0-klip.md
- klip-1-kimi-cli-monorepo.md
- klip-10-agent-flow.md
- klip-11-kimi-code-rename.md
- klip-12-wire-initialize-external-tools.md
- klip-14-kimi-code-oauth-login.md
- klip-15-kagent-sidecar-integration.md
- klip-2-acpkaos.md
- klip-3-kimi-cli-user-docs.md
- klip-6-setup-auto-refresh-models.md
- klip-7-kimi-sdk.md
- klip-8-config-and-skills-layout.md
- klip-9-shell-ui-flicker-mitigation.md
- __init__.py
- _current.py
- local.py
- path.py
- py.typed
- ssh.py
- test_kaos_path.py
- test_local_kaos.py
- test_local_kaos_cmd.py
- test_local_kaos_sh.py
- test_ssh_kaos.py
- .pre-commit-config.yaml
- CHANGELOG.md
- LICENSE
- NOTICE
- pyproject.toml
- README.md
- __init__.py
- pyproject.toml
- README.md
- __init__.py
- dsl.py
- echo.py
- scripted_echo.py
- __init__.py
- chaos.py
- kimi.py
- mock.py
- openai_common.py
- __init__.py
- anthropic.py
- common.py
- google_genai.py
- openai_legacy.py
- openai_responses.py
- __init__.py
- linear.py
- __init__.py
- __init__.py
- empty.py
- error.py
- mcp.py
- simple.py
- __init__.py
- aio.py
- jsonschema.py
- typing.py
- __init__.py
- __main__.py
- _generate.py
- message.py
- py.typed
- common.py
- test_anthropic.py
- test_anthropic_error_handling.py
- test_google_genai.py
- test_kimi.py
- test_openai_legacy.py
- test_openai_responses.py
- test_anthropic_thinking.py
- test_chat_provider.py
- test_context.py
- test_echo_chat_provider.py
- test_generate.py
- test_json_schema_deref.py
- test_kimi_stale_api_key.py
- test_kimi_stream_usage.py
- test_kimi_tool_conversion.py
- test_message.py
- test_openai_common.py
- test_scripted_echo_chat_provider.py
- test_step.py
- test_tool_call.py
- test_tool_result.py
- test_trace_id.py
- .pre-commit-config.yaml
- CHANGELOG.md
- LICENSE
- NOTICE
- pyproject.toml
- README.md
- build_vis.py
- build_web.py
- check_kimi_dependency_versions.py
- check_version_tag.py
- cleanup_tmp_sessions.py
- inject_build_sha.py
- install.ps1
- install.sh
- telemetry_debug_server.py
- __init__.py
- py.typed
- test_smoke.py
- CHANGELOG.md
- LICENSE
- NOTICE
- pyproject.toml
- README.md
- __init__.py
- AGENTS.md
- convert.py
- kaos.py
- mcp.py
- server.py
- session.py
- tools.py
- types.py
- version.py
- agent.yaml
- coder.yaml
- explore.yaml
- plan.yaml
- system.md
- agent.yaml
- __init__.py
- models.py
- runtime.py
- __init__.py
- oauth.py
- platforms.py
- __init__.py
- agent_runner.py
- ids.py
- manager.py
- models.py
- store.py
- summary.py
- worker.py
- __init__.py
- __main__.py
- _lazy_group.py
- export.py
- info.py
- mcp.py
- plugin.py
- toad.py
- vis.py
- web.py
- Makefile
- __init__.py
- config.py
- engine.py
- events.py
- runner.py
- __init__.py
- llm.py
- manager.py
- models.py
- notifier.py
- store.py
- wire.py
- __init__.py
- manager.py
- tool.py
- __init__.py
- compact.md
- init.md
- __init__.py
- d2.py
- mermaid.py
- __init__.py
- SKILL.md
- SKILL.md
- __init__.py
- afk_mode.py
- plan_mode.py
- __init__.py
- agent.py
- approval.py
- btw.py
- compaction.py
- context.py
- denwarenji.py
- dynamic_injection.py
- kimisoul.py
- message.py
- slash.py
- toolset.py
- __init__.py
- builder.py
- core.py
- git_context.py
- models.py
- output.py
- registry.py
- runner.py
- store.py
- __init__.py
- crash.py
- sink.py
- transport.py
- __init__.py
- description.md
- __init__.py
- description.md
- __init__.py
- list.md
- output.md
- stop.md
- __init__.py
- dmail.md
- __init__.py
- glob.md
- glob.py
- grep.md
- grep_local.py
- plan_mode.py
- read.md
- read.py
- read_media.md
- read_media.py
- replace.md
- replace.py
- utils.py
- write.md
- write.py
- __init__.py
- description.md
- enter.py
- enter_description.md
- heroes.py
- __init__.py
- bash.md
- __init__.py
- think.md
- __init__.py
- set_todo_list.md
- __init__.py
- fetch.md
- fetch.py
- search.md
- search.py
- __init__.py
- AGENTS.md
- display.py
- test.py
- utils.py
- __init__.py
- __init__.py
- visualize.py
- __init__.py
- _approval_panel.py
- _blocks.py
- _btw_panel.py
- _input_router.py
- _interactive.py
- _live_view.py
- _question_panel.py
- __init__.py
- console.py
- debug.py
- echo.py
- export_import.py
- keyboard.py
- mcp_status.py
- migration_nudge.py
- oauth.py
- placeholders.py
- prompt.py
- replay.py
- session_picker.py
- setup.py
- slash.py
- startup.py
- task_browser.py
- update.py
- usage.py
- __init__.py
- theme.py
- __init__.py
- columns.py
- diff_render.py
- markdown.py
- markdown_sample.md
- markdown_sample_short.md
- syntax.py
- __init__.py
- aiohttp.py
- aioqueue.py
- broadcast.py
- changelog.py
- clipboard.py
- datetime.py
- diff.py
- editor.py
- environment.py
- envvar.py
- export.py
- file_filter.py
- frontmatter.py
- io.py
- logging.py
- media_tags.py
- message.py
- path.py
- proctitle.py
- proxy.py
- pyinstaller.py
- sensitive.py
- server.py
- shell_quoting.py
- signals.py
- slashcmd.py
- string.py
- subprocess_env.py
- term.py
- typing.py
- windows_paths.py
- __init__.py
- sessions.py
- statistics.py
- system.py
- __init__.py
- app.py
- __init__.py
- config.py
- open_in.py
- sessions.py
- __init__.py
- messages.py
- process.py
- worker.py
- __init__.py
- sessions.py
- __init__.py
- app.py
- auth.py
- models.py
- __init__.py
- file.py
- jsonrpc.py
- protocol.py
- root_hub.py
- serde.py
- server.py
- types.py
- __init__.py
- __main__.py
- agentspec.py
- app.py
- CHANGELOG.md
- config.py
- constant.py
- exception.py
- llm.py
- mcp_oauth.py
- metadata.py
- py.typed
- session.py
- session_fork.py
- session_state.py
- share.py
- __init__.py
- conftest.py
- test_protocol_v1.py
- test_server_initialize.py
- test_session_notifications.py
- test_version.py
- test_ascii_header.py
- test_oauth_cross_process.py
- test_oauth_refresh.py
- test_platforms.py
- test_resolve_api_key.py
- test_agent_timeout.py
- test_ids.py
- test_manager.py
- test_models.py
- test_store.py
- test_worker.py
- test_mcp_oauth.py
- test_afk_injection.py
- test_agent_cutover.py
- test_agent_flow.py
- test_agent_spec.py
- test_approval_afk.py
- test_approval_runtime.py
- test_approval_telemetry.py
- test_ask_user_plan_mode.py
- test_auth_error_handling.py
- test_background_agent_kill.py
- test_config.py
- test_context.py
- test_context_pending_tokens.py
- test_create_llm.py
- test_default_agent.py
- test_dynamic_injection_hooks.py
- test_exceptions.py
- test_exit_nudge.py
- test_export_cli.py
- test_inspect_plan_edit_target.py
- test_kimisoul_background_wait.py
- test_kimisoul_completion_budget.py
- test_kimisoul_ralph_loop.py
- test_kimisoul_repeat.py
- test_kimisoul_retry_recovery.py
- test_kimisoul_slash_commands.py
- test_kimisoul_steer.py
- test_kimisoul_think_only.py
- test_kimisoul_turn_balance.py
- test_load_agent.py
- test_load_agents_md.py
- test_migration_nudge.py
- test_normalize_history.py
- test_notifications.py
- test_plan_flag.py
- test_plan_mode.py
- test_plan_mode_injection_provider.py
- test_plan_mode_reminder.py
- test_plan_slash.py
- test_plugin.py
- test_plugin_manager.py
- test_plugin_tool.py
- test_prepare_soul.py
- test_print_background_integration.py
- test_resume_protocol.py
- test_runtime_afk_state.py
- test_runtime_roles.py
- test_session.py
- test_session_fork.py
- test_session_logging.py
- test_session_state.py
- test_shell_mcp_status.py
- test_shutdown_background_tasks.py
- test_simple_compaction.py
- test_skill.py
- test_skills_prompt.py
- test_skip_afk_prompt_injection.py
- test_slash_afk.py
- test_soul_import_command.py
- test_soul_message.py
- test_startup_imports.py
- test_startup_progress.py
- test_status_formatting.py
- test_str_replace_file_plan_mode.py
- test_subagent_builder.py
- test_subagent_resume_e2e.py
- test_subagent_store.py
- test_toolset.py
- test_welcome_migration_item.py
- test_wire_message.py
- test_wire_plan_mode.py
- test_wire_server_steer.py
- test_write_file_plan_mode.py
- __init__.py
- shell_pty_helpers.py
- test_basic_e2e.py
- test_cli_error_output.py
- test_file_mention_e2e.py
- test_hooks_wire_e2e.py
- test_kimi_empty_tool_call_content_e2e.py
- test_media_e2e.py
- test_shell_modal_e2e.py
- test_shell_pty_e2e.py
- test_slash_completion_enter_tmux.py
- test_subagent_smoke_e2e.py
- __init__.py
- test_config.py
- test_engine.py
- test_integration.py
- test_runner.py
- test_notification_manager.py
- __init__.py
- test_crash.py
- test_instrumentation.py
- test_telemetry.py
- test_additional_dirs.py
- test_agent_tool.py
- test_ask_user.py
- test_background_tools.py
- test_extract_key_argument.py
- test_fetch_url.py
- test_glob.py
- test_grep.py
- test_mcp_tool_result.py
- test_plan_yolo.py
- test_read_file.py
- test_read_media_file.py
- test_read_media_file_desc.py
- test_shell_bash.py
- test_str_replace_file.py
- test_todo.py
- test_tool_descriptions.py
- test_tool_schemas.py
- test_write_file.py
- __init__.py
- test_console_pager.py
- test_console_theme.py
- test_update_gate.py
- test_usage.py
- test_acp_convert.py
- test_acp_server_auth.py
- test_background_completion_watcher.py
- test_btw.py
- test_empty_think_part_indicator.py
- test_export_import.py
- test_file_completer.py
- test_live_view_notifications.py
- test_modal_lifecycle.py
- test_print_exit_code.py
- test_print_final_only.py
- test_print_notifications.py
- test_prompt_clipboard.py
- test_prompt_external_editor.py
- test_prompt_history.py
- test_prompt_placeholders.py
- test_prompt_tips.py
- test_question_panel.py
- test_render_to_ansi.py
- test_replay.py
- test_root_hub_watcher_resilience.py
- test_sanitize_surrogates.py
- test_shell_editor_slash.py
- test_shell_export_import_commands.py
- test_shell_feedback_slash.py
- test_shell_prompt_echo.py
- test_shell_prompt_router.py
- test_shell_run_placeholders.py
- test_shell_slash_commands.py
- test_shell_switch_slash.py
- test_shell_task_slash.py
- test_shell_upgrade_slash.py
- test_slash_completer.py
- test_status_block.py
- test_streaming_content_block.py
- test_task_browser.py
- test_theme.py
- test_tool_call_block.py
- test_visualize_running_prompt.py
- test_aiohttp_timeout.py
- test_atomic_json_write.py
- test_broadcast_queue.py
- test_changelog.py
- test_datetime.py
- test_diff_nonblocking.py
- test_diff_render.py
- test_diff_utils.py
- test_editor.py
- test_file_filter.py
- test_file_utils.py
- test_frontmatter.py
- test_is_within_workspace.py
- test_list_directory.py
- test_message_utils.py
- test_normalize_user_path.py
- test_proxy.py
- test_pyinstaller_utils.py
- test_result_builder.py
- test_rich_markdown.py
- test_sensitive.py
- test_server.py
- test_shell_quoting.py
- test_shorten.py
- test_slash_command.py
- test_subprocess_env.py
- test_typing_utils.py
- test_utils_environment.py
- test_utils_path.py
- test_windows_paths.py
- test_app.py
- test_open_in.py
- test_session_error_recovery.py
- test_sessions_api.py
- test_static_cache_headers.py
- __init__.py
- conftest.py
- test_additional_dirs_state.py
- test_attachment_cache.py
- test_clipboard.py
- test_constant.py
- test_git_context.py
- prepare_env.sh
- run_smoke.sh
- local_kimi_cli_agent.py
- README.md
- terminal_bench_2_tasks_default.txt
- main.yaml
- run.py
- worker.yaml
- test_cli_loading_time.md
- test_encoding_error_handling.md
- test_utf8_encoding.md
- __init__.py
- AGENTS.md
- test_mcp_cli.py
- test_wire_approvals_tools.py
- test_wire_auth.py
- test_wire_config.py
- test_wire_errors.py
- test_wire_prompt.py
- test_wire_protocol.py
- test_wire_question.py
- test_wire_real_llm.py
- test_wire_sessions.py
- test_wire_skills_mcp.py
- test_wire_steer.py
- wire_helpers.py
- alert-dialog.tsx
- select.tsx
- tooltip.tsx
- markdown.tsx
- agent-scope-bar.tsx
- agents-panel.tsx
- assistant-message.tsx
- context-space-map.tsx
- context-viewer.tsx
- tool-call-block.tsx
- user-message.tsx
- dual-view.tsx
- session-picker.tsx
- explorer-toolbar.tsx
- project-group.tsx
- session-card.tsx
- sessions-explorer.tsx
- state-viewer.tsx
- statistics-view.tsx
- decision-path.tsx
- integrity-check.tsx
- timeline-view.tsx
- tool-call-detail.tsx
- tool-stats-dashboard.tsx
- turn-efficiency.tsx
- turn-tree.tsx
- usage-chart.tsx
- wire-event-card.tsx
- wire-filters.tsx
- wire-viewer.tsx
- use-theme.ts
- api.ts
- cache.ts
- utils.ts
- App.tsx
- index.css
- main.tsx
- components.json
- index.html
- package-lock.json
- package.json
- tsconfig.app.json
- tsconfig.json
- tsconfig.node.json
- vite.config.ts
- logo.png
- generate-api.sh
- chain-of-thought.tsx
- code-block.tsx
- confirmation.tsx
- context.tsx
- conversation.tsx
- index.ts
- loader.tsx
- message.tsx
- model-selector.tsx
- prompt-input.tsx
- reasoning.tsx
- shimmer.tsx
- streamdown.tsx
- subagent-steps.tsx
- tool.tsx
- guess-lang.ts
- index.ts
- parse.ts
- index.tsx
- lazy.tsx
- theme.css
- alert-dialog.tsx
- alert.tsx
- badge.tsx
- button-group.tsx
- button.tsx
- card.tsx
- carousel.tsx
- checkbox.tsx
- collapsible.tsx
- command.tsx
- context-menu.tsx
- dialog.tsx
- dropdown-menu.tsx
- hover-card.tsx
- input-group.tsx
- input.tsx
- kbd.tsx
- progress.tsx
- resizable.tsx
- scroll-area.tsx
- select.tsx
- separator.tsx
- sonner.tsx
- switch.tsx
- textarea.tsx
- theme-toggle.tsx
- toggle-group.tsx
- toggle.tsx
- tooltip.tsx
- error-boundary.tsx
- kimi-cli-brand.tsx
- media.ts
- index.tsx
- open-in-button.tsx
- toolbar-changes.tsx
- toolbar-context.tsx
- toolbar-queue.tsx
- toolbar-todo.tsx
- activity-status-indicator.tsx
- approval-dialog.tsx
- assistant-message.tsx
- attachment-button.tsx
- chat-conversation.tsx
- chat-prompt-composer.tsx
- chat-workspace-header.tsx
- open-in-menu.tsx
- question-dialog.tsx
- session-files-panel.tsx
- session-info-popover.tsx
- virtualized-message-list.tsx
- chat-workspace-container.tsx
- chat.tsx
- file-mention-menu.tsx
- global-config-controls.tsx
- message-search-dialog.tsx
- message-search-utils.ts
- open-in-shared.ts
- queue-store.ts
- slash-command-menu.tsx
- useFileMentions.ts
- useSlashCommands.ts
- create-session-dialog.tsx
- sessions.tsx
- display-content.tsx
- store.ts
- types.ts
- use-theme.ts
- useGitDiffStats.ts
- useGlobalConfig.ts
- useSessions.ts
- useSessionStream.ts
- useVideoThumbnail.ts
- utils.ts
- wireTypes.ts
- FILES
- VERSION
- ConfigApi.ts
- DefaultApi.ts
- index.ts
- OpenInApi.ts
- SessionsApi.ts
- WorkDirsApi.ts
- ConfigApi.md
- ConfigModel.md
- ConfigToml.md
- CreateSessionRequest.md
- DefaultApi.md
- GenerateTitleRequest.md
- GenerateTitleResponse.md
- GitDiffStats.md
- GitFileDiff.md
- GlobalConfig.md
- HTTPValidationError.md
- ModelCapability.md
- OpenInApi.md
- OpenInRequest.md
- OpenInResponse.md
- ProviderType.md
- Session.md
- SessionsApi.md
- SessionStatus.md
- UpdateConfigTomlRequest.md
- UpdateConfigTomlResponse.md
- UpdateGlobalConfigRequest.md
- UpdateGlobalConfigResponse.md
- UpdateSessionRequest.md
- UploadSessionFileResponse.md
- ValidationError.md
- ValidationErrorLocInner.md
- WorkDirsApi.md
- ConfigModel.ts
- ConfigToml.ts
- CreateSessionRequest.ts
- GenerateTitleRequest.ts
- GenerateTitleResponse.ts
- GitDiffStats.ts
- GitFileDiff.ts
- GlobalConfig.ts
- HTTPValidationError.ts
- index.ts
- ModelCapability.ts
- OpenInRequest.ts
- OpenInResponse.ts
- ProviderType.ts
- Session.ts
- SessionStatus.ts
- UpdateConfigTomlRequest.ts
- UpdateConfigTomlResponse.ts
- UpdateGlobalConfigRequest.ts
- UpdateGlobalConfigResponse.ts
- UpdateSessionRequest.ts
- UploadSessionFileResponse.ts
- ValidationError.ts
- ValidationErrorLocInner.ts
- .openapi-generator-ignore
- index.ts
- runtime.ts
- apiClient.ts
- auth.ts
- utils.ts
- version.ts
- App.tsx
- bootstrap.tsx
- index.css
- main.tsx
- react-scan.d.ts
- .gitignore
- biome.jsonc
- components.json
- index.html
- openapi.json
- openapitools.json
- package-lock.json
- package.json
- tsconfig.app.json
- tsconfig.json
- tsconfig.node.json
- vite.config.ts
- .gitignore
- .pre-commit-config.yaml
- .python-version
- AGENTS.md
- CHANGELOG.md
- CONTRIBUTING.md
- flake.lock
- flake.nix
- kimi.spec
- LICENSE
- Makefile
- NOTICE
- pyproject.toml
- pytest.ini
- README.md
- SECURITY.md
- uv.lock
# Installation Guide
1. Get the code
git clone https://github.com/MoonshotAI/kimi-cli
Downloads the entire project code from GitHub to your computer.
cd kimi-cli
Moves into the project folder you just downloaded.
2. Node.js
Easy RecommendedPrerequisites
make build-web # build the web UI and sync it into the package (requires Node.js/npm)
Compiles the code based on the generated build configuration to produce an executable.
After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.
Pulled directly from this repo's README.
3. Python
EasyPrerequisites
pip install .
Installs the package published on PyPI directly β no need to clone the source.
python <μ€νν νμΌλͺ
>.py # READMEμμ μ νν μ€ν νμΌλͺ
μ νμΈνμΈμ
Runs the Python script (or module).
If it runs without errors and prints output in the terminal, it worked.
4. Make
MediumPrerequisites
- Git Needed to download the project code from GitHub.
- Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).
make prepare # prepare the development environment
Compiles the code based on the generated build configuration to produce an executable.
make format # format code
Compiles the code based on the generated build configuration to produce an executable.
make check # run linting and type checking
Compiles the code based on the generated build configuration to produce an executable.
make test # run tests
Compiles the code based on the generated build configuration to produce an executable.
make test-kimi-cli # run Kimi CLI tests only
Compiles the code based on the generated build configuration to produce an executable.
If it finishes without errors, it worked. Try running the generated executable directly.
Pulled directly from this repo's README.
// repository documentation
Was this content helpful?
(0 ratings)