@lifestreamdynamics/vault-cli 1.0.0 → 1.1.0

package/README.md

@@ -3,7 +3,7 @@
 A powerful command-line interface for Lifestream Vault - the multi-user Markdown document storage service with WebDAV sync, search, and collaboration features.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![npm version](https://img.shields.io/npm/v/@lifestream-vault/cli.svg)](https://www.npmjs.com/package/@lifestream-vault/cli)
+[![npm version](https://img.shields.io/npm/v/@lifestreamdynamics/vault-cli.svg)](https://www.npmjs.com/package/@lifestreamdynamics/vault-cli)
 
 ## 📖 Table of Contents
 
@@ -20,6 +20,7 @@ A powerful command-line interface for Lifestream Vault - the multi-user Markdown
   - [Team Commands](#team-commands)
   - [Sharing & Publishing](#sharing--publishing)
   - [Hooks & Webhooks](#hooks--webhooks)
+  - [Links & Backlinks](#links--backlinks)
   - [Admin Commands](#admin-commands)
 - [Sync & Watch Mode](#-sync--watch-mode)
 - [Configuration](#️-configuration)
@@ -49,14 +50,14 @@ A powerful command-line interface for Lifestream Vault - the multi-user Markdown
 - **🛡️ Admin Tools** - User management, system stats, and audit logs (admin only)
 - **⚙️ Flexible Configuration** - Multiple profiles, environment variable support, and configurable sync behavior
 - **🌐 Offline Support** - Work offline and sync when reconnected
-- **📦 TypeScript SDK** - Built on `@lifestream-vault/sdk` with full type safety
+- **📦 TypeScript SDK** - Built on `@lifestreamdynamics/vault-sdk` with full type safety
 
 ## 📦 Installation
 
 ### Global Installation (Recommended)
 
 ```bash
-npm install -g @lifestream-vault/cli
+npm install -g @lifestreamdynamics/vault-cli
 ```
 
 After installation, the `lsvault` command will be available globally:
@@ -68,7 +69,7 @@ lsvault --help
 ### Local Installation (Project-Specific)
 
 ```bash
-npm install @lifestream-vault/cli
+npm install @lifestreamdynamics/vault-cli
 
 # Run with npx
 npx lsvault --help
@@ -98,7 +99,7 @@ lsvault auth login --api-key lsv_k_your_api_key_here
 lsvault auth login --email user@example.com
 
 # Set a custom API URL (optional)
-lsvault auth login --api-key lsv_k_your_key --api-url https://vault.example.com
+lsvault auth login --api-key lsv_k_your_key --api-url https://vault.lifestreamdynamics.com
 ```
 
 ### 2. List Your Vaults
@@ -372,6 +373,41 @@ lsvault webhooks create \
   --secret webhook_secret_key
 ```
 
+### Calendar
+
+| Command | Description |
+|---------|-------------|
+| `lsvault calendar view <vaultId>` | Browse calendar views and activity heatmap |
+| `lsvault calendar due <vaultId>` | List documents by due date |
+| `lsvault calendar events <vaultId>` | List calendar events |
+| `lsvault calendar create-event <vaultId>` | Create a calendar event |
+| `lsvault calendar update-event <vaultId> <eventId>` | Update a calendar event |
+| `lsvault calendar delete-event <vaultId> <eventId>` | Delete a calendar event |
+
+### Links & Backlinks
+
+| Command | Description |
+|---------|-------------|
+| `lsvault links list <vaultId> <path>` | List forward links from a document |
+| `lsvault links backlinks <vaultId> <path>` | List backlinks pointing to a document |
+| `lsvault links graph <vaultId>` | Get the link graph for a vault |
+| `lsvault links broken <vaultId>` | List unresolved (broken) links in a vault |
+
+**Example:**
+```bash
+# List forward links from a document
+lsvault links list vault_abc123 notes/index.md
+
+# Find all documents linking to a specific document
+lsvault links backlinks vault_abc123 notes/important.md
+
+# Get the full link graph for visualization
+lsvault links graph vault_abc123 --output json > graph.json
+
+# Find broken links
+lsvault links broken vault_abc123
+```
+
 ### Admin Commands
 
 **Note:** Admin commands require admin role.
@@ -474,12 +510,14 @@ The CLI stores configuration in `~/.lsvault/config.json`:
 
 ```json
 {
-  "apiUrl": "http://localhost:4660"
+  "apiUrl": "https://vault.lifestreamdynamics.com"
 }
 ```
 
 **Note:** Credentials are stored securely in the system keychain (or encrypted file fallback), not in the plaintext config file.
 
+> **Self-hosting?** Replace `https://vault.lifestreamdynamics.com` with your server's URL, or set the `LSVAULT_API_URL` environment variable.
+
 ### Configuration Profiles
 
 Manage multiple configurations with profiles:
@@ -489,13 +527,13 @@ Manage multiple configurations with profiles:
 lsvault config profiles
 
 # Create a profile
-lsvault config create-profile production --api-url https://vault.example.com
+lsvault config create-profile production --api-url https://vault.lifestreamdynamics.com
 
 # Switch profiles
 lsvault config use production
 
 # Set config values
-lsvault config set apiUrl https://vault.example.com
+lsvault config set apiUrl https://vault.lifestreamdynamics.com
 
 # Get config values
 lsvault config get apiUrl
@@ -522,14 +560,14 @@ Sync configurations are stored per vault in `~/.lsvault/sync/`:
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `LSVAULT_API_URL` | API server base URL | `http://localhost:4660` |
+| `LSVAULT_API_URL` | API server base URL | `https://vault.lifestreamdynamics.com` |
 | `LSVAULT_API_KEY` | API key for authentication | - |
 | `LSVAULT_CONFIG_DIR` | Configuration directory | `~/.lsvault` |
 | `LSVAULT_PROFILE` | Active configuration profile | `default` |
 
 **Example:**
 ```bash
-export LSVAULT_API_URL=https://vault.example.com
+export LSVAULT_API_URL=https://vault.lifestreamdynamics.com
 export LSVAULT_API_KEY=lsv_k_your_key_here
 lsvault vaults list
 ```
@@ -718,7 +756,7 @@ lsvault auth migrate
 1. Verify API URL is correct: `lsvault config get apiUrl`
 2. Test connectivity: `curl <API_URL>/api/v1/health`
 3. Check firewall/proxy settings
-4. Use custom API URL: `lsvault auth login --api-url https://vault.example.com`
+4. Use custom API URL: `lsvault auth login --api-url https://vault.lifestreamdynamics.com`
 
 ### Output Format Issues
 
@@ -733,9 +771,9 @@ lsvault docs get vault_abc123 /path.md --quiet > output.md
 
 ## 🔗 Related Packages
 
-- **[@lifestream-vault/sdk](https://npmjs.com/package/@lifestream-vault/sdk)** - TypeScript SDK for Lifestream Vault API
-- **[@lifestream-vault/api](https://github.com/lifestreamdynamics/lifestream-vault)** - Backend API server
-- **[@lifestream-vault/web](https://github.com/lifestreamdynamics/lifestream-vault)** - Web frontend
+- **[@lifestreamdynamics/vault-sdk](https://npmjs.com/package/@lifestreamdynamics/vault-sdk)** - TypeScript SDK for Lifestream Vault API
+- **[@lifestreamdynamics/vault-api](https://github.com/lifestreamdynamics/lifestream-vault)** - Backend API server
+- **[@lifestreamdynamics/vault-web](https://github.com/lifestreamdynamics/lifestream-vault)** - Web frontend
 
 ## 📄 Documentation
 

package/dist/commands/admin.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { formatBytes, formatUptime } from '../utils/format.js';
@@ -12,7 +12,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching system stats...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const data = await client.admin.getStats();
             out.stopSpinner();
             out.record({
@@ -41,7 +41,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching timeseries data...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const data = await client.admin.getTimeseries(String(_opts.metric), String(_opts.period));
             out.stopSpinner();
             if (flags.output === 'text') {
@@ -79,7 +79,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching users...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.admin.listUsers({
                 page: _opts.page,
                 limit: _opts.limit,
@@ -125,7 +125,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching user...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const user = await client.admin.getUser(userId);
             out.stopSpinner();
             out.record({
@@ -169,7 +169,7 @@ export function registerAdminCommands(program) {
         }
         out.startSpinner('Updating user...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const updated = await client.admin.updateUser(userId, params);
             out.success(`User updated: ${chalk.cyan(updated.email)} -- ${chalk.magenta(updated.role)} -- ${updated.isActive ? chalk.green('active') : chalk.red('inactive')}`, {
                 email: updated.email,
@@ -190,7 +190,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching activity...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const activity = await client.admin.getActivity(_opts.limit);
             out.stopSpinner();
             out.list(activity.map(a => ({
@@ -224,7 +224,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching subscription summary...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const summary = await client.admin.getSubscriptionSummary();
             out.stopSpinner();
             out.record({
@@ -246,7 +246,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Checking system health...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const health = await client.admin.getHealth();
             out.stopSpinner();
             out.record({

package/dist/commands/auth.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { LifestreamVaultClient } from '@lifestreamdynamics/vault-sdk';
 import { loadConfigAsync, getCredentialManager } from '../config.js';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { migrateCredentials, hasPlaintextCredentials, checkAndPromptMigration } from '../lib/migration.js';
 export function registerAuthCommands(program) {
     const auth = program.command('auth').description('Authentication and credential management');
@@ -11,11 +11,13 @@ export function registerAuthCommands(program) {
         .option('--api-key <key>', 'API key (lsv_k_... prefix)')
         .option('--email <email>', 'Email address for password login')
         .option('--password <password>', 'Password (prompts interactively if omitted)')
-        .option('--api-url <url>', 'API server URL (default: http://localhost:4660)')
+        .option('--mfa-code <code>', 'MFA code (TOTP or backup code) if account has MFA enabled')
+        .option('--api-url <url>', 'API server URL (default: https://vault.lifestreamdynamics.com)')
         .addHelpText('after', `
 EXAMPLES
   lsvault auth login --api-key lsv_k_abc123
   lsvault auth login --email user@example.com
+  lsvault auth login --email user@example.com --mfa-code 123456
   lsvault auth login --email user@example.com --api-url https://api.example.com`)
         .action(async (opts) => {
         const cm = getCredentialManager();
@@ -42,7 +44,20 @@ EXAMPLES
             const apiUrl = opts.apiUrl ?? config.apiUrl;
             const spinner = ora('Authenticating...').start();
             try {
-                const { tokens, refreshToken } = await LifestreamVaultClient.login(apiUrl, opts.email, password);
+                const { tokens, refreshToken } = await LifestreamVaultClient.login(apiUrl, opts.email, password, {}, {
+                    mfaCode: opts.mfaCode,
+                    onMfaRequired: async (challenge) => {
+                        spinner.stop();
+                        console.log(chalk.yellow('MFA required for this account.'));
+                        console.log(`Available methods: ${challenge.methods.join(', ')}`);
+                        const code = await promptMfaCode();
+                        if (!code) {
+                            throw new Error('MFA code is required');
+                        }
+                        spinner.start('Verifying MFA code...');
+                        return { method: 'totp', code };
+                    },
+                });
                 // Save tokens to secure storage
                 await cm.saveCredentials({
                     accessToken: tokens.accessToken,
@@ -179,7 +194,7 @@ EXAMPLES
         if (config.apiKey || config.accessToken) {
             const spinner = ora('Fetching user info...').start();
             try {
-                const client = getClient();
+                const client = await getClientAsync();
                 const user = await client.user.me();
                 spinner.stop();
                 console.log(`User:    ${chalk.cyan(user.email)}`);
@@ -245,6 +260,57 @@ async function promptPassword() {
         process.stdin.resume();
     });
 }
+/**
+ * Prompt for an MFA code from stdin (6 digits, non-echoing).
+ * Returns the code or null if stdin is not a TTY.
+ */
+async function promptMfaCode() {
+    // In non-interactive mode, cannot prompt
+    if (!process.stdin.isTTY) {
+        return null;
+    }
+    const readline = await import('node:readline');
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stderr,
+            terminal: true,
+        });
+        // Disable echoing
+        process.stderr.write('MFA code: ');
+        process.stdin.setRawMode?.(true);
+        let code = '';
+        const onData = (chunk) => {
+            const char = chunk.toString('utf-8');
+            if (char === '\n' || char === '\r' || char === '\u0004') {
+                process.stderr.write('\n');
+                process.stdin.setRawMode?.(false);
+                process.stdin.removeListener('data', onData);
+                rl.close();
+                resolve(code);
+            }
+            else if (char === '\u0003') {
+                // Ctrl+C
+                process.stderr.write('\n');
+                process.stdin.setRawMode?.(false);
+                process.stdin.removeListener('data', onData);
+                rl.close();
+                resolve(null);
+            }
+            else if (char === '\u007F' || char === '\b') {
+                // Backspace
+                if (code.length > 0) {
+                    code = code.slice(0, -1);
+                }
+            }
+            else {
+                code += char;
+            }
+        };
+        process.stdin.on('data', onData);
+        process.stdin.resume();
+    });
+}
 function formatMethod(method) {
     switch (method) {
         case 'keychain': return chalk.green('OS Keychain');

package/dist/commands/calendar.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerCalendarCommands(program: Command): void;

package/dist/commands/calendar.js

@@ -0,0 +1,167 @@
+import chalk from 'chalk';
+import { getClientAsync } from '../client.js';
+import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
+import { createOutput, handleError } from '../utils/output.js';
+export function registerCalendarCommands(program) {
+    const calendar = program.command('calendar').description('Document calendar and due date management');
+    // calendar view
+    addGlobalFlags(calendar.command('view')
+        .description('View calendar activity for a vault')
+        .argument('<vaultId>', 'Vault ID')
+        .option('--start <date>', 'Start date (YYYY-MM-DD)', getDefaultStart())
+        .option('--end <date>', 'End date (YYYY-MM-DD)', getDefaultEnd()))
+        .action(async (vaultId, _opts) => {
+        const flags = resolveFlags(_opts);
+        const out = createOutput(flags);
+        out.startSpinner('Loading calendar...');
+        try {
+            const client = await getClientAsync();
+            const response = await client.calendar.getActivity(vaultId, {
+                start: _opts.start,
+                end: _opts.end,
+            });
+            out.stopSpinner();
+            if (flags.output === 'text') {
+                out.status(chalk.dim(`Activity from ${response.start} to ${response.end}:\n`));
+            }
+            out.list(response.days.map(d => ({
+                date: d.date,
+                created: String(d.created),
+                updated: String(d.updated),
+                deleted: String(d.deleted),
+                total: String(d.total),
+            })), {
+                emptyMessage: 'No activity in this period.',
+                columns: [
+                    { key: 'date', header: 'Date' },
+                    { key: 'created', header: 'Created' },
+                    { key: 'updated', header: 'Updated' },
+                    { key: 'deleted', header: 'Deleted' },
+                    { key: 'total', header: 'Total' },
+                ],
+                textFn: (d) => {
+                    const bar = '█'.repeat(Math.min(Number(d.total), 20));
+                    return `${chalk.dim(String(d.date))} ${chalk.green(bar)} ${chalk.bold(String(d.total))}`;
+                },
+            });
+        }
+        catch (err) {
+            handleError(out, err, 'Calendar view failed');
+        }
+    });
+    // calendar due
+    addGlobalFlags(calendar.command('due')
+        .description('List documents with due dates')
+        .argument('<vaultId>', 'Vault ID')
+        .option('--status <status>', 'Filter: overdue, upcoming, all', 'all'))
+        .action(async (vaultId, _opts) => {
+        const flags = resolveFlags(_opts);
+        const out = createOutput(flags);
+        out.startSpinner('Loading due dates...');
+        try {
+            const client = await getClientAsync();
+            const docs = await client.calendar.getDueDates(vaultId, {
+                status: _opts.status,
+            });
+            out.stopSpinner();
+            out.list(docs.map(d => ({
+                title: d.title || d.path,
+                path: d.path,
+                dueAt: d.dueAt,
+                priority: d.priority || '-',
+                status: d.overdue ? 'OVERDUE' : d.completed ? 'Done' : 'Pending',
+            })), {
+                emptyMessage: 'No documents with due dates.',
+                columns: [
+                    { key: 'title', header: 'Title' },
+                    { key: 'dueAt', header: 'Due' },
+                    { key: 'priority', header: 'Priority' },
+                    { key: 'status', header: 'Status' },
+                ],
+                textFn: (d) => {
+                    const statusColor = d.status === 'OVERDUE' ? chalk.red : d.status === 'Done' ? chalk.green : chalk.yellow;
+                    return `${chalk.cyan(String(d.title))} — due ${chalk.dim(String(d.dueAt))} ${statusColor(String(d.status))}`;
+                },
+            });
+        }
+        catch (err) {
+            handleError(out, err, 'Due dates failed');
+        }
+    });
+    // calendar set-due
+    addGlobalFlags(calendar.command('set-due')
+        .description('Set due date on a document')
+        .argument('<vaultId>', 'Vault ID')
+        .argument('<path>', 'Document path')
+        .requiredOption('--date <date>', 'Due date (YYYY-MM-DD or "clear")')
+        .option('--priority <priority>', 'Priority (low/medium/high)')
+        .option('--recurrence <recurrence>', 'Recurrence (daily/weekly/monthly/yearly)'))
+        .action(async (vaultId, path, _opts) => {
+        const flags = resolveFlags(_opts);
+        const out = createOutput(flags);
+        out.startSpinner('Setting due date...');
+        try {
+            const client = await getClientAsync();
+            const dateStr = _opts.date;
+            await client.calendar.setDocumentDue(vaultId, path, {
+                dueAt: dateStr === 'clear' ? null : new Date(dateStr).toISOString(),
+                priority: _opts.priority || null,
+                recurrence: _opts.recurrence || null,
+            });
+            out.stopSpinner();
+            out.status(dateStr === 'clear'
+                ? chalk.green(`Due date cleared for ${path}`)
+                : chalk.green(`Due date set to ${dateStr} for ${path}`));
+        }
+        catch (err) {
+            handleError(out, err, 'Set due date failed');
+        }
+    });
+    // calendar events
+    addGlobalFlags(calendar.command('events')
+        .description('List calendar events')
+        .argument('<vaultId>', 'Vault ID')
+        .option('--start <date>', 'Start date')
+        .option('--end <date>', 'End date'))
+        .action(async (vaultId, _opts) => {
+        const flags = resolveFlags(_opts);
+        const out = createOutput(flags);
+        out.startSpinner('Loading events...');
+        try {
+            const client = await getClientAsync();
+            const events = await client.calendar.listEvents(vaultId, {
+                start: _opts.start,
+                end: _opts.end,
+            });
+            out.stopSpinner();
+            out.list(events.map(e => ({
+                title: e.title,
+                startDate: e.startDate,
+                priority: e.priority || '-',
+                completed: e.completed ? '✓' : '-',
+            })), {
+                emptyMessage: 'No calendar events.',
+                columns: [
+                    { key: 'title', header: 'Title' },
+                    { key: 'startDate', header: 'Date' },
+                    { key: 'priority', header: 'Priority' },
+                    { key: 'completed', header: 'Done' },
+                ],
+                textFn: (e) => `${chalk.cyan(String(e.title))} — ${chalk.dim(String(e.startDate))}`,
+            });
+        }
+        catch (err) {
+            handleError(out, err, 'Calendar events failed');
+        }
+    });
+}
+function getDefaultStart() {
+    const d = new Date();
+    d.setDate(1);
+    return d.toISOString().split('T')[0];
+}
+function getDefaultEnd() {
+    const d = new Date();
+    d.setMonth(d.getMonth() + 1, 0);
+    return d.toISOString().split('T')[0];
+}

package/dist/commands/connectors.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerConnectorCommands(program) {
@@ -12,7 +12,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching connectors...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const connectorList = await client.connectors.list(_opts.vault);
             out.stopSpinner();
             out.list(connectorList.map(c => ({
@@ -48,7 +48,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const c = await client.connectors.get(connectorId);
             out.stopSpinner();
             out.record({
@@ -81,7 +81,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Creating connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const connector = await client.connectors.create({
                 provider: provider,
                 name,
@@ -109,7 +109,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Updating connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {};
             if (_opts.name)
                 params.name = _opts.name;
@@ -133,7 +133,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Deleting connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.connectors.delete(connectorId);
             out.success('Connector deleted.', { id: connectorId, deleted: true });
         }
@@ -149,7 +149,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Testing connection...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.connectors.test(connectorId);
             if (result.success) {
                 out.success('Connection test passed.', { success: true });
@@ -174,7 +174,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Triggering sync...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.connectors.sync(connectorId);
             out.success(result.message, { message: result.message });
         }
@@ -190,7 +190,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching sync logs...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const logs = await client.connectors.logs(connectorId);
             out.stopSpinner();
             out.list(logs.map(log => ({

package/dist/commands/docs.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { createCredentialManager } from '../lib/credential-manager.js';
@@ -18,7 +18,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching documents...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const documents = await client.documents.list(vaultId, _opts.dir);
             out.stopSpinner();
             out.list(documents.map(doc => ({
@@ -62,7 +62,7 @@ EXAMPLES
         const flags = resolveFlags(_opts);
         const out = createOutput(flags);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.documents.get(vaultId, docPath);
             // Auto-decrypt if the document is encrypted
             if (result.document.encrypted && !_opts.meta) {
@@ -119,7 +119,7 @@ EXAMPLES
                 process.stdin.on('end', () => resolve(data));
             });
             out.startSpinner('Uploading document...');
-            const client = getClient();
+            const client = await getClientAsync();
             // Check if vault is encrypted and auto-encrypt
             const vault = await client.vaults.get(vaultId);
             let doc;
@@ -157,7 +157,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Deleting document...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.documents.delete(vaultId, docPath);
             out.success(`Deleted: ${chalk.cyan(docPath)}`, { path: docPath, deleted: true });
         }
@@ -180,7 +180,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Moving document...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.documents.move(vaultId, source, dest, _opts.overwrite);
             out.success(`Moved: ${chalk.cyan(result.source)} -> ${chalk.cyan(result.destination)}`, {
                 source: result.source,