# Quick Start Guide

Get Claude Vision Auto running in 5 minutes.

## Prerequisites Check

```bash
# Check Claude Code
claude --version

# Check Docker
docker ps

# Check Python
python3 --version
```

## Installation

```bash
cd /home/svrnty/claude-vision-auto

# Install system dependencies
sudo apt-get update && sudo apt-get install -y scrot

# Install Python package
make install
```

## Start Ollama (if not running)

```bash
# Check if running
docker ps | grep ollama

# If not running, start it
docker run -d \
    -p 11434:11434 \
    --name ollama \
    --restart unless-stopped \
    ollama/ollama:latest

# Pull vision model
docker exec ollama ollama pull minicpm-v:latest
```

## Test Installation

```bash
# Verify command
which claude-vision

# Test connection
claude-vision --help 2>&1 | head -5
```

## First Run

```bash
# Start interactive session
claude-vision

# You should see:
# [Claude Vision Auto] Testing Ollama connection...
# [Claude Vision Auto] Connected to Ollama
# [Claude Vision Auto] Using model: minicpm-v:latest
```

## Test Auto-Approval

```bash
# Try a simple command
claude-vision "create a test.md file in /tmp"

# Watch for auto-approval when prompted:
# [Vision] Analyzing prompt...
# [Vision] Response: 1
# [Vision] Response sent
```

## Troubleshooting

### Ollama Not Connected
```bash
docker start ollama
docker exec ollama ollama pull minicpm-v:latest
```

### Screenshot Fails
```bash
sudo apt-get install scrot
scrot /tmp/test.png  # Test it works
```

### Command Not Found
```bash
export PATH="$HOME/.local/bin:$PATH"
source ~/.bashrc
```

## Next Steps

- Read [README.md](README.md) for full documentation
- See [docs/USAGE.md](docs/USAGE.md) for usage examples
- Check [docs/INSTALLATION.md](docs/INSTALLATION.md) for detailed setup

## Quick Configuration

Add to `~/.bashrc`:

```bash
# Claude Vision Auto
export PATH="$HOME/.local/bin:$PATH"
alias cv="claude-vision"
alias cvd="DEBUG=true claude-vision"
```

Reload:

```bash
source ~/.bashrc
cv  # Now you can use 'cv' instead of 'claude-vision'
```

## Support

- Issues: https://git.openharbor.io/svrnty/claude-vision-auto/issues
- Documentation: See README.md and docs/
- Debug mode: `DEBUG=true claude-vision`