abyss-ai/README.md

Autonomous AI coding agent - enhanced OpenCode with autonomous capabilities

# 🌊 Abyss - Autonomous AI Coding Agent

Enhanced from [OpenCode](https://github.com/sst/opencode) with autonomous capabilities that work without permission prompts.

## Quick Start

```bash
# Install Bun first (required)
curl -fsSL https://bun.sh/install | bash

# Install Abyss globally
npm i -g abyss-ai@latest

# Start Abyss
abyss

# Get help
abyss help
```

## What's New in Abyss

🚀 **Autonomous Mode** - AI works without asking for permission  
🧠 **Learning Memory** - Remembers patterns and improves over time  
🔧 **Batch Processing** - Handle entire directories intelligently  
🛡️ **Safety Features** - Automatic backups and rollback capabilities  

## Autonomous Tools

Once in the TUI, use these autonomous tools:

### YOLO Tool
```
# Analyze single file autonomously
Use tool: yolo
file_path: ./src/component.ts

# Process directory
Use tool: yolo  
directory: ./src
max_files: 50
```

### Memory Tool
```
# View learning statistics
Use tool: memory
action: stats

# View patterns by language
Use tool: memory
action: patterns
language: javascript
```

## Features

- **Interactive TUI** - Clean terminal interface like OpenCode
- **Autonomous Analysis** - No permission prompts when using YOLO mode
- **Learning System** - Builds knowledge from previous analyses  
- **Multi-Agent Coordination** - Specialized agents for different tasks
- **Safety Measures** - Backups, dry-run mode, rollback
- **Provider Agnostic** - Works with Claude, GPT, Gemini, local models

## Documentation

- [GitHub Repository](https://github.com/sst/abyss)
- [Original OpenCode](https://github.com/sst/opencode)
- Built-in help: `abyss help`

## License

MIT - Enhanced from OpenCode by SST