Kode-cli/docs/PROJECT_STRUCTURE.md
CrazyBoyM d8f0a22233 feat: Implement intelligent completion system with advanced fuzzy matching
- Add advanced fuzzy matching with 7+ strategies (exact, prefix, substring, acronym, initials, fuzzy, Levenshtein)
- Create comprehensive database of 500+ common Unix commands for smart autocompletion
- Implement intelligent Tab completion with @ prefix injection for agents and files
- Add sophisticated input pattern recognition for commands like "dao", "gp5", "py3"
- Enhance mention system with TaskProgressMessage component for better user feedback
- Update documentation with comprehensive intelligent completion guide
- Clean up 21 temporary markdown files to maintain repository cleanliness
- Improve project structure and configuration documentation
- Optimize completion system performance with advanced caching and scoring
2025-08-22 13:07:48 +08:00

2.7 KiB

Kode Project Structure

Overview

Clean, modern TypeScript CLI project using Bun for development and building.

Build System

  • Runtime: Bun (preferred) with Node.js fallback
  • Build Tool: Custom build.ts using Bun
  • Package Manager: Bun (with npm publish compatibility)
  • TypeScript Execution: Direct source execution (no bundling)

Key Files

.
├── cli.js                 # Smart CLI wrapper (generated)
├── build.ts              # Build script
├── package.json          # Package configuration
├── tsconfig.json         # TypeScript configuration
├── yoga.wasm            # Required WASM file for Ink
├── .npmrc               # NPM configuration (generated)
├── .gitignore           # Git ignore rules
├── .prettierrc          # Code formatting config
│
├── src/                 # Source code
│   ├── entrypoints/
│   │   ├── cli.tsx      # Main CLI entry point
│   │   └── mcp.ts       # MCP server entry
│   ├── commands/        # Command implementations
│   ├── components/      # React/Ink components
│   ├── tools/           # AI tool implementations
│   ├── services/        # Core services
│   ├── hooks/           # React hooks
│   │   └── useUnifiedCompletion.ts  # Advanced completion system
│   ├── utils/           # Utility functions
│   │   ├── advancedFuzzyMatcher.ts  # 7+ algorithm fuzzy matcher
│   │   ├── fuzzyMatcher.ts          # Matcher integration layer
│   │   ├── commonUnixCommands.ts    # 500+ command database
│   │   └── agentLoader.ts           # Agent configuration loader
│   └── constants/       # Constants and configurations
│
├── docs/                # Documentation
│   └── custom-commands.md
│
├── scripts/             # Build and utility scripts
│   └── prepublish-check.js
│
├── test/                # Test files
│   └── customCommands.test.ts
│
├── README.md            # English documentation
├── README.zh-CN.md      # Chinese documentation
├── PUBLISH.md           # Publishing guide
├── AGENTS.md           # Project context (generated)
└── system-design.md     # System architecture doc (Chinese)

Build & Run

Development

bun run dev

Build

bun run build

Test CLI

./cli.js --help

Publish

npm publish --access public

Clean Architecture

  • No build artifacts in source control
  • Single lock file (bun.lock)
  • Generated files properly ignored
  • Clear separation of concerns
  • Minimal dependencies bundled