Kimi Sidekick

中文说明

Kimi Sidekick is an MIT-licensed repository for the Windows desktop shell around Kimi Web.
The main deliverable is apps/kimi-shell, a Tauri v2 + React desktop application that
combines startup handoff, install and upgrade flows, a multi-tab control center, IM Bridge
operations, diagnostics, and Windows packaging into one workspace-oriented app.

Repository Layout

• apps/kimi-shell: desktop app source, packaging config, screenshots, and release notes
• tasks: local task tracking, investigation notes, and engineering review materials

Key Highlights

• Persistent desktop shell for Kimi Code Web and Kimi Chat, with Workspace Grid presets, resizable saved layouts, embedded external Webview panes, WebviewWindow fallback, and view switching
• Windows Explorer context-menu launch for folders, single files, and multi-file selections, creating independent sessions without restarting a running backend
• Compact assistant settings with app self-update plus focused setup bars for install/upgrade, Explorer context menu, Provider API, default work directory, and IM channels
• Built-in npm-based Kimi Code install and upgrade center with PowerShell preflight checks and dependency status
• Unified Control Center for overview, quick setup, runtime diagnostics, and IM Bridge operations
• IM Bridge workspace with Feishu-focused controls for channel status, work directory, approvals, and session switching
• Windows-native tray behavior, close-to-tray flow, diagnostics access, and NSIS/MSI installer outputs
• Signed, user-confirmed desktop self-updates from GitHub Releases

What The App Does

• Launches and monitors the local kimi-code server runtime
• Shows a prefill/startup surface before handing off to the main workspace
• Keeps Kimi Code Web, Kimi Chat, and additional grid panes mounted inside one shell, reducing refresh-heavy workflow switching
• Handles workspace bootstrap from normal launch, plus Windows Explorer open requests for folders, single files, and multi-file selections
• Hands off folders directly as the active work directory, and copies selected files into a fresh workspace before launching the shell
• Provides onboarding, install and upgrade actions, diagnostics, logs, and runtime operations from one control surface
• Exposes IM Bridge controls for Feishu channel management, session rotation, approvals, and working-directory mapping
• Produces Windows installer artifacts in NSIS and MSI formats

App Preview

Main workspace with the persistent Code/Chat shell and desktop-level navigation:

Assistant settings groups first-run tasks and common environment fixes into focused expandable bars:

Install and Upgrade keeps PowerShell preflight, dependency readiness, and upgrade entry points in one place:

Control Center brings overview, quick setup, diagnostics, and operational entry points into one tabbed workspace:

IM Bridge provides channel controls, current binding/session switching, and working-directory management for bridge-driven workflows:

Local Development

Requirements:

• Node.js 22+
• pnpm 10.34.4
• Rust stable
• WebView2 Runtime on Windows

Common commands:

pnpm -C apps/kimi-shell install
pnpm -C apps/kimi-shell tauri dev
pnpm -C apps/kimi-shell build
pnpm -C apps/kimi-shell tauri build

Release Outputs

Production installer artifacts are generated under:

• apps/kimi-shell/src-tauri/target/release/bundle/nsis
• apps/kimi-shell/src-tauri/target/release/bundle/msi

Release notes are stored under:

• apps/kimi-shell/docs

Pushing a vX.Y.Z tag matching apps/kimi-shell/package.json runs the Windows release workflow. It publishes NSIS/MSI installers, updater signatures, and latest.json; the two Tauri signing Secrets must be configured before tagging.

License

This repository is released under the MIT License. See LICENSE.