A tool that adds small enhancements to Claude Code
- Reduced interruptions: Automatic confirmation prompt acceptance
- Tool management: Toolsets configure which tools Claude can use
- Enhanced visibility: System notifications keep you informed (BROKEN, WILL GET BIG UPDATE SOON)
# Install
npm install -g claude-composer
# Initialize configuration
claude-composer cc-init
# Run with default settings
claude-composer
# Use YOLO mode (accept all prompts)
claude-composer --yolo
Prerequisites: Node.js 18+, npm/yarn/pnpm, Claude Code installed
# Global install
pnpm add -g claude-composer
# or
yarn global add claude-composer
# or
npm install -g claude-composer
# Configuration
--yolo # Accept all prompts automatically
--toolset <name...> # Use specified toolsets
--mode <mode> # Start in 'act' or 'plan' mode
--ignore-global-config # Ignore global config
# Safety
--dangerously-allow-in-dirty-directory
--dangerously-allow-without-version-control
--dangerously-suppress-yolo-confirmation
# Notifications
--show-notifications / --no-show-notifications
--sticky-notifications / --no-sticky-notifications
# Debug
--quiet # Suppress preflight messages
--allow-buffer-snapshots # Enable Ctrl+Shift+S snapshots
--log-all-pattern-matches # Log to ~/.claude-composer/logs/
All unrecognized options pass through to Claude Code.
See docs/cli-reference.md for complete reference.
Run claude-composer cc-init
to create configuration:
# Global config (default)
claude-composer cc-init
# Project-specific config
claude-composer cc-init --project
# config.yaml
yolo: false # Set to true to accept all prompts
toolsets:
- internal:core
- my-tools
roots:
- ~/projects/work
- ~/projects/personal
show_notifications: true
sticky_notifications: false
See docs/configuration.md for details.
When enabled with --yolo
flag or yolo: true
in config, Claude Composer will automatically accept all prompts without confirmation. Use with caution!
Configure which tools Claude can use and MCP server connections.
See docs/toolsets.md for details.
Use trusted roots to define trusted parent directories to auto-accept initial trust prompts.
See docs/roots-config.md for details.
See docs/environment-variables.md for details.