autoclaude/README.md

# Autoclaude

Autonomous multi-agent control system for Claude Code sessions.

## Quick Start

### Installation

```bash
cd autoclaude
pip install -e .
```

### Basic Usage

Install keyboard shortcut (one-time setup):
```bash
autoclaude --install-shortcut
```
This configures `Ctrl+A+A` to toggle automation for the current pane.

List Claude Code sessions:
```bash
autoclaude list
```

Start autonomous monitoring:
```bash
autoclaude start main 8
```

Toggle automation for active pane:
```bash
autoclaude start toggle
# Or use keyboard shortcut: Ctrl+A+A
```

Check status:
```bash
autoclaude status
```

View logs:
```bash
autoclaude logs
```

## Features

- Automatic Claude Code session detection
- Autonomous prompt handling and approval
- Multi-agent orchestration architecture
- Real-time session monitoring
- Command-line interface for complete control
- Configuration-driven behavior
- Keyboard shortcut for quick automation toggle (Ctrl+A+A)
- One-command setup with `--install-shortcut`
- Session and window identification in prompt
- Visual status display in tmux status bar

## System Requirements

- Python 3.7 or higher
- tmux (any recent version)
- POSIX-compatible operating system

## Documentation

Complete documentation available in autocode.md

See autocode.md for:
- Detailed architecture
- Complete CLI reference
- Configuration guide
- Development guidelines
- Troubleshooting

## Author

Retoor (retoor@molodetz.nl)

## License

MIT