@vibe-db/cli 1.2.2 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+All notable changes to the VibeDB CLI will be documented in this file.
+
+## [1.4.0] - 2026-01-12
+
+### Added
+- **Usage Command**: New `vibedb usage` command to view storage usage and estimated costs
+  - Shows database storage and backup storage breakdown
+  - Displays estimated charges for current billing period
+  - Shows pricing information
+- **Backup Management Commands**: Complete CLI support for backup operations
+  - `vibedb backup list <database_id>` - List all backups for a database
+  - `vibedb backup create <database_id>` - Create a manual backup
+  - `vibedb backup restore <database_id> <backup_id>` - Restore from backup (with confirmation)
+  - `vibedb backup delete <database_id> <backup_id>` - Delete a backup (with confirmation)
+- Added safety confirmations for destructive operations (restore, delete)
+- Improved error messages for missing authentication
+
+### Changed
+- Enhanced API module with backup-related functions
+- Updated README with comprehensive documentation for new commands
+
+### Fixed
+- Fixed handling of undefined estimated charges in usage display
+
+## [1.3.0] - 2026-01-11
+
+### Added
+- **Team Support**: Multi-team functionality
+  - `vibedb teams list` - List all teams
+  - `vibedb teams switch <team_id>` - Switch between teams
+  - `vibedb teams current` - Show current team
+  - Auto-selects personal team on login
+- **Billing Commands**: Stripe billing integration
+  - `vibedb billing info` - View billing information
+  - `vibedb billing subscribe` - Subscribe to VibeDB
+  - `vibedb billing cancel` - Cancel subscription
+  - `vibedb billing invoices` - View invoices
+
+### Changed
+- Database operations now scoped to current team
+- Config file now stores current team ID
+
+## [1.2.0] - Earlier
+
+### Added
+- Basic database operations
+  - `vibedb list` - List databases
+  - `vibedb init` - Download VIBEDB.md prompt file
+- Authentication commands
+  - `vibedb signup` - Create account
+  - `vibedb login` - Login to existing account
+  - `vibedb logout` - Logout and clear credentials
+- Configuration management in `~/.vibedb`
+
+## Future Plans
+
+- Database creation directly from CLI
+- Database deletion with recovery options
+- Connection testing
+- Query execution from CLI
+- Import/export utilities

package/README.md

@@ -99,6 +99,177 @@ List all your databases.
 
 **Output:**
 - Table showing all databases with ID, Name, Type, and Status
+- Note: Shows databases for your current team only
+
+### `vibedb teams list` (alias: `teams ls`)
+List all teams you belong to.
+
+**Requirements:**
+- Must be logged in
+
+**Output:**
+- Table showing team ID, name, role, type, and current indicator
+- Shows which team is currently selected
+
+### `vibedb teams switch <team_id>`
+Switch to a different team.
+
+**Requirements:**
+- Must be logged in
+- Team ID from `vibedb teams list`
+
+**Example:**
+```bash
+vibedb teams switch team_abc123
+```
+
+**Output:**
+- Confirmation of team switch
+- All subsequent commands use this team context
+
+### `vibedb teams current`
+Show currently selected team.
+
+**Requirements:**
+- Must be logged in
+
+**Output:**
+- Current team details (ID, name, role, type)
+
+### `vibedb usage`
+Show current usage and costs.
+
+**Requirements:**
+- Must be logged in
+
+**Output:**
+- Storage breakdown (database + backup storage)
+- Estimated charges for current period
+- Pricing information
+
+**Example:**
+```bash
+vibedb usage
+
+📊 Usage & Costs
+
+Storage Usage:
+  Database Storage: 45.23 MB
+  Backup Storage: 12.67 MB
+  ─────────────────
+  Total Storage: 57.90 MB
+
+Estimated Charges:
+  Current Period: $0.0823 USD
+
+Pricing:
+  Storage: $0.00014 per GB-hour
+  Compute: $0.000167 per minute
+```
+
+### `vibedb backup list <database_id>`
+List all backups for a database.
+
+**Requirements:**
+- Must be logged in
+- Valid database ID
+
+**Output:**
+- List of backups with ID, type (auto/manual), size, and creation date
+
+**Example:**
+```bash
+vibedb backup list db_abc123
+
+💾 Backups
+
+Found 3 backup(s):
+
+1. d4339369-a3bb-492c-afe3-2124265e9b56
+   Type: [Manual]
+   Size: 12.34 MB
+   Created: 1/12/2026, 8:30:06 PM
+
+2. a1234567-b8cd-9012-efgh-345678901234
+   Type: [Auto]
+   Size: 11.98 MB
+   Created: 1/12/2026, 2:00:00 AM
+```
+
+### `vibedb backup create <database_id>`
+Create a manual backup.
+
+**Requirements:**
+- Must be logged in
+- Valid database ID
+
+**Output:**
+- Backup ID and creation timestamp
+
+**Example:**
+```bash
+vibedb backup create db_abc123
+
+✓ Backup created successfully!
+
+Backup ID: d4339369-a3bb-492c-afe3-2124265e9b56
+Type: [Manual]
+Created: 1/12/2026, 8:30:06 PM
+Size: 12.34 MB
+
+Restore this backup with:
+vibedb backup restore db_abc123 d4339369-a3bb-492c-afe3-2124265e9b56
+```
+
+### `vibedb backup restore <database_id> <backup_id>`
+Restore a database from a backup.
+
+**Requirements:**
+- Must be logged in
+- Valid database ID and backup ID
+- Confirmation required (interactive)
+
+**Warning:** This will replace ALL current data in the database!
+
+**Example:**
+```bash
+vibedb backup restore db_abc123 d4339369-a3bb-492c-afe3-2124265e9b56
+
+🔄 Restore Backup
+
+⚠️  WARNING:
+This will replace ALL current data in the database with the backup.
+This action cannot be undone.
+
+Database ID: db_abc123
+Backup ID: d4339369-a3bb-492c-afe3-2124265e9b56
+
+Are you sure you want to restore this backup? (y/N): y
+
+✓ Backup restored successfully!
+```
+
+### `vibedb backup delete <database_id> <backup_id>`
+Delete a backup.
+
+**Requirements:**
+- Must be logged in
+- Valid database ID and backup ID
+- Confirmation required (interactive)
+
+**Example:**
+```bash
+vibedb backup delete db_abc123 d4339369-a3bb-492c-afe3-2124265e9b56
+
+🗑️  Delete Backup
+
+Database ID: db_abc123
+Backup ID: d4339369-a3bb-492c-afe3-2124265e9b56
+
+Are you sure you want to delete this backup? (y/N): y
+
+✓ Backup deleted successfully!
+```
 
 ## Configuration
 
@@ -108,10 +279,13 @@ The CLI stores your credentials in `~/.vibedb`:
 {
   "api_key": "vdb_xxx...",
   "email": "you@example.com",
-  "api_url": "https://api.vibedb.dev"
+  "api_url": "https://api.vibedb.dev",
+  "current_team_id": "team_abc123"
 }
 ```
 
+**Team Context:** The CLI remembers your current team selection. Use `vibedb teams switch` to change teams.
+
 **Security Note:** Keep this file secure. Anyone with your API key can manage your databases.
 
 ## Examples
@@ -150,6 +324,50 @@ $ npx @vibedb/cli list
 Total: 1 database
 ```
 
+### Working with Teams
+```bash
+# List all your teams
+$ vibedb teams list
+
+┌──────────────────┬──────────────┬────────┬──────────┬─────────┐
+│ ID               │ Name         │ Role   │ Type     │ Current │
+├──────────────────┼──────────────┼────────┼──────────┼─────────┤
+│ team_abc123      │ John's Team  │ owner  │ Personal │ ✓       │
+│ team_xyz789      │ Acme Corp    │ member │ Team     │         │
+└──────────────────┴──────────────┴────────┴──────────┴─────────┘
+
+Total: 2 teams
+
+# Switch to a different team
+$ vibedb teams switch team_xyz789
+
+✓ Successfully switched to team
+Team: Acme Corp
+Role: member
+
+# List databases in the new team context
+$ vibedb list
+
+┌─────────────────┬────────────────┬──────────┬────────┐
+│ ID              │ Name           │ Type     │ Status │
+├─────────────────┼────────────────┼──────────┼────────┤
+│ db_def456       │ production-db  │ postgres │ ready  │
+│ db_ghi789       │ staging-cache  │ redis    │ ready  │
+└─────────────────┴────────────────┴──────────┴────────┘
+
+Total: 2 databases
+
+# Check current team
+$ vibedb teams current
+
+📍 Current Team
+
+ID: team_xyz789
+Name: Acme Corp
+Role: member
+Type: Team
+```
+
 ## Supported Databases
 
 - **PostgreSQL** - General purpose relational database
@@ -191,7 +409,12 @@ The CLI interacts with these VibeDB API endpoints:
 - `POST /v1/auth/login` - Authenticate
 - `GET /v1/databases` - List databases
 - `GET /v1/prompt-file` - Download prompt file
-- `GET /v1/account` - Get account info
+- `GET /v1/account` - Get account info and usage
+- `GET /v1/teams` - List teams
+- `GET /v1/databases/{id}/backups` - List backups
+- `POST /v1/databases/{id}/backups` - Create backup
+- `POST /v1/databases/{id}/backups/{backup_id}/restore` - Restore backup
+- `DELETE /v1/databases/{id}/backups/{backup_id}` - Delete backup
 
 Full API docs: https://api.vibedb.dev/docs
 

package/bin/vibedb.js

@@ -12,6 +12,14 @@ const billingInfoCommand = require('../src/commands/billing-info');
 const billingSubscribeCommand = require('../src/commands/billing-subscribe');
 const billingCancelCommand = require('../src/commands/billing-cancel');
 const billingInvoicesCommand = require('../src/commands/billing-invoices');
+const teamsListCommand = require('../src/commands/teams-list');
+const teamsSwitchCommand = require('../src/commands/teams-switch');
+const teamsCurrentCommand = require('../src/commands/teams-current');
+const usageCommand = require('../src/commands/usage');
+const backupListCommand = require('../src/commands/backup-list');
+const backupCreateCommand = require('../src/commands/backup-create');
+const backupRestoreCommand = require('../src/commands/backup-restore');
+const backupDeleteCommand = require('../src/commands/backup-delete');
 
 const program = new Command();
 
@@ -134,6 +142,114 @@ billing
     }
   });
 
+// Teams commands
+const teams = program
+  .command('teams')
+  .description('Manage teams and team membership');
+
+teams
+  .command('list')
+  .alias('ls')
+  .description('List all teams you belong to')
+  .action(async () => {
+    try {
+      await teamsListCommand();
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+teams
+  .command('switch <team_id>')
+  .description('Switch to a different team')
+  .action(async (teamId) => {
+    try {
+      await teamsSwitchCommand(teamId);
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+teams
+  .command('current')
+  .description('Show current team')
+  .action(async () => {
+    try {
+      await teamsCurrentCommand();
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Usage command
+program
+  .command('usage')
+  .description('Show current usage and costs')
+  .action(async () => {
+    try {
+      await usageCommand();
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Backup commands
+const backup = program
+  .command('backup')
+  .description('Manage database backups');
+
+backup
+  .command('list <database_id>')
+  .description('List all backups for a database')
+  .action(async (databaseId) => {
+    try {
+      await backupListCommand(databaseId);
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+backup
+  .command('create <database_id>')
+  .description('Create a manual backup')
+  .action(async (databaseId) => {
+    try {
+      await backupCreateCommand(databaseId);
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+backup
+  .command('restore <database_id> <backup_id>')
+  .description('Restore a database from a backup')
+  .action(async (databaseId, backupId) => {
+    try {
+      await backupRestoreCommand(databaseId, backupId);
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+backup
+  .command('delete <database_id> <backup_id>')
+  .description('Delete a backup')
+  .action(async (databaseId, backupId) => {
+    try {
+      await backupDeleteCommand(databaseId, backupId);
+    } catch (error) {
+      console.error(chalk.red('Unexpected error:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Global error handler
 process.on('unhandledRejection', (error) => {
   console.error(chalk.red.bold('\n✗ Unhandled error:'), error.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-db/cli",
-  "version": "1.2.2",
+  "version": "1.4.0",
   "description": "Command-line interface for VibeDB - instant database provisioning for AI-assisted development",
   "main": "bin/vibedb.js",
   "bin": {

package/src/api.js

@@ -43,9 +43,13 @@ async function login(email, password) {
 /**
  * List all databases for authenticated user
  */
-async function listDatabases(apiKey) {
+async function listDatabases(apiKey, teamId = null) {
   try {
-    const response = await axios.get(`${API_BASE_URL}/v1/databases`, {
+    const url = teamId 
+      ? `${API_BASE_URL}/v1/databases?team_id=${teamId}`
+      : `${API_BASE_URL}/v1/databases`;
+    
+    const response = await axios.get(url, {
       headers: {
         Authorization: `Bearer ${apiKey}`,
       },
@@ -78,9 +82,13 @@ async function getPromptFile() {
 /**
  * Get account information
  */
-async function getAccount(apiKey) {
+async function getAccount(apiKey, teamId = null) {
   try {
-    const response = await axios.get(`${API_BASE_URL}/v1/account`, {
+    const url = teamId 
+      ? `${API_BASE_URL}/v1/account?team_id=${teamId}`
+      : `${API_BASE_URL}/v1/account`;
+    
+    const response = await axios.get(url, {
       headers: {
         Authorization: `Bearer ${apiKey}`,
       },
@@ -215,6 +223,137 @@ async function pollDeviceAuth(deviceCode) {
   }
 }
 
+/**
+ * List all teams for authenticated user
+ */
+async function listTeams(apiKey) {
+  try {
+    const response = await axios.get(`${API_BASE_URL}/v1/teams`, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+      },
+    });
+    return response.data.teams || [];
+  } catch (error) {
+    if (error.response) {
+      const { error: errorCode, message } = error.response.data;
+      throw new Error(message || errorCode || 'Failed to list teams');
+    }
+    throw new Error(`Network error: ${error.message}`);
+  }
+}
+
+/**
+ * Get team details
+ */
+async function getTeam(apiKey, teamId) {
+  try {
+    const response = await axios.get(`${API_BASE_URL}/v1/teams/${teamId}`, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+      },
+    });
+    return response.data;
+  } catch (error) {
+    if (error.response) {
+      const { error: errorCode, message } = error.response.data;
+      throw new Error(message || errorCode || 'Failed to get team');
+    }
+    throw new Error(`Network error: ${error.message}`);
+  }
+}
+
+/**
+ * List backups for a database
+ */
+async function listBackups(apiKey, databaseId) {
+  try {
+    const response = await axios.get(`${API_BASE_URL}/v1/databases/${databaseId}/backups`, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+      },
+    });
+    return response.data.backups || [];
+  } catch (error) {
+    if (error.response) {
+      const { error: errorCode, message } = error.response.data;
+      throw new Error(message || errorCode || 'Failed to list backups');
+    }
+    throw new Error(`Network error: ${error.message}`);
+  }
+}
+
+/**
+ * Create a backup for a database
+ */
+async function createBackup(apiKey, databaseId) {
+  try {
+    const response = await axios.post(
+      `${API_BASE_URL}/v1/databases/${databaseId}/backups`,
+      {},
+      {
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+        },
+      }
+    );
+    return response.data;
+  } catch (error) {
+    if (error.response) {
+      const { error: errorCode, message } = error.response.data;
+      throw new Error(message || errorCode || 'Failed to create backup');
+    }
+    throw new Error(`Network error: ${error.message}`);
+  }
+}
+
+/**
+ * Restore a database from a backup
+ */
+async function restoreBackup(apiKey, databaseId, backupId) {
+  try {
+    const response = await axios.post(
+      `${API_BASE_URL}/v1/databases/${databaseId}/backups/${backupId}/restore`,
+      {},
+      {
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+        },
+      }
+    );
+    return response.data;
+  } catch (error) {
+    if (error.response) {
+      const { error: errorCode, message } = error.response.data;
+      throw new Error(message || errorCode || 'Failed to restore backup');
+    }
+    throw new Error(`Network error: ${error.message}`);
+  }
+}
+
+/**
+ * Delete a backup
+ */
+async function deleteBackup(apiKey, databaseId, backupId) {
+  try {
+    const response = await axios.delete(
+      `${API_BASE_URL}/v1/databases/${databaseId}/backups/${backupId}`,
+      {
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+        },
+      }
+    );
+    return response.data;
+  } catch (error) {
+    if (error.response) {
+      const { error: errorCode, message } = error.response.data;
+      throw new Error(message || errorCode || 'Failed to delete backup');
+    }
+    throw new Error(`Network error: ${error.message}`);
+  }
+}
+
 module.exports = {
   signup,
   login,
@@ -227,4 +366,10 @@ module.exports = {
   getInvoices,
   startDeviceAuth,
   pollDeviceAuth,
+  listTeams,
+  getTeam,
+  listBackups,
+  createBackup,
+  restoreBackup,
+  deleteBackup,
 };

package/src/commands/backup-create.js

@@ -0,0 +1,48 @@
+const chalk = require('chalk');
+const api = require('../api');
+const config = require('../config');
+
+async function backupCreateCommand(databaseId) {
+  console.log(chalk.blue.bold('\n💾 Create Backup\n'));
+
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    if (!databaseId) {
+      console.error(chalk.red.bold('✗ Database ID is required'));
+      console.log(chalk.gray('\nUsage:'), chalk.cyan('vibedb backup create <database-id>'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+
+    console.log(chalk.gray(`Creating backup for database ${databaseId}...`));
+
+    const backup = await api.createBackup(apiKey, databaseId);
+
+    console.log(chalk.green.bold('\n✓ Backup created successfully!\n'));
+    console.log(chalk.gray('Backup ID:'), chalk.cyan(backup.id));
+    console.log(chalk.gray('Type:'), chalk.green('[Manual]'));
+    console.log(chalk.gray('Created:'), chalk.white(new Date(backup.created_at).toLocaleString()));
+    
+    if (backup.size_mb) {
+      console.log(chalk.gray('Size:'), chalk.cyan(`${backup.size_mb.toFixed(2)} MB`));
+    }
+    
+    console.log();
+    console.log(chalk.gray('Restore this backup with:'));
+    console.log(chalk.cyan(`vibedb backup restore ${databaseId} ${backup.id}`));
+    console.log();
+
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to create backup:'), chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+module.exports = backupCreateCommand;

package/src/commands/backup-delete.js

@@ -0,0 +1,64 @@
+const chalk = require('chalk');
+const readline = require('readline');
+const api = require('../api');
+const config = require('../config');
+
+async function askConfirmation(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+async function backupDeleteCommand(databaseId, backupId) {
+  console.log(chalk.blue.bold('\n🗑️  Delete Backup\n'));
+
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    if (!databaseId || !backupId) {
+      console.error(chalk.red.bold('✗ Database ID and Backup ID are required'));
+      console.log(chalk.gray('\nUsage:'), chalk.cyan('vibedb backup delete <database-id> <backup-id>'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+
+    console.log(chalk.gray('Database ID:'), chalk.cyan(databaseId));
+    console.log(chalk.gray('Backup ID:'), chalk.cyan(backupId));
+    console.log();
+
+    const confirmed = await askConfirmation(chalk.white('Are you sure you want to delete this backup? (y/N): '));
+
+    if (!confirmed) {
+      console.log(chalk.gray('\nDeletion cancelled.'));
+      return;
+    }
+
+    console.log(chalk.gray('\nDeleting backup...'));
+
+    await api.deleteBackup(apiKey, databaseId, backupId);
+
+    console.log(chalk.green.bold('\n✓ Backup deleted successfully!\n'));
+    console.log(chalk.gray('Backup ID:'), chalk.cyan(backupId));
+    console.log();
+
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to delete backup:'), chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+module.exports = backupDeleteCommand;

package/src/commands/backup-list.js

@@ -0,0 +1,67 @@
+const chalk = require('chalk');
+const api = require('../api');
+const config = require('../config');
+
+async function backupListCommand(databaseId) {
+  console.log(chalk.blue.bold('\n💾 Backups\n'));
+
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    if (!databaseId) {
+      console.error(chalk.red.bold('✗ Database ID is required'));
+      console.log(chalk.gray('\nUsage:'), chalk.cyan('vibedb backup list <database-id>'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+
+    console.log(chalk.gray(`Fetching backups for database ${databaseId}...`));
+
+    const backups = await api.listBackups(apiKey, databaseId);
+
+    if (backups.length === 0) {
+      console.log(chalk.yellow('\nNo backups found for this database.'));
+      console.log(chalk.gray('Create one with:'), chalk.cyan(`vibedb backup create ${databaseId}`));
+      return;
+    }
+
+    console.log();
+    console.log(chalk.gray(`Found ${backups.length} backup(s):\n`));
+
+    // Display backups in a table format
+    backups.forEach((backup, index) => {
+      const isAutomatic = backup.type === 'automatic';
+      const typeLabel = isAutomatic ? chalk.blue('[Auto]') : chalk.green('[Manual]');
+      const sizeLabel = backup.size_mb ? `${backup.size_mb.toFixed(2)} MB` : 'N/A';
+      const createdAt = new Date(backup.created_at).toLocaleString();
+      
+      console.log(chalk.white.bold(`${index + 1}. ${backup.id}`));
+      console.log(chalk.gray('   Type:'), typeLabel);
+      console.log(chalk.gray('   Size:'), chalk.cyan(sizeLabel));
+      console.log(chalk.gray('   Created:'), chalk.white(createdAt));
+      
+      if (backup.deleted_at) {
+        console.log(chalk.gray('   Status:'), chalk.red('Deleted'));
+      }
+      
+      console.log();
+    });
+
+    console.log(chalk.gray('Commands:'));
+    console.log(chalk.gray('  Restore:'), chalk.cyan(`vibedb backup restore ${databaseId} <backup-id>`));
+    console.log(chalk.gray('  Delete:'), chalk.cyan(`vibedb backup delete ${databaseId} <backup-id>`));
+    console.log();
+
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to list backups:'), chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+module.exports = backupListCommand;

package/src/commands/backup-restore.js

@@ -0,0 +1,73 @@
+const chalk = require('chalk');
+const readline = require('readline');
+const api = require('../api');
+const config = require('../config');
+
+async function askConfirmation(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+async function backupRestoreCommand(databaseId, backupId) {
+  console.log(chalk.blue.bold('\n🔄 Restore Backup\n'));
+
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    if (!databaseId || !backupId) {
+      console.error(chalk.red.bold('✗ Database ID and Backup ID are required'));
+      console.log(chalk.gray('\nUsage:'), chalk.cyan('vibedb backup restore <database-id> <backup-id>'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+
+    // Warning message
+    console.log(chalk.yellow.bold('⚠️  WARNING:'));
+    console.log(chalk.yellow('This will replace ALL current data in the database with the backup.'));
+    console.log(chalk.yellow('This action cannot be undone.\n'));
+    
+    console.log(chalk.gray('Database ID:'), chalk.cyan(databaseId));
+    console.log(chalk.gray('Backup ID:'), chalk.cyan(backupId));
+    console.log();
+
+    const confirmed = await askConfirmation(chalk.white('Are you sure you want to restore this backup? (y/N): '));
+
+    if (!confirmed) {
+      console.log(chalk.gray('\nRestore cancelled.'));
+      return;
+    }
+
+    console.log(chalk.gray('\nRestoring backup...'));
+
+    const result = await api.restoreBackup(apiKey, databaseId, backupId);
+
+    console.log(chalk.green.bold('\n✓ Backup restored successfully!\n'));
+    console.log(chalk.gray('Database ID:'), chalk.cyan(databaseId));
+    console.log(chalk.gray('Backup ID:'), chalk.cyan(backupId));
+    console.log(chalk.gray('Restored at:'), chalk.white(new Date().toLocaleString()));
+    console.log();
+    console.log(chalk.green('Your database has been restored to the backup state.'));
+    console.log();
+
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to restore backup:'), chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+module.exports = backupRestoreCommand;

package/src/commands/list.js

@@ -15,10 +15,11 @@ async function listCommand() {
     }
 
     const apiKey = config.getAPIKey();
+    const currentTeamId = config.getCurrentTeamId();
 
     console.log(chalk.gray('Fetching databases...'));
 
-    const databases = await api.listDatabases(apiKey);
+    const databases = await api.listDatabases(apiKey, currentTeamId);
 
     if (databases.length === 0) {
       console.log(chalk.yellow('\nNo databases found.'));

package/src/commands/login.js

@@ -54,6 +54,21 @@ async function loginWithGitHub() {
         if (pollData.status === 'complete') {
           // Save API key
           config.saveAuth(pollData.api_key, pollData.email);
+          
+          // Auto-select first team (usually personal team)
+          try {
+            const teams = await api.listTeams(pollData.api_key);
+            if (teams.length > 0) {
+              // Prefer personal team, otherwise first team
+              const personalTeam = teams.find(t => t.is_personal);
+              const defaultTeam = personalTeam || teams[0];
+              config.setCurrentTeamId(defaultTeam.id);
+            }
+          } catch (err) {
+            // Non-fatal, just log
+            console.log(chalk.gray('Note: Could not auto-select team'));
+          }
+          
           console.log(chalk.green.bold('\n✓ Login successful!\n'));
           console.log(chalk.white('Email:'), chalk.cyan(pollData.email));
           console.log(chalk.gray(`API key saved to ${config.getConfigPath()}`));
@@ -116,6 +131,20 @@ async function loginWithEmail() {
     // Save API key to config
     config.saveAuth(result.api_key, result.email);
 
+    // Auto-select first team (usually personal team)
+    try {
+      const teams = await api.listTeams(result.api_key);
+      if (teams.length > 0) {
+        // Prefer personal team, otherwise first team
+        const personalTeam = teams.find(t => t.is_personal);
+        const defaultTeam = personalTeam || teams[0];
+        config.setCurrentTeamId(defaultTeam.id);
+      }
+    } catch (err) {
+      // Non-fatal, just log
+      console.log(chalk.gray('Note: Could not auto-select team'));
+    }
+
     console.log(chalk.green.bold('\n✓ Login successful!\n'));
     console.log(chalk.white('Email:'), chalk.cyan(result.email));
     console.log(chalk.gray(`API key saved to ${config.getConfigPath()}`));

package/src/commands/signup.js

@@ -50,6 +50,19 @@ async function signupWithGitHub() {
         
         if (pollData.status === 'complete') {
           config.saveAuth(pollData.api_key, pollData.email);
+          
+          // Auto-select first team (usually personal team)
+          try {
+            const teams = await api.listTeams(pollData.api_key);
+            if (teams.length > 0) {
+              const personalTeam = teams.find(t => t.is_personal);
+              const defaultTeam = personalTeam || teams[0];
+              config.setCurrentTeamId(defaultTeam.id);
+            }
+          } catch (err) {
+            // Non-fatal
+          }
+          
           console.log(chalk.green.bold('\n✓ Account created successfully!\n'));
           console.log(chalk.white('Email:'), chalk.cyan(pollData.email));
           console.log(chalk.gray(`API key saved to ${config.getConfigPath()}`));
@@ -128,6 +141,18 @@ async function signupWithEmail() {
 
     config.saveAuth(result.api_key, result.email);
 
+    // Auto-select first team (usually personal team)
+    try {
+      const teams = await api.listTeams(result.api_key);
+      if (teams.length > 0) {
+        const personalTeam = teams.find(t => t.is_personal);
+        const defaultTeam = personalTeam || teams[0];
+        config.setCurrentTeamId(defaultTeam.id);
+      }
+    } catch (err) {
+      // Non-fatal
+    }
+
     console.log(chalk.green.bold('\n✓ Account created successfully!\n'));
     console.log(chalk.white('Email:'), chalk.cyan(result.email));
     console.log(chalk.gray(`API key saved to ${config.getConfigPath()}`));

package/src/commands/teams-current.js

@@ -0,0 +1,42 @@
+const chalk = require('chalk');
+const api = require('../api');
+const config = require('../config');
+
+async function teamsCurrentCommand() {
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+    const currentTeamId = config.getCurrentTeamId();
+
+    if (!currentTeamId) {
+      console.log(chalk.yellow('\nNo team currently selected.'));
+      console.log(chalk.gray('\nSwitch to a team with:'), chalk.cyan('vibedb teams switch <team_id>'));
+      console.log(chalk.gray('List your teams with:'), chalk.cyan('vibedb teams list'));
+      console.log();
+      return;
+    }
+
+    console.log(chalk.gray('Fetching current team...'));
+
+    const team = await api.getTeam(apiKey, currentTeamId);
+
+    console.log(chalk.blue.bold('\n📍 Current Team\n'));
+    console.log(chalk.gray('ID:'), chalk.cyan(team.id));
+    console.log(chalk.gray('Name:'), chalk.white(team.name));
+    console.log(chalk.gray('Role:'), chalk.blue(team.role));
+    console.log(chalk.gray('Type:'), team.is_personal ? chalk.gray('Personal') : chalk.white('Team'));
+    console.log();
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to get current team:'), chalk.red(error.message));
+    console.log(chalk.gray('\nThe team may have been deleted. Switch to a different team with:'), chalk.cyan('vibedb teams switch <team_id>'));
+    process.exit(1);
+  }
+}
+
+module.exports = teamsCurrentCommand;

package/src/commands/teams-list.js

@@ -0,0 +1,84 @@
+const chalk = require('chalk');
+const Table = require('cli-table3');
+const api = require('../api');
+const config = require('../config');
+
+async function teamsListCommand() {
+  console.log(chalk.blue.bold('\n👥 Your Teams\n'));
+
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+    const currentTeamId = config.getCurrentTeamId();
+
+    console.log(chalk.gray('Fetching teams...'));
+
+    const teams = await api.listTeams(apiKey);
+
+    if (teams.length === 0) {
+      console.log(chalk.yellow('\nNo teams found.'));
+      console.log();
+      return;
+    }
+
+    // Create table
+    const table = new Table({
+      head: [
+        chalk.white.bold('ID'),
+        chalk.white.bold('Name'),
+        chalk.white.bold('Role'),
+        chalk.white.bold('Type'),
+        chalk.white.bold('Current'),
+      ],
+      colWidths: [30, 25, 12, 12, 10],
+      style: {
+        head: [],
+        border: ['gray'],
+      },
+    });
+
+    teams.forEach((team) => {
+      const isCurrent = team.id === currentTeamId;
+      const currentMark = isCurrent ? chalk.green('✓') : '';
+      const teamName = team.is_personal 
+        ? chalk.gray(`${team.name} (Personal)`)
+        : team.name;
+
+      table.push([
+        chalk.cyan(team.id),
+        teamName,
+        chalk.blue(team.role),
+        team.is_personal ? chalk.gray('Personal') : chalk.white('Team'),
+        currentMark,
+      ]);
+    });
+
+    console.log();
+    console.log(table.toString());
+    console.log();
+    
+    if (currentTeamId) {
+      const currentTeam = teams.find(t => t.id === currentTeamId);
+      if (currentTeam) {
+        console.log(chalk.gray(`Current team: ${currentTeam.name}`));
+      }
+    } else {
+      console.log(chalk.yellow('No team selected. Use'), chalk.cyan('vibedb teams switch <team_id>'), chalk.yellow('to select a team.'));
+    }
+    
+    console.log();
+    console.log(chalk.gray(`Total: ${teams.length} team${teams.length === 1 ? '' : 's'}`));
+    console.log();
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to list teams:'), chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+module.exports = teamsListCommand;

package/src/commands/teams-switch.js

@@ -0,0 +1,41 @@
+const chalk = require('chalk');
+const api = require('../api');
+const config = require('../config');
+
+async function teamsSwitchCommand(teamId) {
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    if (!teamId) {
+      console.error(chalk.red.bold('✗ Team ID required'));
+      console.log(chalk.gray('\nUsage:'), chalk.cyan('vibedb teams switch <team_id>'));
+      console.log(chalk.gray('\nList your teams with:'), chalk.cyan('vibedb teams list'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+
+    console.log(chalk.gray(`Switching to team ${teamId}...`));
+
+    // Verify team exists and user has access
+    const team = await api.getTeam(apiKey, teamId);
+
+    // Save as current team
+    config.setCurrentTeamId(teamId);
+
+    console.log(chalk.green.bold('\n✓ Successfully switched to team'));
+    console.log(chalk.gray('Team:'), chalk.white(team.name));
+    console.log(chalk.gray('Role:'), chalk.blue(team.role));
+    console.log();
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to switch team:'), chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+module.exports = teamsSwitchCommand;

package/src/commands/usage.js

@@ -0,0 +1,66 @@
+const chalk = require('chalk');
+const api = require('../api');
+const config = require('../config');
+
+async function usageCommand() {
+  console.log(chalk.blue.bold('\n📊 Usage & Costs\n'));
+
+  try {
+    // Check if logged in
+    if (!config.isLoggedIn()) {
+      console.error(chalk.red.bold('✗ Not logged in'));
+      console.log(chalk.gray('\nPlease run'), chalk.cyan('vibedb login'), chalk.gray('or'), chalk.cyan('vibedb signup'), chalk.gray('first.'));
+      process.exit(1);
+    }
+
+    const apiKey = config.getAPIKey();
+    const currentTeamId = config.getCurrentTeamId();
+
+    console.log(chalk.gray('Fetching usage data...'));
+
+    const account = await api.getAccount(apiKey, currentTeamId);
+
+    console.log();
+
+    // Storage breakdown
+    console.log(chalk.white.bold('Storage Usage:'));
+    
+    if (account.storage_breakdown) {
+      const { database_storage_mb, backup_storage_mb, total_storage_mb } = account.storage_breakdown;
+      
+      console.log(chalk.gray('  Database Storage:'), chalk.white(`${database_storage_mb.toFixed(2)} MB`));
+      console.log(chalk.gray('  Backup Storage:'), chalk.white(`${backup_storage_mb.toFixed(2)} MB`));
+      console.log(chalk.gray('  ─────────────────'));
+      console.log(chalk.gray('  Total Storage:'), chalk.cyan.bold(`${total_storage_mb.toFixed(2)} MB`));
+    } else {
+      console.log(chalk.gray('  Total Storage:'), chalk.cyan.bold(`${account.storage_total_mb.toFixed(2)} MB`));
+    }
+    
+    console.log();
+
+    // Cost information
+    console.log(chalk.white.bold('Estimated Charges:'));
+    const charges = account.estimated_charges_usd || 0;
+    console.log(chalk.gray('  Current Period:'), chalk.green.bold(`$${charges.toFixed(4)} USD`));
+    console.log();
+
+    // Pricing info
+    console.log(chalk.gray('Pricing:'));
+    console.log(chalk.gray('  Storage: $0.00014 per GB-hour'));
+    console.log(chalk.gray('  Compute: $0.000167 per minute'));
+    console.log();
+
+    // Show current team if applicable
+    if (currentTeamId) {
+      console.log(chalk.gray('Team:'), chalk.cyan(currentTeamId));
+      console.log(chalk.gray('Run'), chalk.cyan('vibedb teams list'), chalk.gray('to see all your teams.'));
+      console.log();
+    }
+
+  } catch (error) {
+    console.error(chalk.red.bold('\n✗ Failed to fetch usage:'), chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+module.exports = usageCommand;

package/src/config.js

@@ -68,6 +68,23 @@ function saveAuth(apiKey, email) {
   writeConfig(config);
 }
 
+/**
+ * Get current team ID from config
+ */
+function getCurrentTeamId() {
+  const config = readConfig();
+  return config?.current_team_id || null;
+}
+
+/**
+ * Set current team ID in config
+ */
+function setCurrentTeamId(teamId) {
+  const config = readConfig() || {};
+  config.current_team_id = teamId;
+  writeConfig(config);
+}
+
 module.exports = {
   getConfigPath,
   readConfig,
@@ -75,4 +92,6 @@ module.exports = {
   isLoggedIn,
   getAPIKey,
   saveAuth,
+  getCurrentTeamId,
+  setCurrentTeamId,
 };