@soccagency/sh 0.2.0 → 0.2.1

package/README.md

@@ -1,242 +1,108 @@
 # Socc CLI
 
-CLI para subir proyectos a Socc y obtener preview links instantáneos.
+CLI for publishing instant preview links with Socc.
 
-## 🛠️ Stack
-
-- **Runtime:** Node.js 20+
-- **Package:** npm
-- **Comprimiendo:** archiver
-- **HTTP:** undici (fetch nativo)
-
-## 📋 Requisitos
+## Requirements
 
 - Node.js 20+
-- npm o yarn
-- Token de Socc (obtenido desde sh.socc.ink)
+- npm account + API token from `https://sh.socc.ink`
 
-## 🚀 Instalación
+## Install
 
-### Desde npm (cuando esté publicado)
+### From npm (public package)
 
 ```bash
-npm install -g @socc/sh
+npm i -g @soccagency/sh
 ```
 
-### Desde código fuente
+### From source (local development)
 
 ```bash
-# Clonar o navegar al directorio del CLI
 cd /home/clawdbot/projects/socc/cli
-
-# Instalar dependencias
 npm install
-
-# Instalar globalmente (desarrollo)
 npm install -g .
 ```
 
-## 🔧 Comandos
-
-### `socc login <token>`
-
-Inicia sesión con tu API token.
+## Quickstart
 
 ```bash
-socc login socc_cw5MIU0haehbgAJma3vw4pXUqENHu8vj
-```
+# 1) Authenticate once
+socc login socc_xxxxx
 
-**Obtener tu token:**
-
-1. Andá a https://sh.socc.ink
-2. Logueate con GitHub
-3. Click en tu avatar → Settings
-4. Click en "Generar API Token"
-5. Copiá el token
-
-### `socc link [--ttl <horas>] [--framework <name>]`
-
-Sube tu proyecto actual y crea un preview link.
-
-```bash
-cd mi-proyecto
+# 2) Deploy from your project folder
 socc link
-socc link --ttl 1
-socc link --framework vite
-```
-
-**Output:**
-```
-🚀 Socc - Deploy instantáneo
-
-🔐 Verificando tu cuenta...
-✅ Autenticado como: tu@email.com
-📊 Plan: FREE
-📈 Deployments activos: 0/1
-📅 Deployments hoy: 0/5
-📦 Framework usado: static
-⏰ TTL solicitado: 1 hora(s)
-📦 Comprimiendo archivos...
-✅ Archivos comprimidos
-📤 Subiendo a Socc...
-✅ Uploaded emqg9i7y/deploy.zip to R2 (0.00 MB)
-✅ Extracted 3 files to R2
-
-✅ ¡Deploy exitoso!
-
-🚀 Tu preview está en: https://emqg9i7y.socc.ink
-⏰ Expira en: 6 horas
-```
 
-### `socc list`
+# 3) Optional: set TTL and framework explicitly
+socc link --ttl 1 --framework vite
 
-Lista tus deployments activos.
-
-```bash
+# 4) List and delete previews
 socc list
+socc delete <deployment-id>
 ```
 
-**Output:**
-```
-📋 Obteniendo tus deployments...
+## Commands
 
-📦 Tus deployments (2):
+- `socc login <token>`: Save API token locally.
+- `socc logout`: Remove saved API token.
+- `socc whoami`: Show account plan and usage limits.
+- `socc link [--ttl <hours>] [--framework <name>]`: Build, package, and deploy.
+- `socc list`: List active deployments.
+- `socc delete <id>`: Hard-delete a deployment.
+- `socc help`: Show command help.
 
-  1. 🟢 emqg9i7y
-     URL: https://emqg9i7y.socc.ink
-     Framework: static
-     Tamaño: 0.01 MB
-     Expira en: 5h
+## Link Options
 
-  2. 🟢 xQ39GogI
-     URL: https://xQ39GogI.socc.ink
-     Framework: react
-     Tamaño: 1.23 MB
-     Expira en: 23h
-```
+- `--ttl <hours>`: Positive integer in hours. Default is `6`.
+- `--framework <name>`: `auto|vite|react|next|angular|nuxt|astro|static`.
 
-### `socc delete <id>`
+If you do not pass `--framework`, detection runs automatically.
 
-Elimina un deployment.
+## Auto Detection
 
-```bash
-socc delete emqg9i7y
-```
+The CLI detects:
 
-**Output:**
-```
-🗑️  Borrando deployment emqg9i7y...
-✅ Deployment emqg9i7y eliminado.
-```
+- Framework: `vite`, `react`, `next`, `angular`, `nuxt`, `astro`, `static`, or custom build script.
+- Package manager: `npm`, `yarn`, `pnpm`, or `bun` (by lockfile).
 
-### `socc whoami`
+### Next.js note
 
-Muestra información de tu cuenta.
+Socc requires static export output (`out/`) for Next.js.
 
-```bash
-socc whoami
-```
+Set this in `next.config.js`:
 
-**Output:**
-```
-👤 Usuario: tu@email.com
-📊 Plan: FREE
-📈 Deployments activos: 0/1
-📅 Deployments hoy: 2/5
-📦 Total links: 15
+```js
+export default {
+  output: 'export'
+};
 ```
 
-## 📦 Frameworks Detectados
-
-La CLI detecta automáticamente el framework y configura el build.
-También detecta package manager (`npm`, `yarn`, `pnpm`, `bun`) por lockfile:
+Then run `socc link` again.
 
-| Framework | Detecta | Build | Output |
-|-----------|---------|-------|--------|
-| **Vite** | `vite.config.js` | `npm run build` | `dist/` |
-| **React (CRA)** | `package.json` + react-scripts | `npm run build` | `build/` |
-| **Next.js** | `next.config.js` | `npm run build` | `out/` (static) |
-| **Angular** | `angular.json` | `ng build` | `dist/` |
-| **Astro** | `astro.config.*` o dependencia `astro` | `build` | `dist/` |
-| **Static** | Por defecto | - | `.` |
-| **Custom build** | `scripts.build` sin framework conocido | `build` | `dist/`, `build/` u `out/` |
+## Environment Variable
 
-Frameworks válidos para `--framework`:
-
-`auto`, `vite`, `react`, `next`, `angular`, `nuxt`, `static`
-
-> Para Next.js, Socc exige export estático (`out/`).  
-> Configurá `output: "export"` en `next.config.js`.
-
-## 🔍 Cómo funciona
-
-1. **Detecta el framework** buscando archivos de configuración
-2. **Ejecuta el build** si es necesario
-3. **Comprime** el output en un ZIP
-4. **Envía** el ZIP a la API (`POST /api/link`)
-5. **API** extrae y sube archivos a R2
-6. **Recibe** la URL del preview
-
-## 🐛 Troubleshooting
-
-### Error: "No estás autenticado"
+You can override the API URL:
 
 ```bash
-socc login <tu-token>
+SOCC_API_URL=http://localhost:3000 socc whoami
 ```
 
-### Error: "Token inválido o expirado"
-
-- El token puede haber sido revocado
-- Generá uno nuevo en Settings
-
-### Error: "Llegaste al límite diario"
-
-- Tu plan tiene un límite de links por día
-- Esperá al próximo día o actualizá tu plan
-
-### Error: "Build fallido"
-
-- Verificá que el proyecto compila localmente
-- Revisá que tenés las dependencias instaladas
-
-### Error: "File too large"
-
-- Tu plan tiene un límite de upload
-- Free: 10 MB, Starter: 50 MB, Pro: 100 MB
+Default: `https://api.socc.ink`
 
-## 📝 Configuración
+## Auth Storage
 
-El CLI guarda tu token en:
-
-```
-~/.socc/config.json
-```
-
-Contenido:
-```json
-{
-  "token": "socc_cw5MIU0haehbgAJma3vw4pXUqENHu8vj"
-}
-```
-
-También podés cambiar la API con variable de entorno:
+Token is saved in:
 
 ```bash
-SOCC_API_URL=http://localhost:3000 socc whoami
+~/.socc/config.json
 ```
 
-## 🚀 Publicar en npm
-
-```bash
-# Publicar versión actual (ej: 0.2.0)
-npm whoami
-npm publish
-
-# Verificar paquete antes de publicar
-npm run pack:check
-```
+- Switch account: run `socc login <new-token>` (replaces current token).
+- Logout: run `socc logout`.
 
----
+## Troubleshooting
 
-[Volver al README principal](../README.md)
+- `You are not authenticated`: run `socc login <token>`.
+- `Token is invalid or expired`: generate a new token in `https://sh.socc.ink`.
+- `Daily deployment limit reached`: wait for reset or upgrade plan.
+- `Build failed`: verify local build command works before running `socc link`.
+- `Output directory not found`: set framework explicitly or fix build output path.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soccagency/sh",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Instant preview links for your projects",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -21,7 +21,7 @@ const FRAMEWORK_CONFIGS = {
   static: { name: 'static', buildScript: null, distCandidates: ['dist', '.'] }
 };
 
-// Colores
+// Colors
 const colors = {
   reset: '\x1b[0m',
   red: '\x1b[31m',
@@ -37,39 +37,40 @@ function log(msg, color = 'reset') {
   console.log(`${colors[color]}${msg}${colors.reset}`);
 }
 
-// ============= COMANDOS =============
+// ============= COMMANDS =============
 
 function showHelp() {
   log(`
-🚀 Socc CLI - Deploy instantáneo
-
-Uso:
-  socc                                Mostrar esta ayuda
-  socc link [--ttl <horas>] [--framework <${ALLOWED_FRAMEWORKS.join('|')}>]
-  socc list                           Listar tus deployments
-  socc delete <id>                    Borrar un deployment
-  socc login <token>                  Iniciar sesión con API token
-  socc whoami                         Ver info de tu cuenta
-  socc help                           Mostrar esta ayuda
-
-Flags de socc link:
-  --ttl <horas>        TTL en horas (entero positivo, por defecto 6)
-  --framework <name>   Fuerza framework: auto|vite|react|next|angular|nuxt|astro|static
-
-Variables de entorno:
+🚀 Socc CLI - Instant Deploy
+
+Usage:
+  socc                                Show help
+  socc link [--ttl <hours>] [--framework <${ALLOWED_FRAMEWORKS.join('|')}>]
+  socc list                           List deployments
+  socc delete <id>                    Delete deployment
+  socc login <token>                  Authenticate with API token
+  socc logout                         Remove saved API token
+  socc whoami                         Show account info
+  socc help                           Show help
+
+Link flags:
+  --ttl <hours>        TTL in hours (positive integer, default 6)
+  --framework <name>   Force framework: auto|vite|react|next|angular|nuxt|astro|static
+
+Environment variables:
   SOCC_API_URL         API base URL (default: https://api.socc.ink)
 
-Ejemplos:
+Examples:
   $ socc login socc_abcdef123...
   $ socc link --ttl 1
   $ socc link --framework vite
   $ SOCC_API_URL=http://localhost:3000 socc whoami
 
-Planes:
-  Free       - 1 deployment activo, 5/día, 10MB max
-  Starter    - 5 deployments activos, 50/día, 50MB max
-  Pro        - 20 deployments activos, 200/día, 100MB max
-  Enterprise - Ilimitado
+Plans:
+  Free       - 1 active deployment, 5/day, 10MB max
+  Starter    - 5 active deployments, 50/day, 50MB max
+  Pro        - 20 active deployments, 200/day, 100MB max
+  Enterprise - Unlimited
 `, 'cyan');
 }
 
@@ -78,24 +79,24 @@ async function cmdLogin(args) {
 
   if (!token) {
     log('\n🔐 Socc Login\n', 'cyan');
-    log('Uso: socc login <tu-api-token>\n', 'white');
-    log('📋 Cómo obtener tu API token:', 'yellow');
-    log('1. Andá a https://sh.socc.ink y logueate con GitHub', 'yellow');
-    log('2. Hacé click en tu avatar → Settings', 'yellow');
-    log('3. Click en "Generar API Token"', 'yellow');
-    log('4. Copiá el token y ejecutá: socc login socc_xxxxx\n', 'yellow');
+    log('Usage: socc login <your-api-token>\n', 'white');
+    log('📋 How to get your API token:', 'yellow');
+    log('1. Go to https://sh.socc.ink and sign in with GitHub', 'yellow');
+    log('2. Open your account settings', 'yellow');
+    log('3. Click "Generate API token"', 'yellow');
+    log('4. Copy the token and run: socc login socc_xxxxx\n', 'yellow');
     process.exit(0);
   }
 
-  log('🔐 Verificando token...', 'yellow');
+  log('🔐 Verifying token...', 'yellow');
   const userInfo = await getUserInfo(token);
 
   if (!userInfo.success) {
-    log(`❌ Token inválido: ${userInfo.error}`, 'red');
+    log(`❌ Invalid token: ${userInfo.error}`, 'red');
     process.exit(1);
   }
 
-  // Guardar token
+  // Save token
   const configDir = join(process.env.HOME, '.socc');
   const configPath = join(configDir, 'config.json');
 
@@ -105,17 +106,17 @@ async function cmdLogin(args) {
 
   writeFileSync(configPath, JSON.stringify({ token }, null, 2));
 
-  log('✅ ¡Login exitoso!', 'green');
-  log(`\n👤 Autenticado como: ${userInfo.user.email}`, 'white');
-  log(`📊 Plan: ${userInfo.user.tier.toUpperCase()}`, 'blue');
-  log('\n🚀 Ahora podés usar: socc link\n', 'cyan');
+  log('✅ Login successful!', 'green');
+  log(`\n👤 Authenticated as: ${userInfo.user.email}`, 'white');
+  log(`📊 Tier: ${userInfo.user.tier.toUpperCase()}`, 'blue');
+  log('\n🚀 You can now run: socc link\n', 'cyan');
 }
 
 async function cmdWhoami() {
   const token = getToken();
 
   if (!token) {
-    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
+    log('❌ You are not authenticated. Run `socc login` first.', 'red');
     process.exit(1);
   }
 
@@ -128,13 +129,13 @@ async function cmdWhoami() {
 
   const { user, usage } = userInfo;
 
-  log('\n👤 Tu cuenta Socc\n', 'cyan');
+  log('\n👤 Your Socc account\n', 'cyan');
   log(`Email: ${user.email}`, 'white');
-  log(`Plan: ${user.tier.toUpperCase()}`, 'blue');
-  log(`Estado: ${user.subscriptionStatus || 'active'}`, 'green');
-  log('\n📊 Uso:', 'yellow');
-  log(`  Deployments activos: ${usage.activeDeployments}/${usage.maxActiveDeployments}`, 'white');
-  log(`  Deployments hoy: ${usage.linksToday}/${usage.linksLimit}`, 'white');
+  log(`Tier: ${user.tier.toUpperCase()}`, 'blue');
+  log(`Status: ${user.subscriptionStatus || 'active'}`, 'green');
+  log('\n📊 Usage:', 'yellow');
+  log(`  Active deployments: ${usage.activeDeployments}/${usage.maxActiveDeployments}`, 'white');
+  log(`  Deployments today: ${usage.linksToday}/${usage.linksLimit}`, 'white');
   log(`  Max upload: ${usage.maxUpload}`, 'white');
   log(`  Max TTL: ${usage.maxTtl}`, 'white');
   log(`\n📈 Total deployments: ${usage.totalLinks}\n`, 'gray');
@@ -144,11 +145,11 @@ async function cmdList() {
   const token = getToken();
 
   if (!token) {
-    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
+    log('❌ You are not authenticated. Run `socc login` first.', 'red');
     process.exit(1);
   }
 
-  log('📋 Obteniendo tus deployments...', 'yellow');
+  log('📋 Fetching your deployments...', 'yellow');
 
   try {
     const response = await fetch(`${API_URL}/api/list`, {
@@ -163,12 +164,12 @@ async function cmdList() {
     }
 
     if (data.deployments.length === 0) {
-      log('\n📭 No tenés deployments activos.', 'gray');
-      log('Creá tu primer deploy con: socc link\n', 'cyan');
+      log('\n📭 No active deployments found.', 'gray');
+      log('Create your first deploy with: socc link\n', 'cyan');
       return;
     }
 
-    log('\n📦 Tus deployments:', 'cyan');
+    log('\n📦 Your deployments:', 'cyan');
 
     data.deployments.forEach((d, i) => {
       const expires = new Date(d.expiresAt);
@@ -183,8 +184,8 @@ async function cmdList() {
       console.log(`  ${i + 1}. ${status} ${id}`);
       console.log(`     URL: https://${subdomain}.socc.ink`);
       console.log(`     Framework: ${framework}`);
-      console.log(`     Tamaño: ${sizeMB} MB`);
-      console.log(`     Expira en: ${hoursLeft > 0 ? `${hoursLeft}h` : 'EXPIRADO'}`);
+      console.log(`     Size: ${sizeMB} MB`);
+      console.log(`     Expires in: ${hoursLeft > 0 ? `${hoursLeft}h` : 'EXPIRED'}`);
       console.log('');
     });
 
@@ -198,20 +199,20 @@ async function cmdDelete(args) {
   const projectId = args[0];
 
   if (!projectId) {
-    log('\n❌ Debes especificar un ID de deployment', 'red');
-    log('\nUso: socc delete <project-id>\n', 'yellow');
-    log('Obtené el ID con: socc list\n', 'cyan');
+    log('\n❌ You must provide a deployment ID.', 'red');
+    log('\nUsage: socc delete <project-id>\n', 'yellow');
+    log('Get the ID with: socc list\n', 'cyan');
     process.exit(1);
   }
 
   const token = getToken();
 
   if (!token) {
-    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
+    log('❌ You are not authenticated. Run `socc login` first.', 'red');
     process.exit(1);
   }
 
-  log(`🗑️  Borrando deployment ${projectId}...`, 'yellow');
+  log(`🗑️  Deleting deployment ${projectId}...`, 'yellow');
 
   try {
     const response = await fetch(`${API_URL}/api/delete/${projectId}`, {
@@ -226,7 +227,7 @@ async function cmdDelete(args) {
       process.exit(1);
     }
 
-    log(`✅ Deployment ${projectId} eliminado.\n`, 'green');
+    log(`✅ Deployment ${projectId} deleted.\n`, 'green');
 
   } catch (error) {
     log(`❌ Error: ${error.message}`, 'red');
@@ -239,24 +240,24 @@ async function cmdLink(args) {
 
   if (!parsedOptions.ok) {
     log(`❌ ${parsedOptions.error}`, 'red');
-    log(`\nUso: socc link [--ttl <horas>] [--framework <${ALLOWED_FRAMEWORKS.join('|')}>]\n`, 'yellow');
+    log(`\nUsage: socc link [--ttl <hours>] [--framework <${ALLOWED_FRAMEWORKS.join('|')}>]\n`, 'yellow');
     process.exit(1);
   }
 
   const options = parsedOptions.options;
 
-  log('🚀 Socc - Deploy instantáneo\n', 'cyan');
+  log('🚀 Socc - Instant deploy\n', 'cyan');
 
   const token = getToken();
 
   if (!token) {
-    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
-    log('\nPara loguearte: socc login socc_xxxxx\n', 'cyan');
+    log('❌ You are not authenticated. Run `socc login` first.', 'red');
+    log('\nTo authenticate: socc login socc_xxxxx\n', 'cyan');
     process.exit(1);
   }
 
-  // Verificar límites
-  log('🔐 Verificando tu cuenta...', 'yellow');
+  // Check limits
+  log('🔐 Checking account...', 'yellow');
   const userInfo = await getUserInfo(token);
 
   if (!userInfo.success) {
@@ -266,42 +267,42 @@ async function cmdLink(args) {
 
   const { user, usage, canCreateLink } = userInfo;
 
-  log(`✅ Autenticado como: ${user.email}`, 'green');
-  log(`📊 Plan: ${user.tier.toUpperCase()}`, 'blue');
-  log(`📈 Deployments activos: ${usage.activeDeployments}/${usage.maxActiveDeployments}`, 'blue');
-  log(`📅 Deployments hoy: ${usage.linksToday}/${usage.linksLimit}`, 'blue');
+  log(`✅ Authenticated as: ${user.email}`, 'green');
+  log(`📊 Tier: ${user.tier.toUpperCase()}`, 'blue');
+  log(`📈 Active deployments: ${usage.activeDeployments}/${usage.maxActiveDeployments}`, 'blue');
+  log(`📅 Deployments today: ${usage.linksToday}/${usage.linksLimit}`, 'blue');
 
   if (!canCreateLink) {
-    log('\n❌ Llegaste al límite diario de deployments.', 'red');
-    log(`Tu plan (${user.tier}) permite ${usage.linksLimit} deployments por día.`, 'yellow');
-    log('Volvé mañana o actualizá tu plan.\n', 'yellow');
+    log('\n❌ Daily deployment limit reached.', 'red');
+    log(`Your ${user.tier} plan allows ${usage.linksLimit} deployments per day.`, 'yellow');
+    log('Try again tomorrow or upgrade your plan.\n', 'yellow');
     process.exit(1);
   }
 
   if (usage.activeDeployments >= usage.maxActiveDeployments && usage.maxActiveDeployments !== 'unlimited') {
-    log('\n❌ Llegaste al máximo de deployments activos.', 'red');
-    log(`Tu plan (${user.tier}) permite ${usage.maxActiveDeployments} deployments activos.`, 'yellow');
-    log('Eliminá previews viejos con: socc delete <id>', 'yellow');
-    log('O actualizá tu plan.\n', 'yellow');
+    log('\n❌ Maximum active deployments reached.', 'red');
+    log(`Your ${user.tier} plan allows ${usage.maxActiveDeployments} active deployments.`, 'yellow');
+    log('Delete old previews with: socc delete <id>', 'yellow');
+    log('Or upgrade your plan.\n', 'yellow');
     process.exit(1);
   }
 
-  // Detectar framework
+  // Detect framework
   const framework = detectFramework(options.framework);
   const packageManager = detectPackageManager();
-  log(`📦 Framework usado: ${framework.name}`, 'blue');
-  log(`📦 Package manager detectado: ${packageManager}`, 'blue');
-  log(`⏰ TTL solicitado: ${options.ttl} hora(s)`, 'blue');
+  log(`📦 Framework: ${framework.name}`, 'blue');
+  log(`📦 Package manager: ${packageManager}`, 'blue');
+  log(`⏰ Requested TTL: ${options.ttl} hour(s)`, 'blue');
 
   // Build
   if (framework.buildScript) {
     const buildCommand = buildCommandForScript(packageManager, framework.buildScript);
-    log(`🔨 Construyendo proyecto (${buildCommand})...`, 'yellow');
+    log(`🔨 Building project (${buildCommand})...`, 'yellow');
     try {
       execSync(buildCommand, { stdio: 'inherit' });
-      log('✅ Build completado', 'green');
+      log('✅ Build completed', 'green');
     } catch {
-      log('❌ Build fallido', 'red');
+      log('❌ Build failed', 'red');
       process.exit(1);
     }
   }
@@ -314,13 +315,13 @@ async function cmdLink(args) {
     process.exit(1);
   }
 
-  // Comprimir
-  log('📦 Comprimiendo archivos...', 'yellow');
+  // Compress files
+  log('📦 Compressing files...', 'yellow');
   const zipPath = await zipDirectory(distPath);
-  log('✅ Archivos comprimidos', 'green');
+  log('✅ Files compressed', 'green');
 
   // Upload
-  log('📤 Subiendo a Socc...', 'yellow');
+  log('📤 Uploading to Socc...', 'yellow');
   try {
     const result = await uploadToApi(zipPath, token, {
       ttl: options.ttl,
@@ -328,11 +329,11 @@ async function cmdLink(args) {
     });
 
     if (result.success && result.url) {
-      log('\n✅ ¡Deploy exitoso!', 'green');
-      log(`\n🚀 Tu preview está en: ${result.url}\n`, 'cyan');
-      log(`⏰ Expira en: ${result.ttl} horas\n`, 'blue');
+      log('\n✅ Deploy successful!', 'green');
+      log(`\n🚀 Your preview is live at: ${result.url}\n`, 'cyan');
+      log(`⏰ Expires in: ${result.ttl} hour(s)\n`, 'blue');
     } else {
-      log('❌ Error en el deploy', 'red');
+      log('❌ Deployment failed', 'red');
       if (result.error) {
         log(result.error, 'red');
       }
@@ -343,7 +344,7 @@ async function cmdLink(args) {
     process.exit(1);
   }
 
-  // Limpiar
+  // Cleanup
   try {
     unlinkSync(zipPath);
   } catch {
@@ -351,6 +352,23 @@ async function cmdLink(args) {
   }
 }
 
+function cmdLogout() {
+  const configPath = join(process.env.HOME, '.socc', 'config.json');
+
+  if (!existsSync(configPath)) {
+    log('ℹ️ No active session found.', 'yellow');
+    return;
+  }
+
+  try {
+    unlinkSync(configPath);
+    log('✅ Logged out successfully.\n', 'green');
+  } catch (error) {
+    log(`❌ Failed to logout: ${error.message}`, 'red');
+    process.exit(1);
+  }
+}
+
 // ============= HELPERS =============
 
 function getToken() {
@@ -374,13 +392,13 @@ async function getUserInfo(token) {
     });
 
     if (response.status === 401) {
-      return { success: false, error: 'Token inválido o expirado' };
+      return { success: false, error: 'Token is invalid or expired' };
     }
 
     const data = await response.json();
 
     if (!data || !data.success) {
-      return { success: false, error: data?.error || 'Error al verificar usuario' };
+      return { success: false, error: data?.error || 'Failed to verify user' };
     }
 
     return {
@@ -391,7 +409,7 @@ async function getUserInfo(token) {
       canCreateLink: data.canCreateLink !== false
     };
   } catch (error) {
-    return { success: false, error: error.message || 'Error de conexión' };
+    return { success: false, error: error.message || 'Connection error' };
   }
 }
 
@@ -405,12 +423,12 @@ function parseLinkOptions(args) {
     if (arg === '--ttl') {
       const ttlValue = args[i + 1];
       if (!ttlValue) {
-        return { ok: false, error: 'Falta valor para --ttl' };
+        return { ok: false, error: 'Missing value for --ttl' };
       }
 
       const parsedTtl = Number.parseInt(ttlValue, 10);
       if (!Number.isInteger(parsedTtl) || parsedTtl <= 0) {
-        return { ok: false, error: '--ttl debe ser un entero positivo' };
+        return { ok: false, error: '--ttl must be a positive integer' };
       }
 
       ttl = parsedTtl;
@@ -422,7 +440,7 @@ function parseLinkOptions(args) {
       const ttlValue = arg.split('=')[1];
       const parsedTtl = Number.parseInt(ttlValue, 10);
       if (!Number.isInteger(parsedTtl) || parsedTtl <= 0) {
-        return { ok: false, error: '--ttl debe ser un entero positivo' };
+        return { ok: false, error: '--ttl must be a positive integer' };
       }
 
       ttl = parsedTtl;
@@ -432,11 +450,11 @@ function parseLinkOptions(args) {
     if (arg === '--framework') {
       const frameworkValue = args[i + 1];
       if (!frameworkValue) {
-        return { ok: false, error: 'Falta valor para --framework' };
+        return { ok: false, error: 'Missing value for --framework' };
       }
 
       if (!ALLOWED_FRAMEWORKS.includes(frameworkValue)) {
-        return { ok: false, error: `Framework inválido: ${frameworkValue}` };
+        return { ok: false, error: `Invalid framework: ${frameworkValue}` };
       }
 
       framework = frameworkValue;
@@ -447,14 +465,14 @@ function parseLinkOptions(args) {
     if (arg.startsWith('--framework=')) {
       const frameworkValue = arg.split('=')[1];
       if (!ALLOWED_FRAMEWORKS.includes(frameworkValue)) {
-        return { ok: false, error: `Framework inválido: ${frameworkValue}` };
+        return { ok: false, error: `Invalid framework: ${frameworkValue}` };
       }
 
       framework = frameworkValue;
       continue;
     }
 
-    return { ok: false, error: `Flag no soportada: ${arg}` };
+    return { ok: false, error: `Unsupported flag: ${arg}` };
   }
 
   return {
@@ -478,7 +496,7 @@ function detectFramework(preferredFramework = 'auto') {
       return { ...FRAMEWORK_CONFIGS.static, distCandidates: ['.'] };
     }
 
-    log('❌ No se encontró package.json. Si es un sitio estático, incluí un index.html o usá --framework static.', 'red');
+    log('❌ package.json not found. If this is a static site, include index.html or use --framework static.', 'red');
     process.exit(1);
   }
 
@@ -522,7 +540,7 @@ function detectFramework(preferredFramework = 'auto') {
     return { ...FRAMEWORK_CONFIGS.static, distCandidates: ['.'] };
   }
 
-  log('❌ No se pudo detectar framework ni directorio de salida. Usá --framework o creá script build.', 'red');
+  log('❌ Could not detect framework or output directory. Use --framework or add a build script.', 'red');
   process.exit(1);
 }
 
@@ -594,14 +612,14 @@ function resolveDistPath(framework) {
   }
 
   if (framework.name === 'next') {
-    throw new Error('No se encontró el directorio "out" de Next.js. Configurá `output: "export"` en next.config.js para export estático y volvé a ejecutar el build.');
+    throw new Error('Next.js output directory "out" not found. Set `output: "export"` in next.config.js and run the build again.');
   }
 
   if (framework.name === 'custom') {
-    throw new Error('Build ejecutado, pero no se encontró salida en dist/, build/ u out/. Forzá --framework o ajustá tu output.');
+    throw new Error('Build finished, but no output was found in dist/, build/, or out/. Force --framework or adjust your output path.');
   }
 
-  throw new Error(`No se encontró el directorio de salida (${framework.distCandidates.join(', ')})`);
+  throw new Error(`Output directory not found (${framework.distCandidates.join(', ')})`);
 }
 
 async function zipDirectory(dirPath) {
@@ -664,6 +682,9 @@ async function main() {
     case 'login':
       await cmdLogin(args.slice(1));
       break;
+    case 'logout':
+      cmdLogout();
+      break;
     case 'whoami':
       await cmdWhoami();
       break;
@@ -677,8 +698,8 @@ async function main() {
       await cmdDelete(args.slice(1));
       break;
     default:
-      log(`❌ Comando desconocido: ${command}`, 'red');
-      log('Usá `socc help` para ver los comandos disponibles', 'yellow');
+      log(`❌ Unknown command: ${command}`, 'red');
+      log('Use `socc help` to see available commands', 'yellow');
       process.exit(1);
   }
 }