alfred-ide/README.md

# Alfred IDE

Cloud-native AI development environment built on code-server, with custom Commander extension, multi-provider AI chat, voice assistant, and sovereign infrastructure.

## Architecture

- **Base**: code-server 4.102.2 (VS Code for the web)
- **Extension**: Alfred Commander (3,551-line extension.js) — AI chat, stats, voice, walkthrough
- **Auth**: Cookie-based gating via Apache + PHP, PIN/email login
- **MCP**: 500+ tools via gocodeme-mcp service (port 3006)
- **Branding**: Patched workbench.js + NLS message files

## Components

| Component | Location | Purpose |
|-----------|----------|---------|
| `start.sh` | Server start script | Launches code-server with config |
| `config.yaml` | code-server config | Port 8443, auth:none (Apache handles auth) |
| `branding-patches.sh` | Branding automation | Patches "code-server" → "Alfred IDE" |
| Commander extension | `extensions/gositeme.alfred-commander-1.0.1/` | Full IDE UX |

## Auth Flow

1. User visits `gositeme.com/alfred-ide/`
2. Apache checks for `alfred_ide_token` cookie
3. Missing → redirect to `alfred-ide-auth.php`
4. Login via PIN (Commander) or email/password
5. Session created in DB, cookie set → proxy to code-server

## Running

```bash
# PM2 managed
pm2 start alfred-ide

# Manual
./start.sh
# → http://127.0.0.1:8443
```

## License

AGPL-3.0 — GoSiteMe Inc.