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

# PM2 managed
pm2 start alfred-ide

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

License

AGPL-3.0 — GoSiteMe Inc.