# Shella

Self-hosted AI coding agents. Access from your phone.

Run multiple AI agents in parallel, persist sessions across devices, and manage everything from a touch-friendly mobile interface.

## Install

### npx (Developers)

```bash
# From your project directory
cd ~/myproject
npx @bytespell/shella
```

Opens at `http://localhost:3067`. Access from your phone using the LAN IP shown.

For multiple projects:

```bash
npx @bytespell/shella --projects-dir ~/code
```

### Docker (Homelab)

```yaml
# docker-compose.yml
services:
  shella:
    image: ghcr.io/bytespell/shella
    ports:
      - '3067:3067'
    volumes:
      - ~/code:/project
      - shella-data:/root/.config/shella
    command: ['--projects-dir', '/project']
    restart: unless-stopped

volumes:
  shella-data:
```

```bash
docker compose up -d
# Access at http://<server-ip>:3067
```

## Features

- **Parallel agents** - Run multiple agents on different tasks simultaneously
- **Session persistence** - Sessions survive restarts, pick up from any device
- **Cross-device sync** - Same windows, same state, real-time sync
- **Mobile-first** - Touch-optimized for iOS Safari

## CLI Options

```bash
shella                              # Start (registers current directory)
shella --projects-dir ~/code        # Register all subdirs of ~/code
shella --port 3000                  # Custom web port
shella --opencode-port 5000         # Custom OpenCode port
shella --no-open                    # Don't open browser
shella --help                       # Show help
```

## Development

```bash
# Install dependencies
npm install

# Start dev servers (Vite + Express + OpenCode)
npm run start:dev

# Build for production
npm run build

# Test production build locally
node bin/cli.js --no-open
```

## Requirements

- Node.js 20.19+ or 22.12+

## License

MIT
