function createCLI(config: CLIConfig): CLI

interface CLIConfig {
  name: string
  version: string
  description?: string
  commands?: {
    manifest?: string
  }
  plugins?: PluginConfig[]
}

interface CLI {
  command(cmd: Command): void
  load(manifest: CommandManifest): Promise<void>
  init(): Promise<void>
  run(argv?: string[]): Promise<void>
}

import { createCLI } from '@bunli/core'

const cli = createCLI({
  name: 'my-cli',
  version: '1.0.0',
  description: 'My awesome CLI tool'
})

// Add commands
cli.command({
  name: 'hello',
  description: 'Say hello',
  handler: async () => {
    console.log('Hello, World!')
  }
})

// Run the CLI
await cli.run()

import { createCLI } from '@bunli/core'

const cli = createCLI({
  name: 'my-cli',
  version: '1.0.0',
  description: 'My CLI with lazy-loaded commands',
  commands: {
    manifest: './commands/manifest.js'
  }
})

// Initialize (loads manifest)
await cli.init()

// Run the CLI
await cli.run()

import { createCLI } from '@bunli/core'
import manifest from './commands/manifest.js'

const cli = createCLI({
  name: 'my-cli',
  version: '1.0.0'
})

// Load commands from manifest
await cli.load(manifest)

// Run the CLI
await cli.run()

import { createCLI } from '@bunli/core'
import { configMergerPlugin } from '@bunli/plugin-config'
import { aiAgentPlugin } from '@bunli/plugin-ai-detect'

const cli = await createCLI({
  name: 'my-cli',
  version: '1.0.0',
  plugins: [
    // Load configuration from files
    configMergerPlugin(),
    
    // Detect AI agents
    aiAgentPlugin({ verbose: true })
  ] as const // Use 'as const' for better type inference
})

// Commands can access plugin store
cli.command({
  name: 'info',
  handler: async ({ context }) => {
    if (context?.env.isAIAgent) {
      console.log('Running in AI agent!')
      console.log(`Agents: ${context.store.aiAgents.join(', ')}`)
    }
  }
})

await cli.run()

cli.command({
  name: 'build',
  description: 'Build the project',
  handler: async () => {
    // Command implementation
  }
})

const manifest = {
  build: () => import('./commands/build.js'),
  test: () => import('./commands/test.js'),
  deploy: () => import('./commands/deploy.js')
}

await cli.load(manifest)

await cli.init()

// Use process arguments
await cli.run()

// Use custom arguments
await cli.run(['build', '--watch'])

$ my-cli --help
my-cli v1.0.0
My awesome CLI tool

Commands:
  hello                Say hello
  build                Build the project
  test                 Run tests

$ my-cli unknown
Unknown command: unknown