# kimi-code | Moonshot AI | Knowledge Base | Instagit

Kimi Code CLI  —  The Starting Point for Next-Gen Agents

GitHub Stars: 4.6k

Repository: https://github.com/MoonshotAI/kimi-code

---

## Articles

### [How to Migrate from the Legacy Node-SDK to the New Klient SDK Architecture](/MoonshotAI/kimi-code/how-to-migrate-from-the-legacy-node-sdk-to-the-new-klient-sdk-architecture)

Migrate from the legacy Node-SDK to the new Klient SDK architecture. Learn to replace RPC calls, initialize transport-agnostic, and adopt the v2 engine bootstrap pattern for seamless integration.

- Tags: migration-guide
- Published: 2026-08-16

### [How Kimi Code's Wire Vocabulary System Handles Model Definitions and Cross‑Reducers](/MoonshotAI/kimi-code/how-does-the-wire-vocabulary-system-handle-model-definitions-and-cross-reducers)

Discover how Kimi Code's wire vocabulary system uses defineModel and defineReducer for type-safe state containers and automatic updates. Learn about its dependency graph and cycle detection.

- Tags: internals
- Published: 2026-08-16

### [How Kimi-Code's Swarm Feature Enables Parallel Subagent Execution](/MoonshotAI/kimi-code/how-does-the-swarm-feature-enable-parallel-subagent-execution)

Discover how Kimi-Code's swarm feature enables parallel subagent execution with its metadata-driven coordination and concurrent task dispatching for efficient workflows.

- Tags: deep-dive
- Published: 2026-08-16

### [How to Debug Session Issues Using the Kimi Code Server Debug Endpoints](/MoonshotAI/kimi-code/how-to-debug-session-issues-using-the-kap-server-debug-endpoints)

Debug Kimi Code session issues effectively using kap-server debug endpoints. Inspect registries, invoke methods, and capture business state for faster problem resolution.

- Tags: how-to-guide
- Published: 2026-08-16

### [How Kosong's Provider Abstraction Layer Handles Multiple LLM Providers in Kimi Code](/MoonshotAI/kimi-code/how-does-the-koson-provider-abstraction-layer-handle-multiple-llm-providers)

Discover how Kosong's provider abstraction layer unifies multiple LLM backends via a single ChatProvider interface and provider-specific adapters, simplifying integration within Kimi Code.

- Tags: internals
- Published: 2026-08-16

### [Tree-Sitter-Bash Parser API: How to Use the MoonshotAI Parser Safely](/MoonshotAI/kimi-code/what-is-the-tree-sitter-bash-parser-api-and-how-to-use-it-safely)

Explore the Tree Sitter Bash parser API from MoonshotAI. Learn how to safely parse Bash code in TypeScript with the @moonshot-ai/tree-sitter-bash package. Discover best practices for secure usage.

- Tags: how-to-guide
- Published: 2026-08-16

### [How the MCP OAuth Flow Works for Authenticating External Servers in Kimi Code](/MoonshotAI/kimi-code/how-does-the-mcp-oauth-flow-work-for-authenticating-external-servers)

Understand the MCP OAuth flow in Kimi Code. Learn how it securely authenticates external servers using temporary localhost servers and persistent disk storage for efficient token management.

- Tags: deep-dive
- Published: 2026-08-16

### [How to Configure the Kimi-Code CLI Using Config Files and Environment Variables](/MoonshotAI/kimi-code/how-to-configure-the-kimi-code-cli-using-config-files-and-environment-variables)

Learn to configure the Kimi-Code CLI easily with config files or environment variables. Customize your settings for seamless integration with MoonshotAI.

- Tags: how-to-guide
- Published: 2026-08-16

### [How the Kimi-Code Telemetry Event System Works: Architecture, Client API, and Naming Conventions](/MoonshotAI/kimi-code/how-does-the-telemetry-event-system-work-and-what-naming-conventions-must-be-followed)

Explore the kimi-code telemetry event system. Learn about its compile-time registry, TypeScript naming conventions, singleton client, and pluggable sinks for efficient event delivery.

- Tags: internals
- Published: 2026-08-16

### [How to Create Custom Features Using the `Feature` Base Class in agent-core-v2](/MoonshotAI/kimi-code/how-to-create-custom-features-using-the-feature-base-class-in-agent-core-v2)

Learn to build custom features in agent-core-v2 by extending the Feature base class. Implement setup() for automatic discovery and management by FeatureManagerService.

- Tags: how-to-guide
- Published: 2026-08-16

### [How MiniDB Handles Snapshot and WAL Persistence in Kimi Code's Embedded JSON Document Store](/MoonshotAI/kimi-code/how-does-the-minimidb-embedded-json-document-store-handle-snapshot-and-wal-persistence)

Discover how MiniDB ensures data durability and fast recovery in Kimi Code's embedded JSON store using WAL and snapshot persistence. Learn about its efficient design.

- Tags: internals
- Published: 2026-08-16

### [Agent-Core v1 vs v2 Architecture in Kimi Code: A Complete Technical Comparison](/MoonshotAI/kimi-code/what-is-the-difference-between-agent-core-v1-and-agent-core-v2-architecture)

Compare Kimi Code's agent-core-v1 and agent-core-v2 architectures. Discover agent-core-v2s scoped DI engine and four lifecycle layers for production servers.

- Tags: deep-dive
- Published: 2026-08-16

### [How the Checkpointed Model System Enables Conversation Undo in Kimi-Code](/MoonshotAI/kimi-code/how-does-the-checkpointed-model-system-support-conversation-undo-functionality)

Discover how the checkpointed model system enables conversation undo by using write-ahead logs, immutable snapshots, and idempotent delete operations to manage transcript history effectively.

- Tags: internals
- Published: 2026-08-16

### [How to Write Tests for DI/Scope Components Using the InstantiationService Harness](/MoonshotAI/kimi-code/how-to-write-tests-for-di-scope-components-using-the-instantiationservice-harness)

Learn to write tests for DI/Scope components using the InstantiationService harness. Discover test helpers like stub mock and spy for effective component testing in your projects.

- Tags: how-to-guide
- Published: 2026-08-16

### [How to Enable Kimi Code Experimental Feature Flags: A Complete Guide](/MoonshotAI/kimi-code/what-are-the-experimental-feature-flags-and-how-to-enable-disable-them)

Learn how to enable Kimi Code experimental feature flags. Discover how these boolean toggles control features via environment variables and config files for MoonshotAI kimi-code.

- Tags: how-to-guide
- Published: 2026-08-16

### [How to Implement Custom Agent Profiles in Kimi Code Using Contribution, Registry, and Catalog Extension Points](/MoonshotAI/kimi-code/how-to-implement-custom-agent-profiles-using-the-contribution-registry-catalog-extension-points)

Learn to implement custom agent profiles in Kimi Code. Register your ProfileData using CatalogService and let IAgentProfileService bind it for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-16

### [What Is the Roadmap for Kimi Code? 9 Strategic Themes Driving Moonshot AI's Coding Assistant](/MoonshotAI/kimi-code/what-is-the-roadmap-for-kimi-code)

Discover Kimi Code's roadmap driving moonshot AI. Explore v2 agent engine, expanded SDKs, improved storage, and streamlined deployment for a unified full-stack TypeScript monorepo.

- Tags: roadmap
- Published: 2026-08-15

### [Does Kimi Code Have a CLI? Yes, and It's the Primary Interface](/MoonshotAI/kimi-code/does-kimi-code-have-a-cli)

Discover if Kimi Code has a CLI. Learn how the kimi CLI is the primary interface for interactive sessions, web UI, and IDE integration, unlocking full functionality.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Kimi Code Provides Rich Code Intelligence: Static Parsing, Autocomplete, and LLM-Driven Assistance](/MoonshotAI/kimi-code/what-kind-of-code-intelligence-does-kimi-code-offer)

Discover Kimi Code's advanced code intelligence featuring static parsing, smart autocomplete, and LLM-driven semantic assistance. Enhance your coding workflow today.

- Tags: deep-dive
- Published: 2026-08-15

### [How Kimi Code Performs Code Reviews: A Deep Dive into the Plan-Review Workflow](/MoonshotAI/kimi-code/how-does-kimi-code-perform-code-reviews)

Discover how Kimi Code executes code reviews using a unique plan-review workflow. Learn about its coordinated subsystems for generation, decision, and persistence.

- Tags: deep-dive
- Published: 2026-08-15

### [How to Contribute to Kimi Code: A Complete Guide for Open-Source Contributors](/MoonshotAI/kimi-code/how-to-contribute-to-kimi-code)

Learn how to contribute to Kimi Code, an open-source project. This guide covers prerequisites like Node.js and pnpm, plus understanding its TypeScript monorepo structure for successful contributions.

- Tags: how-to-guide
- Published: 2026-08-15

### [Where to Find Kimi Code Documentation: Complete Guide to Official Resources](/MoonshotAI/kimi-code/where-can-i-find-the-kimi-code-documentation)

Find Kimi Code documentation easily. Access official resources in the MoonshotAI kimi-code repository docs directory or explore the published static site for a complete guide.

- Tags: getting-started
- Published: 2026-08-15

### [How to Integrate Kimi Code Into Your Project: SDK, Daemon, and ACP Setup Guide](/MoonshotAI/kimi-code/how-to-integrate-kimi-code-into-my-project)

Integrate Kimi Code into your JavaScript/TypeScript project using the SDK, daemon, or ACP client. Get programmatical control, server-side automation, and IDE connectivity with this comprehensive setup guide.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Programming Languages Does Kimi Code Support? A Complete Guide to Language-Agnostic AI Coding](/MoonshotAI/kimi-code/what-programming-languages-does-kimi-code-support)

Discover the extensive programming languages Kimi Code supports. Learn how its language-agnostic AI coding leverages LLM training for virtually any language, boosting your development.

- Tags: how-to-guide
- Published: 2026-08-15

### [Kimi Code Features Explained: A Complete Guide to Using the AI Coding Agent](/MoonshotAI/kimi-code/what-are-the-features-of-kimi-code)

Explore Kimi Code features: a fast AI coding agent with a terminal UI, local web server, sub-agents, and plugins. Get this Node.js free tool for efficient coding.

- Tags: deep-dive
- Published: 2026-08-15

### [How to Use Kimi Code: Complete Setup and Workflow Guide for the AI Terminal Coding Assistant](/MoonshotAI/kimi-code/how-to-use-kimi-code)

Learn how to use Kimi Code, an AI terminal coding assistant. Get the complete setup and workflow guide for efficient AI-powered coding sessions.

- Tags: how-to-guide
- Published: 2026-08-15

### [What is Kimi Code? A Deep Dive into the Terminal AI Coding Agent Architecture](/MoonshotAI/kimi-code/what-is-kimi-code)

Discover Kimi Code, the advanced terminal AI coding agent. Read edit files execute commands search the filesystem and make autonomous decisions. Learn more about its architecture and SDK.

- Tags: deep-dive
- Published: 2026-08-15

### [How to Build the @moonshot-ai/acp-adapter Package in the kimi-code Monorepo](/MoonshotAI/kimi-code/how-to-build-the-acp-adapter-package)

Learn how to build the acp-adapter package within the kimi-code monorepo. Follow simple commands to compile and prepare your package for use.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Dependencies Does the Kimi Code Agent-Core Package Have? A Complete Breakdown](/MoonshotAI/kimi-code/what-dependencies-does-the-agent-core-package-have)

Discover the complete list of runtime dependencies for the Kimi Code agent-core package. Understand its dependencies including image processing, HTTP clients, and utilities.

- Tags: api-reference
- Published: 2026-08-14

### [MoonshotAI Node SDK Examples: 7 Practical Patterns for Kimi-Code Automation](/MoonshotAI/kimi-code/are-there-any-examples-for-using-the-node-sdk)

Explore 7 practical MoonshotAI Node SDK examples to automate Kimi-Code. Harness SDK features for seamless integration and control. Get started with node-sdk today.

- Tags: examples
- Published: 2026-08-14

### [How to Contribute to the @moonshot-ai/tree-sitter-bash Package](/MoonshotAI/kimi-code/can-i-contribute-to-the-tree-sitter-bash-package)

Contribute to the @moonshot-ai/tree-sitter-bash package by opening issues running tests and submitting pull requests. Learn the Moonshot AI contribution workflow for the bash parser.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Is the Kimi-Inspect App? A Complete Guide to Debugging Kimi Code](/MoonshotAI/kimi-code/what-is-the-purpose-of-the-kimi-inspect-app)

Learn how to debug Kimi code with the kimi-inspect app. This guide explains its purpose as a web-based debugger UI for live visibility into workspaces, sessions, and more.

- Tags: deep-dive
- Published: 2026-08-14

### [How the Vis Web Client Works in MoonshotAI/kimi-code: Architecture and Implementation Guide](/MoonshotAI/kimi-code/how-does-the-vis-web-client-work-in-moonshotai-kimi-code)

Explore the Vis web client architecture in MoonshotAI/kimi-code. Learn how this React app visualizes AI agent sessions and execution graphs via HTTP/JSON API.

- Tags: architecture
- Published: 2026-08-14

### [How to Use the Vis Server Component in kimi-code: A Complete Setup Guide](/MoonshotAI/kimi-code/how-to-use-the-vis-server-component-in-kimi-code)

Learn to use the Vis server component in kimi-code with our complete setup guide. Visualize sessions, tasks, logs, and sub-agents easily via web UI or CLI. Get started today!

- Tags: how-to-guide
- Published: 2026-08-14

### [MoonshotAI/kimi-code Vis App Features: A Complete Guide to the Visual Debugging Tool](/MoonshotAI/kimi-code/what-are-the-features-of-the-vis-app-in-moonshotai-kimi-code)

Explore the MoonshotAI/kimi-code vis app features. Inspect session metadata, wire timelines, agent hierarchies, task execution, and performance metrics with this visual debugging tool.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Set Up the Kimi Code VS Code Extension](/MoonshotAI/kimi-code/how-to-set-up-the-vscode-extension-for-kimi-code)

Set up the Kimi Code VS Code extension easily. Install from the Marketplace, open a workspace, and sign in to your Kimi account for AI coding assistance.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Run the Kimi-Code Application: Installation, CLI Commands, and TUI Walkthrough](/MoonshotAI/kimi-code/how-to-run-the-kimi-code-application)

Learn to run the Kimi-Code application easily. Install via script, authenticate, and master TUI for interactive coding or CLI for quick tasks. Get started with Kimi-Code today.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Is the MiniDB Package in MoonshotAI/kimi-code? Embedded KV Database Explained](/MoonshotAI/kimi-code/what-is-the-minidb-package-used-for-in-moonshotai-kimi-code)

Discover the @moonshot-ai/minidb package, an embedded KV database for Kimi Code. Learn about its in-memory storage, WAL durability, snapshots, and full-text search capabilities.

- Tags: deep-dive
- Published: 2026-08-14

### [Where to Find the Tree-Sitter Bash Grammar in Kimi-Code](/MoonshotAI/kimi-code/where-can-i-find-the-tree-sitter-bash-grammar-for-kimi-code)

Locate the tree-sitter-bash grammar in Kimi-Code at packages/tree-sitter-bash/src/grammar.ts. Access the source code for the @moonshot-ai/tree-sitter-bash package and understand its structure.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Integrate with the `klient` Package from Kimi-Code: A Complete Guide](/MoonshotAI/kimi-code/how-to-integrate-with-the-klient-package-from-kimi-code)

Integrate with the @moonshot-ai/klient package from Kimi-Code using memory or IPC transport. Access typed facades for global, session, and agent operations. Connect to the Kimi-Code engine now.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Is the kap-server Package in MoonshotAI/kimi-code? Architecture and API Guide](/MoonshotAI/kimi-code/what-is-the-kap-server-package-in-moonshotai-kimi-code)

Explore the kap-server package in MoonshotAI/kimi-code. Discover its Fastify backend architecture, REST/WebSocket APIs, and how it powers Kimi Code's agent engine for sessions, transcripts, and search.

- Tags: architecture
- Published: 2026-08-14

### [How to Use the Transcript Package in Kimi-Code: A Complete Guide to Session State Management](/MoonshotAI/kimi-code/how-to-use-the-transcript-package-in-kimi-code)

Master Kimi-Code session state management with the transcript package. Learn to use TranscriptStore and AgentTranscript for immutable data layers and pure reducer updates. A complete guide.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Does the Telemetry Package Do in MoonshotAI/kimi-code?](/MoonshotAI/kimi-code/what-does-the-telemetry-package-do-in-moonshotai-kimi-code)

Discover the purpose of the telemetry package in MoonshotAI/kimi-code. Learn how it collects, buffers, and transmits structured events for improved editor performance and insights.

- Tags: internals
- Published: 2026-08-14

### [How to Set Up OAuth with Kimi-Code: A Complete Implementation Guide](/MoonshotAI/kimi-code/how-to-set-up-oauth-with-kimi-code)

Effortlessly set up OAuth with Kimi-Code using our comprehensive guide. Learn to configure the OAuth host and implement the device-code flow for seamless authentication. SDK manages tokens automatically.

- Tags: how-to-guide
- Published: 2026-08-14

### [What is the Kaos Package in Kimi-Code? A Deep Dive Into the Agent Operating System](/MoonshotAI/kimi-code/what-is-the-kaos-package-for-in-the-kimi-code-repository)

Discover the kaos package in Kimi-Code, a unified TypeScript runtime abstracting shells, remotes, and containers. Learn about this agent operating system.

- Tags: deep-dive
- Published: 2026-08-14

### [How to Use the Kimi Code Node-SDK from MoonshotAI: Complete Integration Guide](/MoonshotAI/kimi-code/how-to-use-the-node-sdk-from-moonshotai-kimi-code)

Integrate MoonshotAI Kimi Code into your Node.js apps using the official SDK. This guide covers seamless WebSocket/IPC RPC setup with KimiHarness and Session for powerful model interaction.

- Tags: how-to-guide
- Published: 2026-08-14

### [Differences Between agent-core and agent-core-v2 in Kimi-Code: Architecture, DI, and Scope Hierarchy](/MoonshotAI/kimi-code/differences-between-agent-core-and-agent-core-v2-in-kimi-code)

Explore the differences between agent-core and agent-core-v2 in Kimi-Code. Understand the shift to a four-tier lifecycle scope system and full dependency injection in v2, contrasting with v1's direct instantiation.

- Tags: deep-dive
- Published: 2026-08-14

### [What Is agent-core in MoonshotAI/kimi-code? The TypeScript Engine Powering Kimi AI](/MoonshotAI/kimi-code/what-is-agent-core-in-moonshotai-kimi-code)

Discover agent-core, the TypeScript engine in MoonshotAI/kimi-code. Learn how this library powers autonomous AI agents with its runtime engine, skill management, and more.

- Tags: deep-dive
- Published: 2026-08-14

### [How Does the acp-adapter Package Work in kimi-code: A Deep Dive into ACP Server Architecture](/MoonshotAI/kimi-code/how-does-the-acp-adapter-package-work-in-kimi-code)

Explore the acp-adapter package in kimi-code and understand how it bridges ACP capabilities like file systems and terminals as local services via dependency injection. Uncover the ACP server architecture.

- Tags: deep-dive
- Published: 2026-08-14

### [Purpose of the Kosong Package in MoonshotAI/Kimi-Code: LLM Abstraction Layer Explained](/MoonshotAI/kimi-code/what-is-the-purpose-of-the-kosong-package-in-moonshotai-kimi-code)

Discover the purpose of the Kosong package in MoonshotAI/Kimi-Code. This LLM abstraction layer unifies API interactions with OpenAI, Anthropic, Gemini, and Kimi for a seamless developer experience.

- Tags: internals
- Published: 2026-08-14

### [How to Install the pi-tui Package from Kimi-Code: A Complete Guide](/MoonshotAI/kimi-code/how-to-install-pi-tui-package-from-kimi-code)

Learn how to install the pi-tui package from Kimi-Code by cloning the monorepo and using pnpm. Get step-by-step instructions for this private package.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Access Workspace-Scoped Services from a Session in agent-core-v2](/MoonshotAI/kimi-code/how-can-i-access-workspace-scoped-services-from-a-session-in-agent-core-v2)

Learn how to access workspace scoped services from a session in agent-core-v2. Discover Kimi Code's dependency injection for seamless service resolution.

- Tags: how-to-guide
- Published: 2026-08-13

### [How Features Self-Register and Are Provided in agent-core-v2: A Complete Guide](/MoonshotAI/kimi-code/how-are-features-self-registered-and-provided-in-agent-core-v2)

Discover how agent-core-v2 features self-register automatically and are provisioned through a declarative three-phase lifecycle. Learn the complete guide here.

- Tags: how-to-guide
- Published: 2026-08-13

### [Session Seed Mechanism in agent-core-v2: How Kimi Code Initializes Session Scopes](/MoonshotAI/kimi-code/what-is-the-session-seed-mechanism-in-agent-core-v2)

Understand the session seed mechanism in agent-core-v2. Discover how Kimi Code initializes session scopes with context data and workspace adapters.

- Tags: internals
- Published: 2026-08-13

### [How the Cascade Engine Handles Service Updates in agent-core-v2](/MoonshotAI/kimi-code/how-does-the-cascade-engine-handle-service-updates-in-agent-core-v2)

Discover how the cascade engine in agent-core-v2 manages service updates. Learn about pending services, dependency teardown, and reactivation for seamless updates.

- Tags: internals
- Published: 2026-08-13

### [Ledger System in agent-core-v2: Ordered Lifecycle Management Explained](/MoonshotAI/kimi-code/what-is-the-ledger-system-in-agent-core-v2-responsible-for)

Discover the Ledger system in agent-core-v2. Learn how it provides ordered, rollback-capable registry for deterministic resource cleanup and manages disposers effects and child ledgers.

- Tags: internals
- Published: 2026-08-13

### [How Services Are Materialized and Disposed in agent-core-v2](/MoonshotAI/kimi-code/how-are-services-materialized-and-disposed-in-agent-core-v2)

Discover how agent-core-v2 materializes services on-demand and disposes them efficiently. Learn about the lightweight dependency-injection system for object creation and cleanup in Workspaces, Sessions, and Agents.

- Tags: internals
- Published: 2026-08-13

### [Workspace Tier Services in agent-core-v2: Complete Guide to Workspace-Scoped Dependencies](/MoonshotAI/kimi-code/what-services-are-managed-at-the-workspace-tier-in-agent-core-v2)

Discover Workspace tier services in agent-core-v2. Learn about 15+ singleton services like trust evaluation and tool policy enforcement managed per workspace for efficient dependency handling.

- Tags: deep-dive
- Published: 2026-08-13

### [How the DI Kernel Manages the Scope Tree in agent-core-v2](/MoonshotAI/kimi-code/how-does-the-di-kernel-manage-the-scope-tree-in-agent-core-v2)

Discover how the DI kernel manages the scope tree in agent-core-v2. Learn about hierarchical scope creation, topology enforcement, and automatic service materialization and disposal.

- Tags: internals
- Published: 2026-08-13

### [Where to Find the Scope Topology Declaration in agent-core-v2](/MoonshotAI/kimi-code/where-can-i-find-the-scope-topology-declaration-in-agent-core-v2)

Locate the agent-core-v2 scope topology declaration inkimi-code at packages/agent-core-v2/src/_base/di/scope.ts. Discover the declareScopeTopology function and its role in global scope initialization.

- Tags: architecture
- Published: 2026-08-13

### [Understanding the Agent Scope in agent-core-v2: Isolation and Lifecycle Management in MoonshotAI](/MoonshotAI/kimi-code/what-is-the-role-of-the-agent-scope-in-agent-core-v2)

Discover the Agent Scope in agent-core-v2. Learn how it isolates per-agent services, tools, and telemetry for LLM processes, ensuring secure and efficient operations within MoonshotAI.

- Tags: internals
- Published: 2026-08-13

### [How Session Scope Provides Isolation for Conversations in agent-core-v2](/MoonshotAI/kimi-code/how-does-the-session-scope-provide-isolation-for-conversations-in-agent-core-v2)

Discover how agent-core-v2 uses Session Scope to isolate conversations. Learn how child containers ensure separate service instances and state for each interaction in MoonshotAI/kimi-code.

- Tags: internals
- Published: 2026-08-13

### [Workspace Scope in agent-core-v2: Project-Level Isolation and Lifecycle Management](/MoonshotAI/kimi-code/what-is-the-purpose-of-the-workspace-scope-in-agent-core-v2)

Explore Workspace Scope in agent-core-v2 for project-level isolation and lifecycle management. Understand its role in the four-tier hierarchy for enhanced state management.

- Tags: deep-dive
- Published: 2026-08-13

### [How the App Scope Is Different from Other Scopes in agent-core-v2](/MoonshotAI/kimi-code/how-is-app-scope-different-from-other-scopes-in-agent-core-v2)

Understand how the App Scope differs from Workspace, Session, and Agent scopes in agent-core-v2. Learn about root-level dependency injection and lifecycle management for agent applications.

- Tags: deep-dive
- Published: 2026-08-13

### [Performance Benchmarks for Kimi-Code: MiniDb Throughput, Latency, and Concurrency Metrics](/MoonshotAI/kimi-code/what-are-the-performance-benchmarks-for-kimi-code)

Discover Kimi-Code MiniDb performance benchmarks: achieve 1832 ops/s write throughput with group commit, sub-0.3ms query latency, and scale linearly across clusters. Explore the metrics.

- Tags: performance
- Published: 2026-08-11

### [How to Configure Kimi-Code Settings: Environment Variables, Config Files, and CLI Commands](/MoonshotAI/kimi-code/how-to-configure-kimi-code-settings)

Configure Kimi-Code settings using environment variables, the config.json file, or CLI commands. Learn to manage models, credentials, and providers for effective development.

- Tags: how-to-guide
- Published: 2026-08-11

### [Future Roadmap for Kimi-Code: v2 Engine, Multi-Language SDKs, and Production Deployment](/MoonshotAI/kimi-code/what-is-the-future-roadmap-for-kimi-code)

Explore the Kimi-Code roadmap: v2 engine enhancements, unified web/CLI experience, Python/Go SDKs, and enterprise deployment with Docker and Helm charts.

- Tags: getting-started
- Published: 2026-08-11

### [How to Troubleshoot Kimi-Code Installation Issues: A Complete Diagnostic Guide](/MoonshotAI/kimi-code/how-to-troubleshoot-kimi-code-installation-issues)

Troubleshoot Kimi-Code installation issues by verifying Node.js and pnpm versions, running workspace validation, and fixing native binary permissions. Get your Kimi-Code setup right.

- Tags: how-to-guide
- Published: 2026-08-11

### [Kimi-Code Limitations: 8 Critical Constraints Developers Must Know](/MoonshotAI/kimi-code/what-are-the-limitations-of-kimi-code)

Discover Kimi-Code limitations including synthetic events, iframe access, session ownership, and PDF generation caps. Essential knowledge for developers using MoonshotAI kimi-code.

- Tags: deep-dive
- Published: 2026-08-11

### [How to Build Kimi-Code from Source: A Complete Guide to the TypeScript Monorepo](/MoonshotAI/kimi-code/how-to-build-kimi-code-from-source)

Build Kimi-Code from source with this guide. Learn to clone the repo, install dependencies using pnpm, and bundle the CLI to create your own Kimi-Code distribution.

- Tags: how-to-guide
- Published: 2026-08-11

### [How to Get Started with Kimi-Code Development: A Complete Setup Guide](/MoonshotAI/kimi-code/how-to-get-started-with-kimi-code-development)

Start Kimi-Code development with this guide. Set up Node.js, pnpm, and the monorepo, then launch the TUI or build custom skills with ease.

- Tags: getting-started
- Published: 2026-08-11

### [Kimi Code Main Features: A Complete Guide to the AI Coding Assistant](/MoonshotAI/kimi-code/what-are-the-main-features-of-kimi-code)

Explore the main features of Kimi Code, a powerful AI coding assistant. Discover its full-stack agent engine, fast TUI, and extensible plugin ecosystem in this comprehensive guide.

- Tags: getting-started
- Published: 2026-08-11

### [How to Run Kimi-Code Tests: A Complete Guide to Vitest Testing in the MoonshotAI Repository](/MoonshotAI/kimi-code/how-to-run-kimi-code-tests)

Learn how to run Kimi-Code tests with Vitest in the MoonshotAI repository. Execute the full test suite or specific files easily using pnpm commands.

- Tags: how-to-guide
- Published: 2026-08-11

### [Kimi-Code Documentation: Where to Find Complete Guides and API References](/MoonshotAI/kimi-code/where-to-find-documentation-for-kimi-code)

Access comprehensive Kimi-Code documentation including guides and API references directly from the MoonshotAI/kimi-code repository or visit our online docs at https://moonshotai.github.io/kimi-code.

- Tags: api-reference
- Published: 2026-08-11

### [How to Report a Bug in Kimi-Code: A Complete Guide with Session Exports and Slash Commands](/MoonshotAI/kimi-code/how-to-report-a-bug-in-kimi-code)

Learn how to report a bug in Kimi-Code using the /bug slash command or by exporting session data. Follow our guide for effective bug reporting.

- Tags: how-to-guide
- Published: 2026-08-11

### [What Is the License for Kimi-Code? MIT License Explained](/MoonshotAI/kimi-code/what-is-the-license-for-kimi-code)

Discover the Kimi-Code license. Understand the MIT License, its permissions for free use, modification, and distribution of this open-source project.

- Tags: licensing-information
- Published: 2026-08-11

### [How to Contribute to Kimi-Code: A Complete Guide for Developers](/MoonshotAI/kimi-code/how-to-contribute-to-the-kimi-code-project)

Learn how to contribute to Kimi-Code project. Clone the repo, install dependencies, and follow the Conventional Commits workflow with changesets for all PRs. Start contributing today!

- Tags: how-to-guide
- Published: 2026-08-11

### [How to Integrate Kimi-Code with Your IDE: The Complete VS Code Setup Guide](/MoonshotAI/kimi-code/how-to-integrate-kimi-code-with-my-ide)

Seamlessly integrate Kimi-Code with VS Code. Follow our guide to set up the extension, connect to your Kimi-Code server, and unlock AI-assisted coding in your IDE.

- Tags: how-to-guide
- Published: 2026-08-11

### [How to Use Kimi-Code for Code Analysis: Complete Guide to TUI and ACP Workflows](/MoonshotAI/kimi-code/how-to-use-kimi-code-for-code-analysis)

Master Kimi-Code for code analysis with our guide. Explore TUI and ACP workflows to understand and leverage its powerful sub-agents for insights.

- Tags: how-to-guide
- Published: 2026-08-11

### [How to Set Up Kimi‑Code Locally: Install Methods and Developer Workflow](/MoonshotAI/kimi-code/how-to-set-up-kimi-code-locally)

Install Kimi-Code locally with our easy single-binary script or build from source using pnpm and Node 24+. Get started with local Kimi-Code development today.

- Tags: how-to-guide
- Published: 2026-08-11

### [Licensing Information for Kimi-Code: MIT License Explained](/MoonshotAI/kimi-code/licensing-information-kimi-code)

Understand the MIT License for Kimi Code. Use, modify, and distribute freely in open-source or proprietary projects with this permissive license.

- Tags: licensing-information
- Published: 2026-07-29

### [What Version Control System Does Kimi-Code Use? Git Repository Structure Explained](/MoonshotAI/kimi-code/version-control-system-kimi-code)

Discover which version control system Kimi-Code uses. Learn about its Git repository structure and how it's managed within the MoonshotAI monorepo.

- Tags: internals
- Published: 2026-07-29

### [How to Debug Issues Within kimi-code Applications: Complete Developer Guide](/MoonshotAI/kimi-code/how-to-debug-kimi-code-applications)

Debug kimi-code applications effectively. Expose internal state, inspect transport errors, and capture TUI render cycles with this complete developer guide. Troubleshoot with ease.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Debug Issues Within kimi-code Packages: A Complete Developer Guide](/MoonshotAI/kimi-code/how-to-debug-kimi-code-packages)

Debug kimi-code packages effectively using kap-server. Discover and invoke DI-registered services for deep runtime introspection without source code changes. A complete developer guide.

- Tags: how-to-guide
- Published: 2026-07-29

### [Build Tools for kimi-code: A Complete Guide to the MoonshotAI Monorepo Toolchain](/MoonshotAI/kimi-code/build-tools-kimi-code)

Discover the kimi-code build tools: pnpm, tsdown, Vite, oxlint, and vitest. Optimize your development workflow with this comprehensive guide to the MoonshotAI monorepo toolchain.

- Tags: how-to-guide
- Published: 2026-07-29

### [How Applications Are Organized Within the Kimi-Code Monorepo Structure](/MoonshotAI/kimi-code/application-organization-monorepo-kimi-code)

Discover how Kimi Code organizes its applications within a TypeScript monorepo. Learn about the separation of apps and packages managed by pnpm workspace and flake.nix.

- Tags: architecture
- Published: 2026-07-29

### [Kimi-Code Monorepo Package Structure: How Apps and Libraries Are Organized](/MoonshotAI/kimi-code/package-organization-monorepo-kimi-code)

Discover how Kimi-Code organizes its monorepo with apps and packages managed by pnpm workspaces. Learn about internal path aliases and workspace dependencies for efficient development.

- Tags: architecture
- Published: 2026-07-29

### [Kimi-Code Coding Standards: TypeScript Best Practices for the MoonshotAI Agent Framework](/MoonshotAI/kimi-code/coding-standards-kimi-code)

Discover Kimi-Code coding standards for MoonshotAI Agent Framework. Learn TypeScript best practices for type-safe and modular agent development with oxlint and strict mode.

- Tags: best-practices
- Published: 2026-07-29

### [Core Functionalities of the kimi-code Packages: A Complete Technical Guide](/MoonshotAI/kimi-code/core-functionalities-kimi-code-packages)

Explore the core functionalities of kimi-code packages. This guide details its modular TypeScript stack for building AI-driven coding agents, including agent engines, SDKs, and more.

- Tags: deep-dive
- Published: 2026-07-29

### [Understanding the Underlying Architecture of Kimi-Code Applications](/MoonshotAI/kimi-code/architecture-kimi-code-applications)

Explore the modular Kimi-Code architecture. Discover how its TypeScript monorepo, separated layers, and service container power unified terminal and web interfaces.

- Tags: architecture
- Published: 2026-07-29

### [How to Contribute to the Kimi Code Project: A Complete Developer Guide](/MoonshotAI/kimi-code/how-to-contribute-kimi-code-project)

Learn how to contribute to the kimi code project. Follow our step by step guide to fork the repository, set up your environment, develop features, and submit pull requests.

- Tags: how-to-guide
- Published: 2026-07-29

### [Kimi-Code Applications Explained: Architecture of the MoonshotAI Monorepo](/MoonshotAI/kimi-code/purpose-of-each-application-kimi-code)

Explore the Kimi-Code monorepo architecture and understand the purpose of each application: CLI, web client, debug inspector, visual debugger, and VS Code extension, all powered by AI.

- Tags: architecture
- Published: 2026-07-29

### [Purpose of Each Package in Kimi-Code: Complete Architecture Guide](/MoonshotAI/kimi-code/purpose-of-each-package-kimi-code)

Explore the Kimi-Code architecture and understand the purpose of each of its 13 TypeScript packages, from agent core to terminal UI essentials.

- Tags: architecture
- Published: 2026-07-29

### [What Programming Languages Does Kimi Code Support?](/MoonshotAI/kimi-code/programming-languages-kimi-code-applications)

Discover the extensive programming language support in Kimi Code. Learn which languages the AI understands for code generation and analysis. Essential info for developers.

- Tags: getting-started
- Published: 2026-07-29

### [What Programming Languages Are Used in Kimi Code Packages?](/MoonshotAI/kimi-code/programming-languages-kimi-code-packages)

Discover the programming languages powering Kimi Code packages. Built with TypeScript, it supports diverse languages like Python, Go, Rust, Java, and C++ for LLM code generation.

- Tags: programming-languages
- Published: 2026-07-29

### [How to Run Tests in Kimi-Code: Complete Vitest Guide for the Monorepo](/MoonshotAI/kimi-code/how-to-run-tests-kimi-code)

Learn to run tests in Kimi-Code with Vitest. Execute pnpm test at the monorepo root or use pnpm test:watch for continuous development testing.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Build the kimi-code Project: Complete Monorepo Setup Guide](/MoonshotAI/kimi-code/how-to-build-kimi-code-project)

Learn how to build the kimi code project by cloning the monorepo and installing dependencies with pnpm. Compile the CLI, web UI, and shared libraries effortlessly. Your complete setup guide.

- Tags: how-to-guide
- Published: 2026-07-29

### [What Are the Dependencies for the Kimi-Code Applications?](/MoonshotAI/kimi-code/dependencies-kimi-code-applications)

Discover the dependencies for Kimi-code applications. Explore how each package in the MoonshotAI/kimi-code monorepo manages libraries like zod, openai, and chokidar or maintains zero external dependencies.

- Tags: how-to-guide
- Published: 2026-07-29

### [What Are the Dependencies for the Kimi-Code Packages? Complete Monorepo Reference](/MoonshotAI/kimi-code/dependencies-kimi-code-packages)

Discover the dependencies for Kimi-Code packages within its monorepo. Explore LLM SDKs, infrastructure libraries, and more.

- Tags: api-reference
- Published: 2026-07-29

### [MoonshotAI/kimi-code Apps Directory Structure: A Technical Guide to the Three Applications](/MoonshotAI/kimi-code/code-structure-apps-directory-kimi-code)

Explore the MoonshotAI/kimi-code apps directory structure. Understand the independent Vite configs, entry points, and build pipelines for kimi-web, vscode, and vis applications.

- Tags: technical-guide
- Published: 2026-07-29

### [How the Packages Directory Is Structured in the Kimi Code Repository](/MoonshotAI/kimi-code/code-structure-packages-directory-kimi-code)

Explore the Kimi Code repository packages directory structure. Learn how TypeScript npm packages are organized for agent engines, protocols, execution, and LLM abstractions.

- Tags: internals
- Published: 2026-07-29

### [Primary Applications Within the Kimi-Code Project: A Complete Guide](/MoonshotAI/kimi-code/primary-applications-within-kimi-code-project)

Explore the primary applications of the kimi-code project including CLI, browser UI, visual debugger, web inspector, and IDE extension. Learn how they leverage a shared TypeScript core.

- Tags: how-to-guide
- Published: 2026-07-29

### [Main Packages in the Kimi-Code Repository: Complete Monorepo Architecture](/MoonshotAI/kimi-code/main-packages-in-kimi-code-repository)

Explore the Kimi-Code repository's monorepo architecture and discover its fourteen core packages, including agent engines, Kap server, SDKs, and LLM abstractions.

- Tags: architecture
- Published: 2026-07-29

### [How to Set Up the Development Environment for Kimi Code: A Complete Guide](/MoonshotAI/kimi-code/how-to-set-up-development-environment-kimi-code)

Set up the Kimi Code development environment easily. Follow this guide to install Node.js and pnpm, clone the repository, and launch the CLI or web UI for Kimi Code.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Implement Tool Approval and Permission Gating Mechanisms in Kimi-Code](/MoonshotAI/kimi-code/implement-tool-approval-permission-gating)

Implement tool approval and permission gating in Kimi-Code with a dual-layer architecture. Learn how to separate human approval flows from automated policy enforcement for robust control.

- Tags: how-to-guide
- Published: 2026-07-27

### [How to Create Custom Skills for Kimi Code: A Complete Developer's Guide](/MoonshotAI/kimi-code/create-custom-skills-kimi-code)

Learn to create custom skills for Kimi Code using Markdown and YAML. This developer's guide covers storing and invoking your custom skills via slash commands or the Node SDK.

- Tags: how-to-guide
- Published: 2026-07-27

### [How to Create and Utilize Custom Subagents in Kimi-Code: A Complete Guide to Coder, Explore, and Plan Agents](/MoonshotAI/kimi-code/create-use-custom-subagents-coder-explore-plan)

Learn to create and utilize custom subagents like coder, explore, and plan in Kimi-Code. This guide details YAML configurations for modular task delegation and efficient coding workflows.

- Tags: how-to-guide
- Published: 2026-07-27

### [Video Input Processing and Media Handling in Kimi Code: Architecture and Implementation](/MoonshotAI/kimi-code/video-input-processing-and-media-handling-in-kimi-code)

Explore Kimi Code's advanced video input processing and media handling. Discover its layered architecture for validation, storage, and provider capability negotiation.

- Tags: architecture
- Published: 2026-07-26

### [How to Deploy Kimi Code in Containerized Environments: Docker and Kubernetes Guide](/MoonshotAI/kimi-code/how-to-deploy-kimi-code-in-containerized-environments)

Deploy Kimi Code in containerized environments easily. Follow our Docker and Kubernetes guide to build a container image and run the server quickly using production-ready Dockerfile and scripts.

- Tags: how-to-guide
- Published: 2026-07-26

### [Understanding the Transcript Layers (L0-L4) Architecture in Kimi Code](/MoonshotAI/kimi-code/understanding-transcript-layers-architecture-kimi-code)

Explore the Kimi Code transcript layers L0-L4 architecture. Understand how its five-layer stack ensures perfect server-client synchronization by separating core functions like contracts state mutations transport and UI rendering.

- Tags: architecture
- Published: 2026-07-26

### [Kimi Code Plugin Marketplace Architecture and Distribution Model Explained](/MoonshotAI/kimi-code/kimi-code-plugin-marketplace-architecture-and-distribution)

Explore the Kimi Code plugin marketplace architecture and distribution. Learn how to discover and manage extensions easily through GitHub repositories, ZIP URLs, or local paths. Get started today.

- Tags: architecture
- Published: 2026-07-26

### [Performance Optimization for the Kimi Code Terminal UI (TUI): Architecture and Best Practices](/MoonshotAI/kimi-code/performance-optimization-for-kimi-code-terminal-ui)

Optimize Kimi Code TUI performance with diff rendering, batched writes, and smart redraw suppression. Learn architecture and best practices from MoonshotAI.

- Tags: performance
- Published: 2026-07-26

### [How to Create Custom Tools and Extend the Tool Registry in Kimi Code](/MoonshotAI/kimi-code/creating-custom-tools-and-extending-tool-registry)

Learn to create custom tools and extend the tool registry in Kimi Code. Register ExecutableTool objects using IAgentToolRegistryService for persistent, isolated capabilities that survive session restarts.

- Tags: how-to-guide
- Published: 2026-07-26

### [Session State Management and Persistence in Kimi Code: A Technical Deep Dive](/MoonshotAI/kimi-code/session-state-management-and-persistence-in-kimi-code)

Explore Kimi Code's session state management. Learn how it persists runtime data to JSON files for seamless session resumption across CLI, TUI, and web clients.

- Tags: deep-dive
- Published: 2026-07-26

### [How to Implement IDE Integration via the ACP Protocol in Kimi Code: A Complete Guide](/MoonshotAI/kimi-code/how-to-implement-ide-integration-via-acp-protocol)

Integrate Kimi Code IDEs using the ACP protocol. Drive Kimi sessions, execute commands, and get real-time updates via stdio or TCP. Explore the MoonshotAI kimi-code repository for details.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Configure Model Aliases and Overrides in Kimi Code's config.toml](/MoonshotAI/kimi-code/how-to-configure-model-aliases-and-overrides-in-config-toml)

Learn to configure model aliases and overrides in Kimi Code's config.toml. Customize your AI model behavior with aliases and property overrides for enhanced control.

- Tags: how-to-guide
- Published: 2026-07-26

### [Understanding the kap-server Architecture and Debug Endpoints in Kimi Code](/MoonshotAI/kimi-code/understanding-kap-server-architecture-and-debug-endpoints)

Explore the kap-server architecture and its debug endpoints in Kimi Code. Learn about the Fastify backend, agent-core-v2, and secured RPC surface for efficient debugging.

- Tags: architecture
- Published: 2026-07-26

### [How to Use Experimental Flags to Enable New Features in Kimi Code](/MoonshotAI/kimi-code/how-to-use-experimental-flags-to-enable-new-features)

Unlock Kimi Code experimental features using environment variables, config files, or programmatic overrides. Leverage runtime flags to test new capabilities effortlessly.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Set Up OAuth Authentication with Keyring Storage in Kimi Code](/MoonshotAI/kimi-code/setting-up-oauth-authentication-with-keyring-storage)

Securely set up OAuth authentication with keyring storage in Kimi Code. Learn how Kimi Code uses native OS keychains for token storage, enhancing security.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Exit Plan Mode Enables Structured Planning in Kimi Code](/MoonshotAI/kimi-code/how-does-exit-plan-mode-work-for-structured-planning)

Discover how Exit Plan Mode in Kimi Code converts agent drafted plans into queryable facts for structured planning, then returns to normal execution.

- Tags: deep-dive
- Published: 2026-07-26

### [Managing Background Tasks and Cron Jobs in Kimi Code: A Complete Guide](/MoonshotAI/kimi-code/managing-background-tasks-and-cron-jobs-in-kimi-code)

Learn to manage background tasks and cron jobs in Kimi Code with this complete guide. Discover the unified, type-safe system for scheduling recurring work and executing long-running tasks.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Debug Session Issues Using the Kimi Code Transcript System](/MoonshotAI/kimi-code/how-to-debug-session-issues-using-kimi-code-transcript-system)

Debug session issues effectively with the Kimi Code transcript system. Inspect live stores, rebuild snapshots, and monitor operation streams to resolve synchronization errors. Learn how today.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Create Custom Skills for Kimi Code CLI: A Complete Guide](/MoonshotAI/kimi-code/how-to-create-custom-skills-for-kimi-code-cli)

Learn to create custom skills for Kimi Code CLI. This guide explains reusable prompt templates in Markdown with YAML front-matter. Discover how to invoke them easily.

- Tags: how-to-guide
- Published: 2026-07-26

### [Understanding the Agent-Core Dependency Injection System in Kimi Code](/MoonshotAI/kimi-code/understanding-agent-core-dependency-injection-system-kimi-code)

Explore Kimi Code's agent-core dependency injection system. Learn how ServiceCollection, SyncDescriptor, and InstantiationService manage lazy instantiation, cycle detection, and child containers.

- Tags: deep-dive
- Published: 2026-07-26

### [How to Configure Multiple LLM Providers (Anthropic, OpenAI, Google GenAI, VertexAI) in Kimi Code](/MoonshotAI/kimi-code/how-to-configure-multiple-llm-providers-in-kimi-code)

Easily configure multiple LLM providers like Anthropic, OpenAI, and Google GenAI in Kimi Code using the [providers] table in config.toml. Streamline your AI development now.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Set Up the Kimi Code Server with REST and WebSocket Endpoints](/MoonshotAI/kimi-code/how-to-set-up-kimi-code-server-rest-websocket)

Learn how to set up the Kimi Code server, configure REST and WebSocket endpoints, and enable bearer token authentication for seamless API integration.

- Tags: how-to-guide
- Published: 2026-07-26

### [Understanding Kimi Code Lifecycle Hooks: Event-Driven Automation and Security](/MoonshotAI/kimi-code/how-do-kimi-code-lifecycle-hooks-work-and-when-to-use-them)

Learn how Kimi Code lifecycle hooks automate and secure AI interactions. Trigger shell commands with JSON payloads at key session events for auditing and modification.

- Tags: deep-dive
- Published: 2026-07-26

### [How to Build Custom Subagents (Coder, Explore, Plan) in Kimi Code](/MoonshotAI/kimi-code/how-to-build-custom-subagents-in-kimi-code)

Learn to build custom subagents like coder, explore, and plan in Kimi Code. Follow simple steps to create YAML profiles, register them, and spawn agents for powerful automation.

- Tags: how-to-guide
- Published: 2026-07-26

### [What is ACP (Agent Client Protocol) and How It Integrates with Zed and JetBrains](/MoonshotAI/kimi-code/what-is-acp-protocol-and-how-does-it-integrate-with-zed-and-jetbrains)

Discover ACP Agent Client Protocol, a JSON-RPC system letting Zed and JetBrains IDEs control AI agents via stdin/stdout for seamless integration.

- Tags: deep-dive
- Published: 2026-07-26

### [How to Configure MCP Servers Conversationally in Kimi Code CLI](/MoonshotAI/kimi-code/how-to-configure-mcp-servers-conversationally-in-kimi-code-cli)

Easily configure MCP servers conversationally with Kimi Code CLI. Run kimi mcp configure to add servers, handle authentication, and automatically update mcp.json without manual editing.

- Tags: how-to-guide
- Published: 2026-07-26

### [How the Kos Provider Abstraction Layer Selects and Routes Models in Kimi Code](/MoonshotAI/kimi-code/how-kos-provider-abstraction-layer-selects-routes-models)

Discover how the Kos provider abstraction layer in Kimi Code selects and routes models. Learn about the two-step process involving createProvider and getModelCapability for efficient model management.

- Tags: internals
- Published: 2026-07-25

### [How to Write Lifecycle Hooks for Desktop Notifications in Kimi Code](/MoonshotAI/kimi-code/how-to-write-lifecycle-hooks-desktop-notifications)

Learn how to write lifecycle hooks for desktop notifications in Kimi Code. Trigger OS-native alerts and customize plugin behavior at specific execution points.

- Tags: how-to-guide
- Published: 2026-07-25

### [WebSocket Transcript Protocol Reconnection and Sync in Kimi Code](/MoonshotAI/kimi-code/how-websocket-transcript-protocol-handles-reconnection-sync)

Discover how the Kimi Code WebSocket transcript protocol uses exponential backoff and cursor-based replay for reliable reconnection and sync, ensuring seamless real-time data streams.

- Tags: internals
- Published: 2026-07-25

### [How to Run the Kimi-Code Development Server Locally: Complete Setup Guide](/MoonshotAI/kimi-code/how-to-run-development-server-locally)

Easily run the Kimi-Code development server locally with our complete setup guide. Follow simple steps to start the kap-server and access debug endpoints for efficient development.

- Tags: how-to-guide
- Published: 2026-07-25

### [How Experimental Features Are Gated Behind Flags in Kimi-Code: Architecture and Implementation Guide](/MoonshotAI/kimi-code/how-experimental-features-gated-behind-flags)

Discover how Kimi-Code gates experimental features using a hierarchical flag system. Learn about its architecture and implementation for runtime feature availability.

- Tags: architecture
- Published: 2026-07-25

### [How to Add Custom Themes to the kimi-code Terminal UI](/MoonshotAI/kimi-code/how-to-add-custom-themes-terminal-ui)

Learn how to add custom themes to the kimi-code terminal UI. Create JSON files to define color overrides and activate your themes easily. Personalize your terminal experience today.

- Tags: how-to-guide
- Published: 2026-07-25

### [How the Klient SDK Communicates with the Kimi-Code Server: Architecture and Implementation](/MoonshotAI/kimi-code/how-klient-sdk-communicates-server)

Learn how the Klient SDK communicates with the Kimi-Code server using HTTP REST and WebSockets via typed facades for efficient request-response and real-time streaming.

- Tags: architecture
- Published: 2026-07-25

### [How to Set Up the Kimi-Inspect Web Debugger: Complete Configuration Guide](/MoonshotAI/kimi-code/how-to-set-up-kimi-inspect-web-debugger)

Learn how to set up the Kimi-Inspect web debugger with this complete configuration guide. Follow simple steps to connect the UI to your Kap Server and start debugging.

- Tags: how-to-guide
- Published: 2026-07-25

### [How the Permission System Works in agent-core-v2: Understanding PermissionManager](/MoonshotAI/kimi-code/how-permission-system-works-agent-core-v2)

Explore the agent-core-v2 permission system centered on PermissionManager. Learn how configurable modes, rules, and policies control AI tool call execution, user approval, or blocking.

- Tags: internals
- Published: 2026-07-25

### [How to Migrate from Legacy Kimi-Code Configurations: Complete Guide](/MoonshotAI/kimi-code/how-to-migrate-legacy-kimi-code-configurations)

Easily migrate legacy Kimi-code configurations to the new format using the CLI command or migration package. Transfer configs, servers, and chat history safely without data loss.

- Tags: migration-guide
- Published: 2026-07-25

### [How Video Input Processing Works for Screen Recordings in Kimi-Code](/MoonshotAI/kimi-code/how-video-input-processing-works-screen-recordings)

Discover how Kimi-Code processes screen recordings, from UI detection and file ID generation to AI model routing. Learn about the multi-stage video input pipeline and its capabilities.

- Tags: deep-dive
- Published: 2026-07-25

### [How to Configure Environment Variables for Provider Overrides in Kimi Code](/MoonshotAI/kimi-code/how-to-configure-environment-variables-provider-overrides)

Learn to configure environment variables for provider overrides in Kimi Code. Seamlessly customize settings like base URL and API keys before adapter initialization.

- Tags: how-to-guide
- Published: 2026-07-25

### [How to Write Custom Skills for the Kimi-Code CLI: A Complete Guide](/MoonshotAI/kimi-code/how-to-write-custom-skills-kimi-code-cli)

Learn to write custom skills for the Kimi-Code CLI. Enhance your workflow with reusable Markdown files and slash commands. Get started with our complete guide.

- Tags: how-to-guide
- Published: 2026-07-25

### [How the agent-core-v2 DI System Differs from agent-core](/MoonshotAI/kimi-code/how-agent-core-v2-di-system-differs-agent-core)

Discover the differences between agent-core-v2 DI system and agent-core. Explore isolated service lifecycles, explicit multi-agent support, and easier testing.

- Tags: comparison
- Published: 2026-07-25

### [How to Debug Kimi-Code Sessions Using the Kap-Server REST and WebSocket APIs](/MoonshotAI/kimi-code/how-to-debug-sessions-kap-server-rest-websocket-apis)

Debug Kimi-Code sessions via kap-server REST API for snapshots or WebSocket API for real-time events. Access transcript data and operational batches efficiently.

- Tags: how-to-guide
- Published: 2026-07-25

### [How the Kimi Code Transcript System Manages Chat History and Replay](/MoonshotAI/kimi-code/how-transcript-system-works-chat-history-replay)

Discover how the Kimi Code transcript system uses a two-layer architecture for synchronized, immutable chat history and real-time replay.

- Tags: internals
- Published: 2026-07-25

### [How Session State is Persisted and Managed Across Kimi-Code Restarts](/MoonshotAI/kimi-code/how-session-state-persisted-managed-restarts)

Discover how Kimi-Code persists session state with wire.jsonl logs, enabling seamless restarts and transcript rebuilding with SessionStore for uninterrupted workflow.

- Tags: internals
- Published: 2026-07-25

### [How to Set Up the Plugin Marketplace and Install Skills from GitHub in Kimi Code](/MoonshotAI/kimi-code/how-to-set-up-plugin-marketplace-install-skills-github)

Learn to set up the Kimi Code plugin marketplace and install skills directly from GitHub. This guide explains how to configure the marketplace URL and use the installPlugin method for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-25

### [How the Kimi-Code TUI Is Built and How to Customize the Terminal Interface](/MoonshotAI/kimi-code/how-tui-is-built-customize-terminal-interface)

Explore the modular architecture of Kimi-Code TUI. Learn how to customize the terminal interface with widget composition, theme overrides, and keymap modifications.

- Tags: internals
- Published: 2026-07-25

### [How to Configure MCP Servers Conversationally Using `/mcp-config` in Kimi Code](/MoonshotAI/kimi-code/how-to-configure-mcp-servers-conversationally-mcp-config)

Easily configure MCP servers conversationally with Kimi Code using the /mcp-config command. Add edit authenticate and list servers interactively eliminating manual JSON edits.

- Tags: how-to-guide
- Published: 2026-07-25

### [How Lifecycle Hooks Gate Tool Calls and Drive Auditing in Kimi Code](/MoonshotAI/kimi-code/how-lifecycle-hooks-work-gating-tool-calls-auditing-decisions)

Discover how Kimi Code's lifecycle hooks gate tool calls and drive auditing. Learn about prepareToolExecution, authorizeToolExecution, finalizeToolResult, and onDidExecuteTool for enhanced control and insights.

- Tags: deep-dive
- Published: 2026-07-25

### [How to Set Up and Use Subagents Like Coder, Explore, and Plan for Parallel Work](/MoonshotAI/kimi-code/how-to-set-up-use-subagents-coder-explore-plan-parallel-work)

Master Kimi Code's parallel work capabilities. Learn to set up and utilize subagents like Coder, Explore, and Plan for efficient, concurrent task execution.

- Tags: tutorial
- Published: 2026-07-25

### [How to Use Agent Client Protocol (ACP) to Integrate Kimi Code with Zed or JetBrains](/MoonshotAI/kimi-code/how-to-use-agent-client-protocol-acp-integrate-zed-jetbrains)

Integrate Kimi Code with Zed or JetBrains using ACP. Learn how to connect your IDEs via STDIO JSON-RPC for seamless AI agent interaction and tool utilization.

- Tags: how-to-guide
- Published: 2026-07-25

### [How to Configure Custom LLM Providers in Kimi Code: Beyond Built-in Models](/MoonshotAI/kimi-code/how-to-configure-custom-llm-providers-beyond-kimi-models)

Configure custom LLM providers in Kimi Code by adding them to config.toml. Integrate any OpenAI compatible endpoint easily without modifying core files.

- Tags: how-to-guide
- Published: 2026-07-25

### [How to Report a Bug in Kimi Code: A Step-by-Step Guide](/MoonshotAI/kimi-code/report-bug-kimi-code)

Learn how to report a bug in Kimi Code with our step-by-step guide. Follow these instructions to provide necessary details and submit effective bug reports for the MoonshotAI/kimi-code repository.

- Tags: how-to-guide
- Published: 2026-07-24

### [Where to Find Documentation for Kimi-Code: A Complete Guide to the MoonshotAI Repository](/MoonshotAI/kimi-code/kimi-code-documentation)

Find complete Kimi-Code documentation in the MoonshotAI kimi-code repository docs directory or online at https://moonshotai.github.io/kimi-code.

- Tags: getting-started
- Published: 2026-07-24

### [How to Run Kimi-Code on a Local Machine: Complete Setup Guide](/MoonshotAI/kimi-code/run-kimi-code-locally)

Run Kimi-Code locally with our setup guide. Install Nodejs and pnpm, clone the repo, and launch the backend server and terminal UI for effortless local development.

- Tags: how-to-guide
- Published: 2026-07-24

### [What Programming Languages Does Kimi-Code Support?](/MoonshotAI/kimi-code/kimi-code-supported-languages)

Discover the extensive programming languages supported by Kimi-Code. This language-agnostic assistant works with any LLM trained language, offering unparalleled versatility. Learn more today.

- Tags: getting-started
- Published: 2026-07-24

### [How Kimi Code Loads Its Configuration Schema and Environment Variables](/MoonshotAI/kimi-code/how-does-the-configuration-schema-and-environment-variable-loading-work-in-kimi-code)

Discover how Kimi Code loads its configuration schema and environment variables. Learn about TOML validation, Zod schemas, and typed KimiConfig objects for robust setup.

- Tags: internals
- Published: 2026-07-22

### [How the Background Task and Cron Job System Works in Kimi Code](/MoonshotAI/kimi-code/how-does-the-background-task-and-cron-job-system-operate-in-kimi-code)

Discover how the background task and cron job system in Kimi Code operates. Learn about its three-layer architecture for uniform input handling and efficient background processing within the agent engine.

- Tags: internals
- Published: 2026-07-22

### [How to Debug File Permission and Path Access Policy Issues in Kimi Code](/MoonshotAI/kimi-code/how-to-debug-file-permission-and-path-access-policy-issues-in-kimi-code)

Debug Kimi Code file permission and path access issues. Learn to check permission modes, error codes like fs.permission_denied, and OS file system access for seamless coding.

- Tags: how-to-guide
- Published: 2026-07-22

### [What Are Subagents in Kimi Code? Understanding Coder, Explore, and Plan Agents](/MoonshotAI/kimi-code/what-are-subagents-in-kimi-code-and-how-do-coder-explore-and-plan-agents-function)

Discover subagents in Kimi Code. Learn how coder, explore, and plan agents work autonomously to manage code tasks efficiently. Explore the MoonshotAI/kimi-code protocol.

- Tags: deep-dive
- Published: 2026-07-22

### [How to Configure Multiple LLM Providers Beyond Kimi in Kimi Code](/MoonshotAI/kimi-code/how-to-configure-multiple-llm-providers-beyond-kimi-in-kimi-code)

Configure multiple LLM providers beyond Kimi in Kimi Code. Seamlessly switch between Kimi, OpenAI, Anthropic, and custom models using the providers map in your global configuration. Learn more now.

- Tags: how-to-guide
- Published: 2026-07-22

### [How the Kimi Code Session Management System Works: A Three-Layer Architecture](/MoonshotAI/kimi-code/how-does-the-session-management-system-work-in-kimi-code)

Explore the Kimi Code session management system's three-layer architecture. Learn how it ensures atomic operations, real-time tracking, and cross-platform consistency for MoonshotAI/kimi-code.

- Tags: architecture
- Published: 2026-07-22

### [How to Create and Use Custom Skills in Kimi Code: A Complete Guide](/MoonshotAI/kimi-code/how-to-create-and-use-custom-skills-in-kimi-code)

Learn to create and use custom skills in Kimi Code. This guide shows you how to define reusable prompt templates for efficient coding workflows.

- Tags: how-to-guide
- Published: 2026-07-22

### [How Agent Client Protocol (ACP) Integrates with Zed and JetBrains in Kimi Code](/MoonshotAI/kimi-code/how-does-agent-client-protocol-acp-integrate-with-zed-and-jetbrains-in-kimi-code)

Discover how Kimi Code integrates Agent Client Protocol ACP with Zed and JetBrains IDEs. Learn to launch agent sessions, execute commands, and stream updates via the kimi acp sub-command.

- Tags: deep-dive
- Published: 2026-07-22

### [How Kimi Code Lifecycle Hooks Work: Events, Execution, and Configuration](/MoonshotAI/kimi-code/how-do-lifecycle-hooks-work-and-when-should-i-use-them-in-kimi-code)

Unlock Kimi Code's power. Learn how lifecycle hooks map session events to shell commands, control workflow with exit codes, and handle errors gracefully. Maximize your AI coding.

- Tags: internals
- Published: 2026-07-22

### [How to Configure MCP Servers in Kimi Code: A Complete Guide](/MoonshotAI/kimi-code/how-to-configure-mcp-model-context-protocol-servers-in-kimi-code)

Learn to configure MCP servers in Kimi Code by merging JSON files and using the mcp naming convention. This complete guide provides clear steps for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-22