Skip to content

feat: add kode migrate command and drop legacy .claude reading - #206

Merged
im10furry merged 3 commits into
mainfrom
docs/beautify-readme
Jul 25, 2026
Merged

feat: add kode migrate command and drop legacy .claude reading#206
im10furry merged 3 commits into
mainfrom
docs/beautify-readme

Conversation

@im10furry

Copy link
Copy Markdown
Contributor

Summary

Add /migrate command and remove default .claude reading, making .kode the sole configuration source.

Changes

New: kode migrate command

  • Copies .claude/ directory contents (commands, skills, agents, output-styles, settings) → .kode/
  • Copies CLAUDE.mdAGENTS.md
  • Supports --project (default), --user, --all flags
  • Skips existing files without overwriting
  • Outputs detailed migration report

Breaking: Drop legacy .claude reading

  • getProjectDocsForCwd() / getInstructionFilesNote() no longer read CLAUDE.md
  • Custom commands loader no longer scans .claude/commands or .claude/skills
  • File watcher no longer monitors .claude directories
  • handleHashCommand() only writes to AGENTS.md (no CLAUDE.md sync)
  • Help screen no longer lists legacy directories

Migration path

Users with existing .claude configs should run:

kode migrate --all

This copies everything to .kode/ / AGENTS.md. Old files can then be safely removed.

BREAKING CHANGE

Kode no longer reads from .claude/ or CLAUDE.md by default. Run kode migrate first.

- Centered hero section with cleaner badge layout
- Added table of contents for navigation
- Reorganized content with tables and collapsible details
- Condensed multi-model section (ASCII diagram + tables)
- Reduced EN from 682 to ~330 lines, CN from 590 to ~340 lines
- Used GitHub Alert syntax for important notices
- Unified keyboard shortcuts and config as tables
- Add sampling.ts with CreateMessage request handler that routes
  through queryLLM for multi-provider LLM support
- Declare sampling capability in getMcpClientCapabilities() so
  MCP servers know the client supports sampling
- Register/unregister sampling handler in client lifecycle
- Convert between MCP SamplingMessage and internal Anthropic format
- Resolve model from server's modelPreferences hints
- Map stop_reason between internal and MCP spec formats
- Export sampling control APIs (enable/disable/test helpers)
- Update capability tests for sampling enabled/disabled states
- Add /migrate command to copy .claude/ → .kode/ and CLAUDE.md → AGENTS.md
  Supports --project (default), --user, and --all flags
- Remove CLAUDE.md reading from context system (getProjectDocsForCwd,
  getInstructionFilesNote)
- Remove .claude/commands and .claude/skills loading from custom commands
- Remove .claude directory watching from command watcher
- Remove CLAUDE.md sync-write from hashCommand (only writes AGENTS.md)
- Update HelpScreen to remove legacy directory listing

BREAKING CHANGE: Kode no longer reads from .claude/ or CLAUDE.md by default.
Run `kode migrate` to move existing configs to .kode/AGENTS.md.
@im10furry
im10furry merged commit 1990ec3 into main Jul 25, 2026
1 of 4 checks passed
@im10furry
im10furry deleted the docs/beautify-readme branch July 25, 2026 18:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant