https://github.com/possibilities/claude-composer
https://github.com/possibilities/claude-composer
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/possibilities/claude-composer
- Owner: possibilities
- License: unlicense
- Created: 2025-05-28T13:05:16.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-07-31T02:29:50.000Z (2 months ago)
- Last Synced: 2025-07-31T05:30:00.711Z (2 months ago)
- Language: TypeScript
- Homepage:
- Size: 740 KB
- Stars: 654
- Watchers: 5
- Forks: 22
- Open Issues: 3
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
- awesome-claude-code - `Claude Composer`
README
# Claude Composer
---
**THIS REPO HAS GRADUATED. THAT MEANS THAT I WILL NO LONGER BE USING IT AND WISH ANYONE LUCK AND JOY IF THEY WANT TO FORK IT, CONTINUE USING IT, TAKE IT OVER, OR WHATEVER OTHER ACTIVITIES MAKE A PERSON HAPPY. GOING FORWARD I AM USING HOOKS TO ACHIEVE YOLO MODE:**
**https://github.com/possibilities/claude-code-generic-hooks**
**AND I USE PERMISSION MODES TO START IN PLAN MODE:**
**https://docs.anthropic.com/en/docs/claude-code/iam#permission-modes**
*
**ALSO USE `DIRTY-CONFIRM` TO GET THE SAME CONFIRMATIONS THAT `CLAUDE-COMPOSER` PROVIDES AROUND NON-GIT AND DIRTY GIT DIRECTORIES:**
https://github.com/possibilities/dirty-confirm
---
> A tool that adds small enhancements to Claude Code
[](https://github.com/possibilities/claude-composer/actions/workflows/test.yml)
## Features
- **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)
## Quick Start
```bash
# 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
```
## Installation
**Prerequisites**: Node.js 18+, npm/yarn/pnpm, Claude Code installed
```bash
# Global install
pnpm add -g claude-composer
# or
yarn global add claude-composer
# or
npm install -g claude-composer
```
## Command Line Options
### Core Options
```bash
# Configuration
--yolo # Accept all prompts automatically
--toolset # Use specified toolsets
--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](docs/cli-reference.md) for complete reference.
## Configuration
Run `claude-composer cc-init` to create configuration:
```bash
# Global config (default)
claude-composer cc-init
# Project-specific config
claude-composer cc-init --project
```
### Basic Configuration
```yaml
# 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](docs/configuration.md) for details.
## YOLO Mode
When enabled with `--yolo` flag or `yolo: true` in config, Claude Composer will automatically accept all prompts without confirmation. Use with caution!
## Toolsets
Configure which tools Claude can use and MCP server connections.
See [docs/toolsets.md](docs/toolsets.md) for details.
## Trusted roots
Use trusted roots to define trusted parent directories to auto-accept initial trust prompts.
See [docs/roots-config.md](docs/roots-config.md) for details.
## Environment Variables
See [docs/environment-variables.md](docs/environment-variables.md) for details.
## License
This project is in the public domain. See the [UNLICENSE](UNLICENSE) file for details.