# Composer CLI

Autonomous coding agent right in your terminal - powered by Claude, GPT, and other leading AI models.

## Quick Start

```bash
# Install globally
npm install -g @stat-guy/composer

# Run composer
composer
```

## What is Composer?

Composer is an advanced AI-powered coding assistant that can:

- **Write and edit code** in any programming language
- **Execute terminal commands** with your permission
- **Navigate and understand** your codebase
- **Use modern AI models** (Claude, GPT-5, O1, and more)
- **Work with tools** via Model Context Protocol (MCP)
- **Review code** with professional-grade analysis

## Features

- 🤖 **Advanced AI Integration** - GPT-5, Claude, O1, and 30+ other models
- 🔧 **Tool Ecosystem** - Extensible via Model Context Protocol (MCP)
- 📝 **Code Generation** - Write, edit, and refactor code autonomously
- 🔍 **Review Mode** - Professional code review capabilities
- 🌐 **Web Access** - Browse and interact with web content
- 🔒 **Secure** - You approve every action before execution
- 🏗️ **Multi-workspace** - Handle complex, multi-root projects
- ⚡ **Fast** - Native Rust implementation for speed

## Usage Examples

```bash
# Start an interactive session
composer

# Execute a specific task
composer exec "Add error handling to my Python script"

# Review current changes
composer review

# Get help
composer --help
```

## Requirements

- Node.js 20+ (for the wrapper script)
- macOS (Intel or Apple Silicon)
- Linux and Windows support coming soon

## Configuration

Composer supports extensive configuration options. Run `composer --help` for details on:

- API keys for various AI providers
- Model selection and parameters
- Tool and MCP server integration
- Advanced workflow settings

## Links

- **GitHub**: https://github.com/stat-guy/composer
- **Issues**: https://github.com/stat-guy/composer/issues
- **Documentation**: Full docs coming soon

## License

Apache-2.0