CLAUDE.md - Agent Guidelines for claude-cli

Commands

Build: bun run build
Dev: bun run dev
Test: bun test
Run CLI: bun run src/index.ts [command] [options]

Code Style Guidelines

Language: TypeScript with strict mode enabled
Modules: ESM modules with named exports
Types: Zod for runtime validation, TypeScript interfaces for static types
Naming: camelCase for variables/functions, PascalCase for types/interfaces
Imports: Group imports by external packages, then internal modules
Error Handling: Typed errors with descriptive messages
File Structure: One component/feature per file, grouped by functionality
Architecture: Commands in src/commands/, core logic in src/core/, utils in src/utils/

Project Structure

Configuration management via .claude-cli.config.ts
Command modules follow pattern in src/commands/[command-name].ts
Schemas defined in src/schemas/ using Zod
Core API interactions in src/core/