feat: add web ui for kimi cli (#775)

Author: RealKai42

.github/workflows/ci-kimi-cli.yml

@@ -78,6 +78,14 @@ jobs:
           PYTHONUTF8: "1"
         run: make test-kimi-cli
 
+      - name: Set up Node.js (web build)
+        if: matrix.python-version == '3.14'
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: web/package-lock.json
+
       - name: Build standalone binary
         if: matrix.python-version == '3.14'
         env:

.github/workflows/release-kimi-cli.yml

@@ -57,6 +57,9 @@ jobs:
           - runner: windows-2022
             target: x86_64-pc-windows-msvc
     runs-on: ${{ matrix.runner }}
+    env:
+      KIMI_WEB_STRICT_VERSION: "1"
+      KIMI_WEB_EXPECT_VERSION: ${{ github.ref_name }}
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -76,6 +79,13 @@ jobs:
         with:
           version: "0.8.5"
 
+      - name: Set up Node.js (web build)
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: web/package-lock.json
+
       - name: Prepare building environment
         run: make prepare-build
 
@@ -457,6 +467,9 @@ jobs:
     name: Publish Python package
     needs: validate
     runs-on: ubuntu-latest
+    env:
+      KIMI_WEB_STRICT_VERSION: "1"
+      KIMI_WEB_EXPECT_VERSION: ${{ github.ref_name }}
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -472,6 +485,13 @@ jobs:
         with:
           version: "0.8.5"
 
+      - name: Set up Node.js (web build)
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: web/package-lock.json
+
       - name: Build distributions
         run: make build-kimi-cli
 

.gitignore

@@ -30,3 +30,8 @@ result-*
 
 # macOS files
 .DS_Store
+
+
+node_modules/
+static/
+.memo/

CHANGELOG.md

@@ -11,6 +11,11 @@ Only write entries that are worth mentioning to users.
 
 ## Unreleased
 
+- Web: Add new Web UI for browser-based interaction
+- CLI: Add `kimi web` subcommand to launch the Web UI server
+- Build: Add Web UI build process integrated into Makefile
+- Core: Add internal web worker command for session management
+
 ## 1.3 (2026-01-28)
 
 - Auth: Fix authentication issue during agent turns

Makefile

@@ -22,8 +22,8 @@ prepare-build: download-deps ## Sync dependencies for releases without workspace
 	@echo "==> Syncing dependencies for release builds (no sources)"
 	@uv sync --all-extras --all-packages --no-sources
 
-.PHONY: format format-kimi-cli format-kosong format-pykaos format-kimi-sdk
-format: format-kimi-cli format-kosong format-pykaos format-kimi-sdk ## Auto-format all workspace packages with ruff.
+.PHONY: format format-kimi-cli format-kosong format-pykaos format-kimi-sdk format-web
+format: format-kimi-cli format-kosong format-pykaos format-kimi-sdk format-web ## Auto-format all workspace packages.
 format-kimi-cli: ## Auto-format Kimi Code CLI sources with ruff.
 	@echo "==> Formatting Kimi Code CLI sources"
 	@uv run ruff check --fix
@@ -40,6 +40,14 @@ format-kimi-sdk: ## Auto-format kimi-sdk sources with ruff.
 	@echo "==> Formatting kimi-sdk sources"
 	@uv run --project sdks/kimi-sdk --directory sdks/kimi-sdk ruff check --fix
 	@uv run --project sdks/kimi-sdk --directory sdks/kimi-sdk ruff format
+format-web: ## Auto-format web sources with npm run format.
+	@echo "==> Formatting web sources"
+	@if command -v npm >/dev/null 2>&1; then \
+		npm --prefix web run format; \
+	else \
+		echo "npm not found. Install Node.js (npm) to run web formatting."; \
+		exit 1; \
+	fi
 
 .PHONY: check check-kimi-cli check-kosong check-pykaos check-kimi-sdk
 check: check-kimi-cli check-kosong check-pykaos check-kimi-sdk ## Run linting and type checks for all packages.
@@ -86,8 +94,8 @@ test-kimi-sdk: ## Run kimi-sdk tests.
 	@uv run --project sdks/kimi-sdk --directory sdks/kimi-sdk pytest tests -vv
 
 .PHONY: build build-kimi-cli build-kosong build-pykaos build-kimi-sdk build-bin build-bin-onedir
-build: build-kimi-cli build-kosong build-pykaos build-kimi-sdk ## Build Python packages for release.
-build-kimi-cli: ## Build the kimi-cli and kimi-code sdists and wheels.
+build: build-web build-kimi-cli build-kosong build-pykaos build-kimi-sdk ## Build Python packages for release.
+build-kimi-cli: build-web ## Build the kimi-cli and kimi-code sdists and wheels.
 	@echo "==> Building kimi-cli distributions"
 	@uv build --package kimi-cli --no-sources --out-dir dist
 	@echo "==> Building kimi-code distributions"
@@ -101,12 +109,15 @@ build-pykaos: ## Build the pykaos sdist and wheel.
 build-kimi-sdk: ## Build the kimi-sdk sdist and wheel.
 	@echo "==> Building kimi-sdk distributions"
 	@uv build --package kimi-sdk --no-sources --out-dir dist/kimi-sdk
-build-bin: ## Build the standalone executable with PyInstaller (one-file mode).
+build-web: ## Build web UI and sync into kimi-cli package.
+	@echo "==> Building web UI"
+	@python scripts/build_web.py
+build-bin: build-web ## Build the standalone executable with PyInstaller (one-file mode).
 	@echo "==> Building PyInstaller binary (one-file)"
 	@uv run pyinstaller kimi.spec
 	@mkdir -p dist/onefile
 	@if [ -f dist/kimi.exe ]; then mv dist/kimi.exe dist/onefile/; elif [ -f dist/kimi ]; then mv dist/kimi dist/onefile/; fi
-build-bin-onedir: ## Build the standalone executable with PyInstaller (one-dir mode).
+build-bin-onedir: build-web ## Build the standalone executable with PyInstaller (one-dir mode).
 	@echo "==> Building PyInstaller binary (one-dir)"
 	@rm -rf dist/onedir dist/kimi
 	@uv run pyinstaller kimi.spec

README.md

@@ -158,11 +158,14 @@ make test  # run tests
 make test-kimi-cli  # run Kimi Code CLI tests only
 make test-kosong  # run kosong tests only
 make test-pykaos  # run pykaos tests only
+make build-web  # build the web UI and sync it into the package (requires Node.js/npm)
 make build  # build python packages
 make build-bin  # build standalone binary
 make help  # show all make targets
 ```
 
+Note: `make build` and `make build-bin` automatically run `make build-web` to embed the web UI.
+
 ## Contributing
 
 We welcome contributions to Kimi Code CLI! Please refer to [CONTRIBUTING.md](./CONTRIBUTING.md) for more information.

docs/.vitepress/config.ts

@@ -77,6 +77,7 @@ export default withMermaid(defineConfig({
                 { text: 'kimi acp 子命令', link: '/zh/reference/kimi-acp' },
                 { text: 'kimi mcp 子命令', link: '/zh/reference/kimi-mcp' },
                 { text: 'kimi term 子命令', link: '/zh/reference/kimi-term' },
+                { text: 'kimi web 子命令', link: '/zh/reference/kimi-web' },
                 { text: '斜杠命令', link: '/zh/reference/slash-commands' },
                 { text: '键盘快捷键', link: '/zh/reference/keyboard' },
               ],
@@ -156,6 +157,7 @@ export default withMermaid(defineConfig({
                 { text: 'kimi acp Subcommand', link: '/en/reference/kimi-acp' },
                 { text: 'kimi mcp Subcommand', link: '/en/reference/kimi-mcp' },
                 { text: 'kimi term Subcommand', link: '/en/reference/kimi-term' },
+                { text: 'kimi web Subcommand', link: '/en/reference/kimi-web' },
                 { text: 'Slash Commands', link: '/en/reference/slash-commands' },
                 { text: 'Keyboard Shortcuts', link: '/en/reference/keyboard' },
               ],

docs/en/configuration/config-files.md

@@ -160,4 +160,4 @@ When configuring the Kimi Code platform using the `/setup` command, search and f
 
 If `~/.kimi/config.toml` doesn't exist but `~/.kimi/config.json` exists, Kimi Code CLI will automatically migrate the JSON configuration to TOML format and backup the original file as `config.json.bak`.
 
-Configuration files specified via `--config-file` are parsed based on file extension. Configuration content passed via `--config` is first attempted as JSON, then falls back to TOML if that fails.
+`--config-file` specified configuration files are parsed based on file extension. `--config` passed configuration content is first attempted as JSON, then falls back to TOML if that fails.

docs/en/configuration/data-locations.md

@@ -63,13 +63,13 @@ Session data is grouped by working directory and stored under `~/.kimi/sessions/
 
 ### `context.jsonl`
 
-Context history file, stores the session's message history in JSONL format. Each line is a message (user input, model response, tool calls, etc.).
+Context history file, stores the session's message history in JSON Lines (JSONL) format. Each line is a message (user input, model response, tool calls, etc.).
 
 Kimi Code CLI uses this file to restore session context when using `--continue` or `--session`.
 
 ### `wire.jsonl`
 
-Wire message log file, stores Wire events during the session in JSONL format. Used for session replay and extracting session titles.
+Wire message log file, stores Wire events during the session in JSON Lines (JSONL) format. Used for session replay and extracting session titles.
 
 ## Input history
 

docs/en/customization/wire-mode.md

@@ -73,7 +73,7 @@ interface JSONRPCError {
 Legacy clients can skip this request and send `prompt` directly.
 :::
 
-- **Direction**: Client → Agent
+- **Direction**: client → agent
 - **Type**: Request (requires response)
 
 Optional handshake request for negotiating protocol version, submitting external tool definitions, and retrieving the slash command list.
@@ -233,7 +233,7 @@ If no turn is in progress:
 
 ### `event`
 
-- **Direction**: Agent → Client
+- **Direction**: agent → client
 - **Type**: Notification (no response needed)
 
 Events emitted by the agent during a turn. No `id` field, client doesn't need to respond.
@@ -254,7 +254,7 @@ interface EventParams {
 
 ### `request`
 
-- **Direction**: Agent → Client
+- **Direction**: agent → client
 - **Type**: Request (requires response)
 
 Requests from the agent to the client, used for approval confirmation or external tool calls. The client must respond before the agent can continue execution.