Skip to content
This repository was archived by the owner on Sep 23, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .agents/skills/release/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,15 +33,15 @@ The Rust implementation (`kagent`) lives in a separate repository and is **not**
- Update `breaking-changes.md` in both languages if there are breaking changes.
- If bumping `packages/kosong` or `packages/kaos`, also update the root `pyproject.toml` pinned dependency (`kosong[contrib]==<version>` or `pykaos==<version>`) so root validation keeps passing.

6. **Sync the `kimi-code` wrapper when the root version changes.** Bump `packages/kimi-code/pyproject.toml` `version` and its `kimi-cli==<version>` dependency to match the new root version.
6. **Sync the `kimi-code` wrapper when the root version changes.** Bump `packages/kimi-code/pyproject.toml` `version` to match the new root version. It is a legacy stub with no dependencies — do not add a `kimi-cli` pin back.

7. **Run `uv sync`** to refresh the lockfile.

8. **Update docs.** Follow the `gen-docs` skill to make sure docs reflect the release.

9. **Confirm with the user before opening the PR.** Summarize the staged changes and ask the user to explicitly confirm:
- **Version numbers** — every updated `pyproject.toml` (changed package + `packages/kimi-code` if the root moved) reflects the version agreed in step 3.
- **Dependency pins** — the root `pyproject.toml` pins (`kosong[contrib]==<version>`, `pykaos==<version>`) and `packages/kimi-code`'s `kimi-cli==<version>` match the bumped versions.
- **Dependency pins** — the root `pyproject.toml` pins (`kosong[contrib]==<version>`, `pykaos==<version>`) match the bumped versions.
- **Documentation** — CHANGELOG entries are added below `## Unreleased` (Unreleased still present and empty), `breaking-changes.md` is updated in both languages if applicable, and `gen-docs` left no inconsistencies.

Wait for explicit user approval before proceeding. If the user flags anything, fix it and re-confirm — do not push.
Expand Down
17 changes: 0 additions & 17 deletions .github/workflows/ci-kimi-cli.yml
Original file line number Diff line number Diff line change
Expand Up @@ -239,23 +239,6 @@ jobs:
--pyproject packages/kimi-code/pyproject.toml \
--expected-version "${{ steps.version.outputs.head_version }}"

- name: Check kimi-code dependency pin
if: steps.version.outputs.bump == 'true'
shell: python
run: |
import tomllib
from pathlib import Path

expected_version = "${{ steps.version.outputs.head_version }}"
data = tomllib.loads(Path("packages/kimi-code/pyproject.toml").read_text())
deps = data["project"]["dependencies"]
expected = f"kimi-cli=={expected_version}"
if expected not in deps:
raise SystemExit(
"kimi-code must depend on "
f"{expected}, got: {deps}"
)

nix-test:
strategy:
fail-fast: true
Expand Down
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,11 @@ Only write entries that are worth mentioning to users.

## Unreleased

**Highlights**: Kimi CLI is archived and no longer maintained, and this is the final release. Please migrate to [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code); see the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration)

- Build: Mark `kimi-cli` and all packages in this repository as archived — no further releases, bug fixes, or security updates are planned
- Build: Stop installing the legacy CLI from the `kimi-code` package on PyPI — running `kimi-code` now prints instructions for installing the new Kimi Code CLI and exits with status 1

## 1.50.0 (2026-09-02)

- Kosong: Stop sending an empty `anthropic-beta` header when no beta features are declared — adaptive thinking removes the interleaved-thinking beta, which previously left an empty header value that some backends reject
Expand Down
28 changes: 4 additions & 24 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,7 @@
# Contributing to Kimi Code CLI
# Contributing

Thank you for being interested in contributing to Kimi Code CLI!
This repository has been archived and no longer accepts issues or pull requests.

We welcome all kinds of contributions, including bug fixes, features, document improvements, typo fixes, etc. To maintain a high-quality codebase and user experience, we provide the following guidelines for contributions:
If you would like to contribute, please head over to [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code) and read its contributing guide ([English](https://github.com/MoonshotAI/kimi-code/blob/main/CONTRIBUTING.md) | [中文](https://github.com/MoonshotAI/kimi-code/blob/main/CONTRIBUTING.zh-CN.md)).

1. We only merge pull requests that align with our roadmap. For any pull request that introduces changes larger than 100 lines of code, we highly recommend discussing with us by [raising an issue](https://github.com/MoonshotAI/kimi-cli/issues) or in an existing issue before you start working on it. Otherwise your pull request may be closed or ignored without review.
2. We insist on high code quality. Please ensure your code is as good as, if not better than, the code written by frontier coding agents. Changes may be requested before your pull request can be merged.

## Prek hooks

We use [prek](https://github.com/j178/prek) to run formatting and checks via git hooks.

Recommended setup:
1. Run `make prepare` to sync dependencies and install the prek hooks.
2. Optionally run on all files before sending a PR: `prek run --all-files`.

Manual setup (if you do not want to use `make prepare`):
1. Install prek (pick one): `uv tool install prek`, `pipx install prek`, or `pip install prek`.
2. Install the hooks in this repo: `prek install`.

After installation, the hooks run on every commit. The repo uses prek workspace mode, so only the
projects with changed files run their hooks. You can skip them for an intermediate commit with
`git commit --no-verify`, or run them manually with `prek run --all-files`.

The hooks execute the relevant `make format-*` and `make check-*` targets, so ensure dependencies
are installed (`make prepare` or `uv sync`).
Thank you to everyone who contributed to Kimi CLI.
63 changes: 54 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,58 @@
# Kimi CLI
# Kimi CLI (Archived)

[![Commit Activity](https://img.shields.io/github/commit-activity/w/MoonshotAI/kimi-cli)](https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity)
[![Checks](https://img.shields.io/github/check-runs/MoonshotAI/kimi-cli/main)](https://github.com/MoonshotAI/kimi-cli/actions)
[![Version](https://img.shields.io/pypi/v/kimi-cli)](https://pypi.org/project/kimi-cli/)
[![Downloads](https://img.shields.io/pypi/dw/kimi-cli)](https://pypistats.org/packages/kimi-cli)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/MoonshotAI/kimi-cli)
[Kimi Code CLI](https://github.com/MoonshotAI/kimi-code) | [Migration Guide](https://moonshotai.github.io/kimi-code/en/guides/migration) | [迁移指南](https://moonshotai.github.io/kimi-code/zh/guides/migration) | [Legacy Docs](https://moonshotai.github.io/kimi-cli/en/)

[Kimi Code](https://www.kimi.com/code/) | [Documentation](https://moonshotai.github.io/kimi-cli/en/) | [文档](https://moonshotai.github.io/kimi-cli/zh/)
> [!CAUTION]
> **This project has been archived and is no longer maintained.** Kimi CLI (Python) has been replaced by **[Kimi Code CLI](https://github.com/MoonshotAI/kimi-code)**, the next-generation terminal AI agent from the same team.
>
> - This repository is read-only. There will be no further releases, bug fixes, or security updates.
> - Existing installations are no longer supported and will stop working. Please migrate as soon as possible.
> - Please file issues, feature requests, and security reports for Kimi Code CLI at [MoonshotAI/kimi-code](https://github.com/MoonshotAI/kimi-code).
>
> 本项目已归档,不再维护。Python 版 Kimi CLI 已由 [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code) 取代,旧版将无法继续使用,请参考 [迁移指南](https://moonshotai.github.io/kimi-code/zh/guides/migration) 尽快升级。

> [!IMPORTANT]
> **Kimi CLI is evolving into [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code)** — the next-generation terminal AI agent from the same team. Installing Kimi Code CLI automatically migrates your configuration and sessions. This project will be gradually wound down; the docs and existing installations remain available.
## Migrate to Kimi Code CLI

1. Install Kimi Code CLI:

```sh
# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```

```powershell
# Windows (PowerShell)
irm https://code.kimi.com/kimi-code/install.ps1 | iex
```

Also available via Homebrew (`brew install kimi-code`) and npm (`npm install -g @moonshot-ai/kimi-code`).

2. Open a new terminal and run `kimi`. On first launch, it detects your Kimi CLI data in `~/.kimi/` and offers to migrate your config, MCP servers, input history, and sessions. You can also run `kimi migrate` at any time. Your original data in `~/.kimi/` is never modified or deleted.
3. Run `/login` again, and re-authorize your MCP servers. Login credentials, MCP authorizations, and Kimi CLI plugins are not migrated.
4. Uninstall the legacy CLI after migrating, e.g. `uv tool uninstall kimi-cli` or `brew uninstall kimi-cli`.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Uninstall the uv tool before replacing its kimi shim

For users who originally installed kimi-cli with uv, this ordering removes the newly installed CLI: both uv and the migration installer manage ~/.local/bin/kimi (src/kimi_cli/ui/shell/update.py creates the replacement symlink there), while uv tool uninstall kimi-cli later deletes every executable recorded in the old tool receipt without checking whether the symlink target was replaced. I confirmed with uv 0.7.22 that uninstall logs Removing executable: .../kimi and deletes a substituted symlink. Move the legacy uninstall before installing Kimi Code CLI, or explicitly reinstall/relink the new CLI afterward; the same ordering should be corrected in the getting-started pages.

Useful? React with 👍 / 👎.


See the full [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration) for details.

## Packages in this repository

All packages below are archived together with this repository. Published versions remain on PyPI, but will not receive any further updates.

| Package | Status |
|---|---|
| [`kimi-cli`](https://pypi.org/project/kimi-cli/) | Archived. Replaced by Kimi Code CLI |
| [`kimi-code`](https://pypi.org/project/kimi-code/) on PyPI | Archived. A legacy alias of `kimi-cli`, **not** the new Kimi Code CLI |
| [`kosong`](https://pypi.org/project/kosong/) | Archived |
| [`pykaos`](https://pypi.org/project/pykaos/) | Archived |
| [`kimi-sdk`](https://pypi.org/project/kimi-sdk/) | Archived |

## License

The source code remains available under the [Apache License 2.0](LICENSE).

Thank you to everyone who used Kimi CLI, reported issues, and contributed code. Your feedback shaped Kimi Code CLI.

<details>
<summary>Original README (legacy, for reference only)</summary>

Kimi CLI is an AI agent that runs in the terminal, helping you complete software development tasks and terminal operations. It can read and edit code, execute shell commands, search and fetch web pages, and autonomously plan and adjust actions during execution.

Expand Down Expand Up @@ -175,3 +218,5 @@ make help # show all make targets
```

Note: `make build` and `make build-bin` automatically run `make build-web` to embed the web UI.

</details>
7 changes: 3 additions & 4 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
# Security Policy

## Supported Versions

Currently, Kimi CLI only provides security support for the latest version.
This project has been archived and is no longer maintained. **No version of Kimi CLI (Python), kosong, pykaos, or kimi-sdk receives security updates.** We strongly recommend migrating to [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code). See the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration).

## Reporting a Vulnerability

Please report a vulnerability via the [MoonshotAI/kimi-cli - Security](https://github.com/MoonshotAI/kimi-cli/security) page, or open an [issue](https://github.com/MoonshotAI/kimi-cli/issues) if it can be published publicly.
- For vulnerabilities in Kimi Code CLI, please follow its [security policy](https://github.com/MoonshotAI/kimi-code/security/policy).
- Vulnerabilities that affect only this archived project will not be fixed. If you believe an issue also affects Kimi Code CLI or other Moonshot AI services, please report it privately through the channel above, or email code@moonshot.ai with "[security]" in the subject.
22 changes: 16 additions & 6 deletions docs/.vitepress/theme/EvolutionBanner.vue
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
import { useData } from 'vitepress'
import { computed, onMounted, onUnmounted, ref, watch } from 'vue'

const STORAGE_KEY = 'kimi-cli-evolution-banner-dismissed'
const TARGET_URL = 'https://github.com/MoonshotAI/kimi-code'
// Renamed when the project was archived so that previously dismissed banners show again.
const STORAGE_KEY = 'kimi-cli-archived-banner-dismissed'
Comment thread
RealKai42 marked this conversation as resolved.
const HTML_CLASS = 'has-evolution-banner'

const { lang } = useData()
Expand All @@ -17,7 +17,12 @@ function applyHtmlClass(active: boolean) {
}

onMounted(() => {
dismissed.value = localStorage.getItem(STORAGE_KEY) === '1'
try {
dismissed.value = localStorage.getItem(STORAGE_KEY) === '1'
} catch {
// Storage blocked by browser settings: keep showing the archive notice.
dismissed.value = false
}
hydrated.value = true
})

Expand All @@ -41,8 +46,13 @@ function dismiss() {
const isZh = computed(() => lang.value.startsWith('zh'))
const message = computed(() =>
isZh.value
? 'Kimi Code CLI 重构升级版已发布,迭代更快 了解更多➡️'
: 'Kimi Code CLI rebuilt & upgraded version released — faster iterations. Learn more ➡️',
? 'Kimi CLI 已归档,旧版将无法继续使用,请迁移至 Kimi Code CLI ➡️'
: 'Kimi CLI is archived and will stop working. Please migrate to Kimi Code CLI ➡️',
)
const targetUrl = computed(() =>
isZh.value
? 'https://moonshotai.github.io/kimi-code/zh/guides/migration'
: 'https://moonshotai.github.io/kimi-code/en/guides/migration',
)
const closeLabel = computed(() => (isZh.value ? '关闭' : 'Dismiss'))
</script>
Expand All @@ -51,7 +61,7 @@ const closeLabel = computed(() => (isZh.value ? '关闭' : 'Dismiss'))
<div v-if="hydrated && !dismissed" class="evolution-banner">
<a
class="evolution-banner__link"
:href="TARGET_URL"
:href="targetUrl"
target="_blank"
rel="noopener"
>
Expand Down
44 changes: 10 additions & 34 deletions docs/en/guides/getting-started.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Getting Started

::: danger Warning
**This project is archived.** Kimi CLI is no longer maintained and will stop working. It receives no further updates or security fixes. Please install [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code) instead; see the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration).
:::

## What is Kimi Code CLI

Kimi Code CLI is an AI agent that runs in the terminal, helping you complete software development tasks and terminal operations. It can read and edit code, execute shell commands, search and fetch web pages, and autonomously plan and adjust actions during execution.
Expand All @@ -24,51 +28,23 @@ If you encounter issues or have suggestions, please provide feedback on [GitHub

## Installation

::: tip
Kimi Code CLI is evolving into [Kimi Code](https://github.com/MoonshotAI/kimi-code). Installing Kimi Code **automatically migrates** your configuration and sessions. New users are encouraged to install Kimi Code directly; the instructions below still work, and existing users don't need to migrate immediately.
:::

Run the installation script to complete the installation. The script will first install [uv](https://docs.astral.sh/uv/) (a Python package manager), then install Kimi Code CLI via uv:
Kimi CLI is archived and should no longer be installed. Install [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code) instead:

```sh
# Linux / macOS
curl -LsSf https://code.kimi.com/install.sh | bash
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```

```powershell
# Windows (PowerShell)
Invoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression
```

Verify the installation:

```sh
kimi --version
```

::: tip
Due to macOS security checks, the first run of the `kimi` command may take longer. You can add your terminal application in "System Settings → Privacy & Security → Developer Tools" to speed up subsequent launches.
:::

If you already have uv installed, you can also run:

```sh
uv tool install --python 3.13 kimi-cli
irm https://code.kimi.com/kimi-code/install.ps1 | iex
```

::: tip
Kimi Code CLI supports Python 3.12–3.14, with Python 3.13 recommended.
:::

## Upgrade and uninstall

Upgrade to the latest version:
If you have used Kimi CLI before, Kimi Code CLI offers to migrate your config, MCP servers, and sessions on first launch, or you can run `kimi migrate` at any time. See the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration) for details.

```sh
uv tool upgrade kimi-cli --no-cache
```
## Uninstall

Uninstall Kimi Code CLI:
After migrating to Kimi Code CLI, uninstall Kimi CLI:

```sh
uv tool uninstall kimi-cli
Expand Down
6 changes: 3 additions & 3 deletions docs/en/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ hero:
text: Go to Kimi Code (Recommended)
link: https://github.com/MoonshotAI/kimi-code
- theme: alt
text: Stay with Kimi Code CLI
link: /en/guides/getting-started
text: Migration Guide
link: https://moonshotai.github.io/kimi-code/en/guides/migration
---

> **Kimi Code CLI is evolving into [Kimi Code](https://github.com/MoonshotAI/kimi-code)** — the next-generation terminal AI agent from the same team, with a smoother experience. Installing Kimi Code **automatically migrates** your configuration and sessions. This project will be gradually wound down; the docs and existing installations remain available.
> **Kimi CLI has been archived and is no longer maintained.** It has been replaced by [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code), the next-generation terminal AI agent from the same team. Existing installations will stop working, so please migrate as soon as possible. Your config and sessions can be migrated automatically; see the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration).
7 changes: 7 additions & 0 deletions docs/en/release-notes/breaking-changes.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ This page documents breaking changes in Kimi Code CLI releases and provides migr

## Unreleased

### The `kimi-code` package on PyPI no longer installs Kimi CLI

The `kimi-code` package on PyPI used to be an alias of Kimi CLI. It is now a stub that only prints instructions for installing the new Kimi Code CLI and exits with status 1. Kimi CLI itself is archived and no longer maintained.

- **Affected**: Users who installed Kimi CLI through the `kimi-code` package on PyPI (for example `uv tool install kimi-code`)
- **Migration**: Install Kimi Code CLI with `curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash` (Windows: `irm https://code.kimi.com/kimi-code/install.ps1 | iex`), then run `kimi migrate` to migrate your config and sessions. See the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration)

## 1.49.0

### Kimi no longer sends legacy `reasoning_effort` automatically
Expand Down
7 changes: 7 additions & 0 deletions docs/en/release-notes/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ This page documents the changes in each Kimi Code CLI release.

## Unreleased

**Highlights**: Kimi CLI is archived and no longer maintained, and this is the final release. Please migrate to [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code); see the [migration guide](https://moonshotai.github.io/kimi-code/en/guides/migration)

- Build: Mark `kimi-cli` and all packages in this repository as archived — no further releases, bug fixes, or security updates are planned
- Build: Stop installing the legacy CLI from the `kimi-code` package on PyPI — running `kimi-code` now prints instructions for installing the new Kimi Code CLI and exits with status 1

## 1.50.0 (2026-09-02)

- Kosong: Stop sending an empty `anthropic-beta` header when no beta features are declared — adaptive thinking removes the interleaved-thinking beta, which previously left an empty header value that some backends reject

## 1.49.0 (2026-07-16)
Expand Down
Loading
Loading