Package Exports

@chara-codes/cli
@chara-codes/cli/dist/chara

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@chara-codes/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Chara CLI

A command-line interface tool for Chara Codes that facilitates AI-powered development workflow management.

Features

Development environment setup and configuration
Integration with Model Context Protocol (MCP) for AI context management
Project syncing between local and remote environments
Configuration management via .chara.json files
Seamless integration with web services via built-in server management

Installation

Stable Release (Latest)

# Install globally
npm install -g chara
# or
bun install -g chara

# Install locally in your project
npm install --save-dev chara
# or
bun add -d chara

Alpha Release (Playground)

For testing the latest features from the playground branch:

# Install globally
npm install -g chara@alpha
# or
bun install -g chara@alpha

# Install locally in your project
npm install --save-dev chara@alpha
# or
bun add -d chara@alpha

Note: Alpha releases are automatically published from the playground branch and may contain experimental features. Use stable releases for production environments.

Basic Usage

# Start development mode
chara dev

# Get help
chara --help

# Check version
chara --version

Configuration

Create a .chara.json file in your project root:

{
  "host": "localhost",
  "port": 3000,
  "dev": "bun dev",
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

Configuration Options

Option	Description	Default
`host`	Host to serve on	`"localhost"`
`port`	Port to serve on	`3000`
`dev`	Command to run for development	`"bun dev"`
`mcpServers`	Model Context Protocol server configurations	`{}`

Development

# Install dependencies
bun install

# Run in development mode
bun d

# Build the CLI
bun build

# Run the compiled version
./dist/chara

Model Context Protocol Integration

Chara CLI supports the Model Context Protocol for enhanced AI context awareness. Configure MCP servers in your .chara.json file to enable this feature.

Example usage:

# Start development with MCP context
chara dev

License

MIT License

This project is licensed under the MIT License - see the main LICENSE file for details.