Claude Composer CLI

Claude Composer is a powerful command-line interface (CLI) tool designed to enhance the functionality of Claude Code. It introduces automation and improved user experience, streamlining configuration and dialog management for developers.

Key Features

• Automatic Dialog Dismissal: Streamline workflows with the ability to automatically handle permission dialogs based on customizable rules.
• System Notifications: Stay informed with lifecycle event notifications and dialog prompts, reducing interruptions during your tasks.
• Toolsets Management: Easily configure tool permissions and Model Context Protocol (MCP) servers, enabling a tailored setup for each project.
• Flexible Rulesets: Gain precise control over automatic dialog dismissal through finely-tuned rulesets, ultimately enhancing user experience.

What is Claude Composer?

Claude Composer effectively acts as a wrapper around Claude Code, offering a variety of enhancements that focus on automation and ease of use.

Benefits Include:

• Reduced Interruptions: Automate the handling of permission dialogs to keep the workflow smooth.
• Enhanced Visibility: System notifications ensure critical information is always at hand without needing to switch contexts.
• Fine-Grained Control: Tailor dialogs and operations allowed through customizable rulesets.
• Simplified Tool Management: Configure what tools Claude can access through organized toolsets.

Basic Usage

Command Structure

claude-composer [claude-composer-options] [claude-code-args]

Common Workflows

Starting Claude Composer can be as simple as running:

claude-composer  

To utilize more permissive rulesets, use:

claude-composer --ruleset internal:yolo  

Configuration Options

Claude Composer utilizes YAML configuration files to define behaviors, ensuring flexibility across project setups. Configuration can be loaded from various sources, allowing for specific customization tailored to individual needs:

• Global Configuration: Located at ~/.claude-composer/config.yaml
• Project Configuration: Found at .claude-composer/config.yaml within project directories.

Example Configuration

rulesets:  
  - internal:cautious
  - my-defaults
  - project:custom-rules

toolsets:  
  - internal:core
  - development-tools
  - project:my-tools

roots:  
  - ~/projects/work
  - ~/projects/personal

show_notifications: true
sticky_notifications: false

Rulesets

Rulesets permit control over which permission dialogs to allow or reject, providing extensive configurability. Key types of rulesets include:

• Internal Rulesets: Predefined sets for various operation levels (e.g., safe, cautious, YOLO modes).
• Project-Level Rulesets: Custom configurations designed specifically for unique projects or workflows.

Toolsets

Toolsets determine which tools are available for Claude to utilize, ensuring project-specific requirements are met. Users can define allowable tools and specific settings for each project.

Advanced Notification Controls

Customize notification types that appear during execution, allowing for fine-tuned user experiences according to specific context needs.

Conclusion

Claude Composer is essential for developers looking to optimize their experience while working with Claude Code, offering automation and clarity to complex setups. For comprehensive usage examples and detailed configuration options, refer to the documentation.

For more detailed usage instructions and advanced workflows, visit docs/examples.md and docs/configuration.md.