diff --git a/.changeset/purple-moose-kiss.md b/.changeset/purple-moose-kiss.md
new file mode 100644
index 0000000000..b13fe90bf1
--- /dev/null
+++ b/.changeset/purple-moose-kiss.md
@@ -0,0 +1,5 @@
+---
+"@moonshot-ai/kimi-code": patch
+---
+
+feat: add make help command
diff --git a/Makefile b/Makefile
index d5889efa25..0d379845d8 100644
--- a/Makefile
+++ b/Makefile
@@ -1,67 +1,75 @@
-.PHONY: prepare build typecheck lint lint-fix lint-pkg sherif test test-watch test-coverage clean changeset version publish release dev vis
+.PHONY: prepare build typecheck lint lint-fix lint-pkg sherif test test-watch test-coverage clean changeset version publish release dev vis help
 
 ## Setup
 
-prepare:
+prepare: ## Install project dependencies
 	pnpm install
 
 ## Build
 
-build:
+build: ## Build all workspace packages
 	pnpm run build
 
 ## Quality
 
-typecheck:
+typecheck: ## Type-check all workspace packages
 	pnpm run typecheck
 
-lint:
+lint: ## Run lint checks
 	pnpm run lint
 
-lint-fix:
+lint-fix: ## Fix lint issues
 	pnpm run lint:fix
 
-sherif:
+sherif: ## Check monorepo package configuration
 	pnpm run sherif
 
-lint-pkg:
+lint-pkg: ## Lint package metadata
 	pnpm run lint:pkg
 
 ## Test
 
-test:
+test: ## Run the test suite
 	pnpm run test
 
-test-watch:
+test-watch: ## Run tests in watch mode
 	pnpm run test:watch
 
-test-coverage:
+test-coverage: ## Run tests with coverage
 	pnpm run test:coverage
 
 ## Clean
 
-clean:
+clean: ## Remove build artifacts
 	pnpm run clean
 
 ## Release
 
-changeset:
+changeset: ## Create a changeset
 	pnpm run changeset
 
-version:
+version: ## Apply changesets and update versions
 	pnpm run version
 
-publish:
+publish: ## Publish packages
 	pnpm run publish
 
-release: version publish
+release: version publish ## Version and publish packages
 
 ## Development
 
-dev:
+dev: ## Start the CLI in development mode
 	pnpm run dev:cli
 
 ## vis
 
-vis:
+vis: ## Start the session visualization tools
 	pnpm run vis
+
+## Help
+
+help: ## Show this help message
+	@awk 'BEGIN { printf "Usage: make <target>\n" } \
+		/^## / { printf "\n%s:\n", substr($$0, 4); next } \
+		/^[a-zA-Z0-9_-]+:.*## / { split($$0, parts, ":.*## "); printf "  %-16s %s\n", parts[1], parts[2] }' \
+		$(firstword $(MAKEFILE_LIST))