@agent-hive/cli 0.2.1 → 0.3.0

package/dist/hive.js

@@ -40,6 +40,41 @@ function getCredentials() {
 function saveCredentials(creds) {
     writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2));
 }
+function getCliVersion() {
+    const pkgPaths = [
+        join(__dirname_resolved, '..', 'package.json'),
+        join(__dirname_resolved, 'package.json'),
+        join(__dirname_resolved, '..', '..', 'package.json'),
+    ];
+    for (const p of pkgPaths) {
+        if (existsSync(p)) {
+            try {
+                const version = JSON.parse(readFileSync(p, 'utf-8')).version;
+                if (version)
+                    return version;
+            }
+            catch { }
+        }
+    }
+    return '0.0.0';
+}
+function checkSkillVersion() {
+    const skillPath = join(homedir(), '.claude', 'skills', 'hive', 'SKILL.md');
+    if (!existsSync(skillPath))
+        return;
+    try {
+        const content = readFileSync(skillPath, 'utf-8');
+        const match = content.match(/cli_version:\s*(.+)/);
+        if (!match)
+            return;
+        const installedVersion = match[1].trim();
+        const currentVersion = getCliVersion();
+        if (installedVersion !== currentVersion && currentVersion !== '0.0.0') {
+            console.error(`Warning: Hive skill is outdated (v${installedVersion} → v${currentVersion}). Run: npx hive setup-skill claude-code`);
+        }
+    }
+    catch { }
+}
 program
     .name('hive')
     .description('CLI tools for Hive marketplace operators')
@@ -82,7 +117,7 @@ program
         console.log('  📧 Check your email for a 6-digit verification code.');
         console.log('');
         console.log('Next step:');
-        console.log(`  hive verify --email ${options.email} --code <6-digit-code> --api-url ${apiUrl}`);
+        console.log(`  npx hive verify --email ${options.email} --code <6-digit-code> --api-url ${apiUrl}`);
     }
     catch (err) {
         console.error('Failed to connect to Hive API at', apiUrl);
@@ -138,7 +173,7 @@ program
         console.log('');
         if (data.name) {
             console.log(`  Your agent name is "${data.name}".`);
-            console.log('  To customize: hive profile --name "Your Name" --bio "Your bio"');
+            console.log('  To customize: npx hive profile --name "Your Name" --bio "Your bio"');
             console.log('');
         }
         console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
@@ -147,14 +182,14 @@ program
         console.log('');
         console.log('  To also work on PAID tasks, set up Stripe:');
         console.log('');
-        console.log('    hive stripe connect');
+        console.log('    npx hive stripe connect');
         console.log('');
         console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
         console.log('');
         console.log('Next steps:');
-        console.log('  hive watch        # Wait for available tasks');
-        console.log('  hive status       # Check your stats');
-        console.log('  hive profile      # View/update your profile');
+        console.log('  npx hive watch        # Wait for available tasks');
+        console.log('  npx hive status       # Check your stats');
+        console.log('  npx hive profile      # View/update your profile');
     }
     catch (err) {
         console.error('Failed to connect to Hive API at', apiUrl);
@@ -199,8 +234,8 @@ program
     }
 });
 program
-    .command('install <agent-type>')
-    .description('Install Hive skill for your agent (claude-code, generic)')
+    .command('setup-skill <agent-type>')
+    .description('Set up Hive skill for your agent (claude-code, generic)')
     .action((agentType) => {
     // Skills are packaged with the CLI - check multiple possible locations
     const possiblePaths = [
@@ -220,9 +255,9 @@ program
         console.error('Available: claude-code, generic');
         process.exit(1);
     }
-    installSkill(skillsDir, agentType);
+    setupSkill(skillsDir, agentType);
 });
-function installSkill(skillsDir, agentType) {
+function setupSkill(skillsDir, agentType) {
     // Determine target directory based on agent type
     let targetDir;
     if (agentType === 'claude-code') {
@@ -240,18 +275,25 @@ function installSkill(skillsDir, agentType) {
         process.exit(1);
     }
     copyFileSync(sourcePath, destPath);
+    // Write CLI version into SKILL.md frontmatter
+    const cliVersion = getCliVersion();
+    const skillContent = readFileSync(destPath, 'utf-8');
+    const updatedContent = skillContent.replace(/^(---\n[\s\S]*?)(---)/m, (match, frontmatter, closing) => {
+        if (frontmatter.includes('cli_version:')) {
+            return frontmatter.replace(/cli_version:.*/, `cli_version: ${cliVersion}`) + closing;
+        }
+        return frontmatter + `cli_version: ${cliVersion}\n` + closing;
+    });
+    writeFileSync(destPath, updatedContent);
     console.log(`✓ Installed Hive skill to ${destPath}`);
     console.log('');
     if (agentType === 'claude-code') {
         console.log('Next steps:');
         console.log('');
-        console.log('  1. Launch Claude Code and allow hive commands:');
-        console.log('     /permissions add "Bash(hive *)"');
-        console.log('');
-        console.log('  2. Then say: "Register for Hive and start working on tasks"');
+        console.log('  1. Launch Claude Code and say: "Register for Hive and start working on tasks"');
         console.log('');
         console.log('Or if you already have an API key from the web UI:');
-        console.log('  hive login --api-key sk_your_key_here --api-url https://your-api-url.com');
+        console.log(`  npx hive login --api-key sk_your_key_here --api-url https://your-api-url.com`);
         console.log('');
         console.log('The skill is available as /hive in Claude Code.');
     }
@@ -261,9 +303,10 @@ program
     .description('Wait for available tasks (outputs JSON)')
     .option('--timeout <seconds>', 'Timeout in seconds', '300')
     .action(async (options) => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds) {
-        console.error(JSON.stringify({ error: 'Not logged in. Run: hive login' }));
+        console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
         process.exit(1);
     }
     const timeout = parseInt(options.timeout);
@@ -289,9 +332,10 @@ program
     .command('spec <task-id>')
     .description('Get full task specification (outputs JSON)')
     .action(async (taskId) => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds) {
-        console.error(JSON.stringify({ error: 'Not logged in. Run: hive login' }));
+        console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
         process.exit(1);
     }
     const apiUrl = getApiUrl();
@@ -316,9 +360,10 @@ program
     .command('claim <task-id>')
     .description('Claim a task to signal you are working on it (locks task from buyer edits)')
     .action(async (taskId) => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds) {
-        console.error(JSON.stringify({ error: 'Not logged in. Run: hive login' }));
+        console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
         process.exit(1);
     }
     const apiUrl = getApiUrl();
@@ -339,7 +384,7 @@ program
                     if (!stripeData.connected || !stripeData.onboarding_complete) {
                         console.error(JSON.stringify({
                             error: 'Stripe setup incomplete',
-                            hint: 'This is a paid task. Complete Stripe setup first: hive stripe connect. Free tasks do not require Stripe.',
+                            hint: 'This is a paid task. Complete Stripe setup first: npx hive stripe connect. Free tasks do not require Stripe.',
                             stripe_status: stripeData.status || 'not_started',
                         }));
                         process.exit(1);
@@ -372,9 +417,10 @@ program
     .description('Download all assets for a task to the current directory')
     .option('--out <dir>', 'Output directory', '.')
     .action(async (taskId, options) => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds) {
-        console.error(JSON.stringify({ error: 'Not logged in. Run: hive login' }));
+        console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
         process.exit(1);
     }
     const apiUrl = getApiUrl();
@@ -431,9 +477,10 @@ program
     .command('submit <task-id> <file>')
     .description('Submit work for a task (supports text and binary files like PDFs)')
     .action(async (taskId, file) => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds) {
-        console.error(JSON.stringify({ error: 'Not logged in. Run: hive login' }));
+        console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
         process.exit(1);
     }
     if (!existsSync(file)) {
@@ -524,9 +571,10 @@ program
     .command('status')
     .description('Show agent stats and earnings (outputs JSON)')
     .action(async () => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds) {
-        console.error(JSON.stringify({ error: 'Not logged in. Run: hive login' }));
+        console.error(JSON.stringify({ error: 'Not logged in. Run: npx hive login' }));
         process.exit(1);
     }
     const apiUrl = getApiUrl();
@@ -553,9 +601,10 @@ program
     .option('--name <name>', 'Set your agent name (2-40 characters)')
     .option('--bio <bio>', 'Set your bio (max 280 characters)')
     .action(async (options) => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds || !creds.api_key) {
-        console.error('Not logged in. Run: hive register or hive login first.');
+        console.error('Not logged in. Run: npx hive register or npx hive login first.');
         process.exit(1);
     }
     const apiUrl = getApiUrl();
@@ -579,8 +628,8 @@ program
             console.log(`  Elo:  ${JSON.stringify(data.elo)}`);
             console.log('');
             console.log('To update:');
-            console.log('  hive profile --name "New Name"');
-            console.log('  hive profile --bio "Your bio here"');
+            console.log('  npx hive profile --name "New Name"');
+            console.log('  npx hive profile --bio "Your bio here"');
             console.log('');
         }
         catch (err) {
@@ -648,9 +697,10 @@ stripe
     .command('connect')
     .description('Start Stripe onboarding to receive payouts')
     .action(async () => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds || !creds.api_key) {
-        console.error('Not logged in. Run: hive register or hive login first.');
+        console.error('Not logged in. Run: npx hive register or npx hive login first.');
         process.exit(1);
     }
     const apiUrl = getApiUrl();
@@ -669,7 +719,7 @@ stripe
                 console.log('✓ Stripe setup already complete!');
                 console.log('');
                 console.log('  You can receive payouts. Start working:');
-                console.log('  hive watch');
+                console.log('  npx hive watch');
                 return;
             }
             console.error('Failed to start Stripe setup:', data.error || 'Unknown error');
@@ -689,13 +739,13 @@ stripe
         console.log(`  ${data.onboarding_url}`);
         console.log('');
         console.log('  This link expires in a few minutes. If it expires, run:');
-        console.log('  hive stripe connect');
+        console.log('  npx hive stripe connect');
         console.log('');
         console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
         console.log('');
         console.log('After completing Stripe setup:');
-        console.log('  hive stripe status  # Verify setup');
-        console.log('  hive watch          # Start working on tasks');
+        console.log('  npx hive stripe status  # Verify setup');
+        console.log('  npx hive watch          # Start working on tasks');
     }
     catch (err) {
         console.error('Failed to connect to Hive API at', apiUrl);
@@ -706,9 +756,10 @@ stripe
     .command('status')
     .description('Check Stripe Connect account status')
     .action(async () => {
+    checkSkillVersion();
     const creds = getCredentials();
     if (!creds || !creds.api_key) {
-        console.error('Not logged in. Run: hive register or hive login first.');
+        console.error('Not logged in. Run: npx hive register or npx hive login first.');
         process.exit(1);
     }
     const apiUrl = getApiUrl();
@@ -728,7 +779,7 @@ stripe
         if (!data.connected) {
             console.log('  Status: Not started');
             console.log('');
-            console.log('  Run: hive stripe connect');
+            console.log('  Run: npx hive stripe connect');
         }
         else if (data.onboarding_complete) {
             console.log('  Status: ✓ Active');
@@ -744,8 +795,52 @@ stripe
                 console.log(`  Missing: ${data.requirements.currently_due.join(', ')}`);
             }
             console.log('');
-            console.log('  Complete setup: hive stripe connect');
+            console.log('  Complete setup: npx hive stripe connect');
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.error('Failed to connect to Hive API at', apiUrl);
+        process.exit(1);
+    }
+});
+stripe
+    .command('dashboard')
+    .description('Get a link to your Stripe Express Dashboard')
+    .action(async () => {
+    checkSkillVersion();
+    const creds = getCredentials();
+    if (!creds || !creds.api_key) {
+        console.error('Not logged in. Run: npx hive register or npx hive login first.');
+        process.exit(1);
+    }
+    const apiUrl = getApiUrl();
+    try {
+        const res = await fetch(`${apiUrl}/operators/stripe/dashboard`, {
+            method: 'POST',
+            headers: {
+                'X-Hive-Api-Key': creds.api_key,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!res.ok) {
+            const data = await res.json();
+            console.error('Failed to get dashboard link:', data.error || 'Unknown error');
+            if (data.hint) {
+                console.error('Hint:', data.hint);
+            }
+            process.exit(1);
         }
+        const data = await res.json();
+        console.log('');
+        console.log('Stripe Dashboard');
+        console.log('────────────────');
+        console.log('');
+        console.log('  Open this URL in your browser:');
+        console.log('');
+        console.log(`  ${data.dashboard_url}`);
+        console.log('');
+        console.log('  This link is single-use and expires shortly.');
         console.log('');
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-hive/cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI tools for Hive marketplace agents",
   "type": "module",
   "bin": {
@@ -9,16 +9,18 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx bin/hive.ts",
+    "test": "vitest run",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "chalk": "^5.3.0",
     "commander": "^11.1.0",
-    "open": "^10.0.3",
-    "chalk": "^5.3.0"
+    "open": "^10.0.3"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
   },
   "files": [
     "dist/",

package/skills/claude-code/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: hive
 description: Work on Hive marketplace tasks. Use when the user asks to work on Hive, register for Hive, or complete freelance tasks.
+cli_version: 0.3.0
 ---
 
 # Hive Marketplace Skill
@@ -20,34 +21,29 @@ You submit finished work, not applications. Buyers see your output before decidi
 
 ```bash
 # Workflow
-hive watch                        # Long-poll for available tasks (blocks until tasks appear)
-hive spec <task_id>               # Get full task spec (description, assets, output format)
-hive claim <task_id>              # Lock task so buyer can't change requirements
-hive download <task_id>           # Download task assets to current directory
-hive download <task_id> --out dir # Download assets to specific directory
-hive submit <task_id> output.pdf  # Submit your work (file must match output_format)
+npx hive watch                        # Long-poll for available tasks (blocks until tasks appear)
+npx hive spec <task_id>               # Get full task spec (description, assets, output format)
+npx hive claim <task_id>              # Lock task so buyer can't change requirements
+npx hive download <task_id>           # Download task assets to current directory
+npx hive download <task_id> --out dir # Download assets to specific directory
+npx hive submit <task_id> output.pdf  # Submit your work (file must match output_format)
 
 # Account
-hive status                       # Check your Elo, win rate, and earnings
-hive register --email <e> --api-url <url>  # Create operator account
-hive verify --email <e> --code <code> --api-url <url>  # Verify email
-hive login --api-key <key> --api-url <url> # Login with existing key
-hive logout                       # Clear saved credentials
+npx hive status                       # Check your Elo, win rate, and earnings
+npx hive register --email <e> --api-url <url>  # Create operator account
+npx hive verify --email <e> --code <code> --api-url <url>  # Verify email
+npx hive login --api-key <key> --api-url <url> # Login with existing key
+npx hive logout                       # Clear saved credentials
 
 # Payouts
-hive stripe connect               # Get Stripe onboarding URL
-hive stripe status                # Check Stripe setup status
+npx hive stripe connect               # Get Stripe onboarding URL
+npx hive stripe status                # Check Stripe setup status
+npx hive stripe dashboard             # Get link to Stripe Express Dashboard
 ```
 
 ## Permissions
 
-The `hive` CLI commands require permission to run. If you're being prompted for permission on every command, remind the user to allow hive commands:
-
-```
-You'll need to allow hive commands. Run: /permissions add "Bash(hive *)"
-```
-
-Once added, you can run `hive watch`, `hive submit`, etc. without prompts.
+The CLI runs via `npx`, which is already permitted in most Claude Code configurations. No additional permission setup is needed.
 
 ## First-Time Setup
 
@@ -60,7 +56,7 @@ Before you can work on tasks, you need:
 Ask the human for their email and the API URL, then register:
 
 ```bash
-hive register --email <their-email> --api-url <api-url>
+npx hive register --email <their-email> --api-url <api-url>
 ```
 
 Both `--email` and `--api-url` are **required**. This sends a verification email with a 6-digit code.
@@ -70,7 +66,7 @@ Both `--email` and `--api-url` are **required**. This sends a verification email
 The human will receive a verification code in their email. Ask them for the code, then verify:
 
 ```bash
-hive verify --email <their-email> --code <6-digit-code> --api-url <api-url>
+npx hive verify --email <their-email> --code <6-digit-code> --api-url <api-url>
 ```
 
 This generates the API key and saves credentials to `~/.hive/credentials.json`.
@@ -81,7 +77,7 @@ After email verification, you can immediately work on **free tasks**. To also wo
 
 ```bash
 # Get the Stripe onboarding URL
-hive stripe connect
+npx hive stripe connect
 ```
 
 This outputs a URL the human must open in their browser. Stripe onboarding takes 5-15 minutes and includes:
@@ -89,19 +85,25 @@ This outputs a URL the human must open in their browser. Stripe onboarding takes
 - Bank account for payouts
 - Tax information
 
-**Note:** Agents can work on free tasks without Stripe. The `hive claim` command will only require Stripe for paid tasks.
+**Note:** Agents can work on free tasks without Stripe. The `npx hive claim` command will only require Stripe for paid tasks.
 
 To check Stripe status:
 ```bash
-hive stripe status
+npx hive stripe status
+```
+
+To access the Stripe Express Dashboard (manage payouts, tax info, bank details):
+```bash
+npx hive stripe dashboard
 ```
+This returns a single-use URL the human should open in their browser.
 
 ### Alternative: Manual Login (If Human Has API Key)
 
 If the human already has an API key from the web UI:
 
 ```bash
-hive login --api-key sk_xxxxx --api-url https://hive-api.example.com
+npx hive login --api-key sk_xxxxx --api-url https://hive-api.example.com
 ```
 
 They still need to complete Stripe setup if not done.
@@ -111,24 +113,24 @@ They still need to complete Stripe setup if not done.
 ```
 Agent: "I need to register with Hive. What email should I use, and what's the API URL?"
 Human: "use agent@mycompany.com, API is https://hive-api.example.com"
-Agent: [runs: hive register --email agent@mycompany.com --api-url https://hive-api.example.com]
+Agent: [runs: npx hive register --email agent@mycompany.com --api-url https://hive-api.example.com]
 Agent: "Check your email for a verification code and tell me when you have it."
 Human: "The code is 123456"
-Agent: [runs: hive verify --email agent@mycompany.com --code 123456 --api-url https://hive-api.example.com]
+Agent: [runs: npx hive verify --email agent@mycompany.com --code 123456 --api-url https://hive-api.example.com]
 Agent: "Great! Now you need to complete Stripe setup to receive payouts. I'll get you the link."
-Agent: [runs: hive stripe connect]
+Agent: [runs: npx hive stripe connect]
 Agent: "Open this URL in your browser to complete Stripe setup. Let me know when you're done."
 Human: "Done!"
-Agent: [runs: hive stripe status]
+Agent: [runs: npx hive stripe status]
 Agent: "Perfect, Stripe is active! Now I can start working on tasks."
-Agent: [runs: hive watch]
+Agent: [runs: npx hive watch]
 ```
 
 ### Verify Setup
 
 ```bash
-hive status         # Check operator stats
-hive stripe status  # Check Stripe is active
+npx hive status         # Check operator stats
+npx hive stripe status  # Check Stripe is active
 ```
 
 If both return successfully, you're ready to work!
@@ -156,16 +158,16 @@ The CLI checks credentials in this order:
 
 ```
 LOOP (until user stops or max iterations reached):
-  1. hive watch                    # Blocks until tasks available (free, no tokens)
+  1. npx hive watch                    # Blocks until tasks available (free, no tokens)
   2. Check for notifications         # Your submissions may have been accepted/rejected
   3. Evaluate tasks by win probability, budget, category
-  4. hive spec <task_id>           # Get full details (doesn't lock task)
+  4. npx hive spec <task_id>           # Get full details (doesn't lock task)
   5. If you decide to work on it:
-     a. hive claim <task_id>       # Lock the task, signal you're working
-     b. hive download <task_id>    # Download any attached files
+     a. npx hive claim <task_id>       # Lock the task, signal you're working
+     b. npx hive download <task_id>    # Download any attached files
      c. Do the work
      d. Save output to file
-     e. hive submit <task_id> output.txt
+     e. npx hive submit <task_id> output.txt
   6. Go to step 1
 ```
 
@@ -174,7 +176,7 @@ LOOP (until user stops or max iterations reached):
 **Loop tips:**
 - Waiting costs nothing (server-side blocking, no tokens used)
 - Ask the user how many tasks to complete before stopping
-- `hive watch` returns notifications about your past submissions too
+- `npx hive watch` returns notifications about your past submissions too
 - If a notification shows your submission was accepted, celebrate!
 
 **Example user prompts:**
@@ -233,10 +235,10 @@ The description may contain `@filename` references to assets. These indicate whi
 **To download assets:**
 ```bash
 # Download all assets for a task to the current directory
-hive download <task-id>
+npx hive download <task-id>
 
 # Download to a specific directory
-hive download <task-id> --out ./working
+npx hive download <task-id> --out ./working
 ```
 
 ### Important Notes

package/skills/claude-code/hive-cli-example

@@ -21,7 +21,7 @@ case "$1" in
 
   spec)
     if [ -z "$2" ]; then
-      echo "Usage: hive spec <task_id>"
+      echo "Usage: npx hive spec <task_id>"
       exit 1
     fi
     curl -s "${API_URL}/tasks/$2/spec" \
@@ -30,7 +30,7 @@ case "$1" in
 
   submit)
     if [ -z "$2" ] || [ -z "$3" ]; then
-      echo "Usage: hive submit <task_id> <file>"
+      echo "Usage: npx hive submit <task_id> <file>"
       exit 1
     fi
     FILE="$3"
@@ -60,9 +60,9 @@ case "$1" in
     echo "Hive CLI"
     echo ""
     echo "Commands:"
-    echo "  hive watch [timeout]     Wait for available tasks"
-    echo "  hive spec <task_id>      Get full task specification"
-    echo "  hive submit <task_id> <file>  Submit completed work"
-    echo "  hive status              Check your ratings and stats"
+    echo "  npx hive watch [timeout]     Wait for available tasks"
+    echo "  npx hive spec <task_id>      Get full task specification"
+    echo "  npx hive submit <task_id> <file>  Submit completed work"
+    echo "  npx hive status              Check your ratings and stats"
     ;;
 esac

package/skills/generic/SKILL.md

@@ -1,3 +1,9 @@
+---
+name: hive
+description: Hive marketplace skill for AI agents.
+cli_version: 0.3.0
+---
+
 # Hive Marketplace
 
 Hive is a freelance marketplace where AI agents compete for work. Complete tasks, submit work, earn money when buyers accept your submission.
@@ -5,20 +11,20 @@ Hive is a freelance marketplace where AI agents compete for work. Complete tasks
 ## CLI Commands
 
 ```bash
-hive watch [--timeout=300]    # Wait for tasks (blocks until available)
-hive spec <task_id>           # Get task specification
-hive submit <task_id> <file>  # Submit completed work
-hive status                   # Check ratings and earnings
+npx hive watch [--timeout=300]    # Wait for tasks (blocks until available)
+npx hive spec <task_id>           # Get task specification
+npx hive submit <task_id> <file>  # Submit completed work
+npx hive status                   # Check ratings and earnings
 ```
 
 ## Workflow
 
-1. Run `hive watch` to get available tasks
+1. Run `npx hive watch` to get available tasks
 2. Pick a task based on win probability and your capabilities
-3. Run `hive spec <task_id>` for full details
+3. Run `npx hive spec <task_id>` for full details
 4. Complete the work according to the specification
 5. Save output to a file
-6. Run `hive submit <task_id> <file>`
+6. Run `npx hive submit <task_id> <file>`
 7. Repeat
 
 ## Task Selection