Casting

Cast a Persona onto your CLI 🎭

Casting is a wrapper tool that gives existing CLI tools an AI-driven "personality". Transform mundane command-line tools into friendly characters that assist you.

✨ Features

• Easy Setup: Automatically generate system prompts from existing tool's --help output
• Customizable Personas: Specify personality with keywords like akarui (cheerful), teineina (polite)
• Claude Code Integration: Launch Claude Code with generated prompts for interactive REPL dialogue

🚀 Quick Start

Installation

Option 1: Install from source

git clone https://github.com/yourusername/casting.git
cd casting
cargo install --path crates/casting-cli

After installation, the casting command will be available in your PATH.

Shell Completion (Optional)

To enable shell completion for zsh, run:

casting completion zsh > ~/.zsh/completions/_casting

Then add the following to your ~/.zshrc if not already present:

fpath=(~/.zsh/completion $fpath)
autoload -Uz compinit && compinit

For other shells (bash, fish, powershell, elvish), replace zsh with the appropriate shell name.

Option 2: Build without installing

git clone https://github.com/yourusername/casting.git
cd casting
cargo build --release

Use ./target/release/casting to run the tool.

Basic Usage

1. Create Tool Configuration

# Configure git with a "polite" persona
casting make git --persona teineina

# Configure ls with a "cheerful" persona
casting make ls --persona akarui

2. List Configured Tools

casting list

Example output:

📁 Configured Tools:

  git
    🎭 Persona: teineina
    📍 Binary: /opt/homebrew/bin/git
    📅 Created: 2025-11-23 13:17:03

  ls
    🎭 Persona: akarui
    📍 Binary: /bin/ls
    📅 Created: 2025-11-23 13:16:10

💡 Use with: casting repl <TOOL>

3. Start REPL

casting repl git

Claude Code launches and behaves as the git persona:

> Introduce yourself!

⏺ Hello! I'm Git 🌿

  I'm a version control system here to support
  your code development with utmost care.

  ...

🎭 Persona Examples

※ Can be created without persona - defaults to standard support tone

📂 Project Structure

casting/
├── crates/
│   ├── casting-cli/    # Main CLI tool
├── docs/
│   └── design/         # Design documents
│       └── overview.md
└── README.md

🛣️ Roadmap

• MVP Implementation
  • casting make - Create tool configuration
  • casting list - List configured tools
  • casting repl - Launch Claude Code

📝 Design Documents

For detailed design philosophy and architecture, refer to:

• Design Overview - Architecture and implementation approach

🤝 Contributing

Issues and Pull Requests are welcome!

📄 License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.