codequiry-cli 2.0.0 → 2.1.0

package/README.md

@@ -1,6 +1,11 @@
-# Codequiry CLI
+# Codequiry CLI — Code Plagiarism Checker for the Terminal
 
-Source code similarity checker from your terminal. Detect plagiarism across 65+ programming languages.
+[![npm version](https://img.shields.io/npm/v/codequiry-cli.svg)](https://www.npmjs.com/package/codequiry-cli)
+[![license](https://img.shields.io/npm/l/codequiry-cli.svg)](https://github.com/cqchecker/codequiry-sdk/blob/main/LICENSE)
+
+Check code for plagiarism from your terminal with [Codequiry](https://codequiry.com), the code plagiarism checker. One command zips a folder, uploads it, runs source code plagiarism detection and peer code similarity analysis against billions of web sources, and prints the results. Works across 65+ programming languages, with AI-generated code detection available on every check.
+
+Built for professors, teaching assistants, bootcamps, hiring teams, and CI pipelines that need to verify code originality.
 
 ## Quick Install
 
@@ -69,6 +74,13 @@ codequiry scan ./src --output json
 
 ## Links
 
-- [Codequiry](https://codequiry.com)
-- [API Documentation](https://codequiry.com/usage/docs)
-- [Get API Key](https://codequiry.com/dashboard)
+- [Codequiry: code plagiarism checker](https://codequiry.com)
+- [API documentation](https://codequiry.com/usage/api)
+- [Get an API key](https://codequiry.com/dashboard)
+- [Node.js SDK](https://www.npmjs.com/package/codequiry) — the same API from your own code
+- [MCP server](https://codequiry.com/mcp) — plagiarism checks from Claude, Cursor, and other AI agents
+- [AI code detection](https://codequiry.com/detect-ai-written-code)
+
+## License
+
+MIT © [Codequiry](https://codequiry.com)

package/install/install.ps1

@@ -0,0 +1,46 @@
+Write-Host ""
+Write-Host "  +======================================+" -ForegroundColor Cyan
+Write-Host "  |     Codequiry CLI Installer          |" -ForegroundColor Cyan
+Write-Host "  +======================================+" -ForegroundColor Cyan
+Write-Host ""
+
+# Check Node.js
+try {
+    $nodeVersion = (node -v) -replace 'v', ''
+    $major = [int]($nodeVersion.Split('.')[0])
+
+    if ($major -lt 18) {
+        Write-Host "  X Node.js 18+ required (found v$nodeVersion)" -ForegroundColor Red
+        Write-Host "    Update from https://nodejs.org"
+        exit 1
+    }
+
+    Write-Host "  OK Node.js v$nodeVersion detected" -ForegroundColor Green
+} catch {
+    Write-Host "  X Node.js is not installed." -ForegroundColor Red
+    Write-Host "    Install Node.js 18+ from https://nodejs.org"
+    exit 1
+}
+
+# Check npm
+try {
+    $npmVersion = npm -v
+    Write-Host "  OK npm v$npmVersion detected" -ForegroundColor Green
+} catch {
+    Write-Host "  X npm is not installed." -ForegroundColor Red
+    exit 1
+}
+
+Write-Host ""
+Write-Host "  Installing codequiry-cli..."
+
+npm install -g codequiry-cli
+
+Write-Host ""
+Write-Host "  OK Codequiry CLI installed successfully!" -ForegroundColor Green
+Write-Host ""
+Write-Host "  Get started:"
+Write-Host "    codequiry auth     # Set your API key"
+Write-Host "    codequiry scan .   # Scan current directory"
+Write-Host "    codequiry          # Interactive mode"
+Write-Host ""

package/install/install.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+set -e
+
+echo ""
+echo "  ╔══════════════════════════════════════╗"
+echo "  ║     Codequiry CLI Installer          ║"
+echo "  ╚══════════════════════════════════════╝"
+echo ""
+
+# Check Node.js
+if ! command -v node &> /dev/null; then
+    echo "  ✖ Node.js is not installed."
+    echo "    Install Node.js 18+ from https://nodejs.org"
+    exit 1
+fi
+
+NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo "  ✖ Node.js 18+ required (found v$(node -v))"
+    echo "    Update from https://nodejs.org"
+    exit 1
+fi
+
+echo "  ✔ Node.js $(node -v) detected"
+
+# Check npm
+if ! command -v npm &> /dev/null; then
+    echo "  ✖ npm is not installed."
+    exit 1
+fi
+
+echo "  ✔ npm $(npm -v) detected"
+echo ""
+
+# Install
+echo "  Installing codequiry-cli..."
+npm install -g codequiry-cli
+
+echo ""
+echo "  ✔ Codequiry CLI installed successfully!"
+echo ""
+echo "  Get started:"
+echo "    codequiry auth     # Set your API key"
+echo "    codequiry scan .   # Scan current directory"
+echo "    codequiry          # Interactive mode"
+echo ""

package/package.json

@@ -1,11 +1,18 @@
 {
   "name": "codequiry-cli",
-  "version": "2.0.0",
-  "description": "Codequiry CLI - Source code similarity checker",
+  "version": "2.1.0",
+  "description": "Codequiry CLI - code plagiarism checker for the terminal: source code plagiarism detection, peer code similarity, and AI-generated code detection across 65+ languages",
   "main": "src/index.js",
   "bin": {
     "codequiry": "./bin/codequiry.js"
   },
+  "files": [
+    "bin",
+    "src",
+    "install",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "start": "node bin/codequiry.js",
     "test": "echo \"No tests yet\""
@@ -13,11 +20,28 @@
   "keywords": [
     "codequiry",
     "plagiarism",
+    "plagiarism-checker",
+    "code-plagiarism",
+    "code-plagiarism-checker",
     "code-similarity",
+    "similarity-detection",
+    "source-code-plagiarism",
+    "ai-code-detection",
+    "academic-integrity",
+    "moss",
+    "moss-alternative",
     "cli"
   ],
-  "author": "Codequiry",
+  "author": "Codequiry <contact@codequiry.com> (https://codequiry.com)",
   "license": "MIT",
+  "homepage": "https://codequiry.com/sdks",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cqchecker/codequiry-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cqchecker/codequiry-sdk/issues"
+  },
   "dependencies": {
     "commander": "^12.0.0",
     "inquirer": "^8.2.6",

package/src/commands/account.js

@@ -6,46 +6,62 @@ const ora = require('ora');
 const { requireAuth } = require('../utils/errors');
 const { getAccount } = require('../api/endpoints');
 
+const accent = chalk.hex('#8b5cf6');
+const dim = chalk.dim;
+
 async function accountCommand() {
   requireAuth();
 
-  const spinner = ora('Fetching account info...').start();
+  const spinner = ora({ text: 'Fetching account info...', spinner: 'dots12', color: 'magenta' }).start();
 
   try {
-    const account = await getAccount();
+    const data = await getAccount();
     spinner.stop();
 
-    const user = account.user || account;
-    const plan = user.plan_name || user.plan || 'Free';
-    const checksUsed = user.checks_used ?? user.procheck_used ?? 0;
-    const checksLimit = user.checks_limit ?? user.procheck_limit ?? 0;
-    const quotaPct = checksLimit > 0 ? Math.round((checksUsed / checksLimit) * 100) : 0;
+    const name = data.name || 'N/A';
+    const email = data.email || 'N/A';
+    const isPro = data.is_pro;
+    const planLabel = isPro ? accent.bold('Pro') : dim('Free');
+    const quota = data.quota || {};
+    const remaining = quota.remaining ?? 0;
+    const isUnlimited = quota.unlimited || false;
+
+    const quotaDisplay = isUnlimited
+      ? chalk.green.bold('Unlimited')
+      : chalk.white.bold(String(remaining));
+
     const barLen = 20;
-    const filled = Math.round((quotaPct / 100) * barLen);
-    const quotaBar = chalk.green('█'.repeat(filled)) + chalk.dim('░'.repeat(barLen - filled));
+    let quotaBar = '';
+    if (!isUnlimited) {
+      const total = quota.total || Math.max(remaining, 100);
+      const filled = Math.round((remaining / total) * barLen);
+      quotaBar = chalk.green('━'.repeat(filled)) + dim('─'.repeat(barLen - filled));
+    }
 
     const content = [
-      chalk.bold('Account'),
+      accent.bold('  Account'),
       '',
-      `${chalk.dim('Name:')}    ${user.name || user.email || 'N/A'}`,
-      `${chalk.dim('Email:')}   ${user.email || 'N/A'}`,
-      `${chalk.dim('Plan:')}    ${chalk.cyan(plan)}`,
+      `  ${dim('Name')}     ${chalk.white.bold(name)}`,
+      `  ${dim('Email')}    ${chalk.white(email)}`,
+      `  ${dim('Plan')}     ${planLabel}`,
+      `  ${dim('EDU')}      ${data.edu_verified ? chalk.green('✓ Verified') : dim('Not verified')}`,
       '',
-      chalk.bold('Usage'),
+      accent.bold('  Quota'),
       '',
-      `${chalk.dim('Checks:')}  ${checksUsed} / ${checksLimit}`,
-      `          ${quotaBar} ${quotaPct}%`,
-    ].join('\n');
+      `  ${dim('Remaining')}  ${quotaDisplay}`,
+      isUnlimited ? '' : `  ${dim('Usage')}      ${quotaBar}`,
+    ].filter(Boolean).join('\n');
 
     console.log(
       '\n' +
-        boxen(content, {
-          padding: 1,
-          margin: 1,
-          borderStyle: 'round',
-          borderColor: 'cyan',
-        }) +
-        '\n'
+      boxen(content, {
+        padding: { top: 1, bottom: 1, left: 0, right: 2 },
+        margin: { top: 0, bottom: 0, left: 1, right: 0 },
+        borderStyle: 'round',
+        borderColor: '#8b5cf6',
+        dimBorder: true,
+      }) +
+      '\n'
     );
   } catch (error) {
     spinner.fail('Failed to fetch account info.');

package/src/commands/create.js

@@ -13,20 +13,35 @@ async function createCommand(options) {
   let languageId = options.language;
   let testType = options.testType;
 
-  // Fetch languages and test types
-  const spinner = ora('Loading options...').start();
-  let languages, testTypes;
+  // If all options provided via flags, skip fetching options
+  let langList = [];
+  let typeList = [];
 
-  try {
-    [languages, testTypes] = await Promise.all([getLanguages(), getTestTypes()]);
-    spinner.stop();
-  } catch (error) {
-    spinner.fail('Failed to load options.');
-    return;
-  }
+  if (!languageId || !testType) {
+    const spinner = ora('Loading options...').start();
+    try {
+      const fetches = [];
+      fetches.push(!languageId ? getLanguages() : Promise.resolve(null));
+      fetches.push(!testType ? getTestTypes().catch(() => null) : Promise.resolve(null));
+      const [languages, testTypes] = await Promise.all(fetches);
+      spinner.stop();
 
-  const langList = Array.isArray(languages) ? languages : languages?.languages || [];
-  const typeList = Array.isArray(testTypes) ? testTypes : testTypes?.test_types || [];
+      if (languages) {
+        langList = Array.isArray(languages) ? languages : languages?.languages || [];
+      }
+      if (testTypes) {
+        typeList = Array.isArray(testTypes) ? testTypes : testTypes?.test_types || [];
+      }
+
+      if (!languageId && langList.length === 0) {
+        spinner.fail('Failed to load languages.');
+        return;
+      }
+    } catch (error) {
+      spinner.fail('Failed to load options.');
+      return;
+    }
+  }
 
   // Interactive prompts for missing options
   const questions = [];
@@ -46,22 +61,27 @@ async function createCommand(options) {
       name: 'languageId',
       message: 'Programming language:',
       choices: langList.map((l) => ({
-        name: l.name || l.language,
+        name: l.language || l.name,
         value: l.id,
       })),
     });
   }
 
   if (!testType) {
-    questions.push({
-      type: 'list',
-      name: 'testType',
-      message: 'Check engine:',
-      choices: typeList.map((t) => ({
-        name: t.name || t.type,
-        value: t.id,
-      })),
-    });
+    if (typeList.length > 0) {
+      questions.push({
+        type: 'list',
+        name: 'testType',
+        message: 'Check engine:',
+        choices: typeList.map((t) => ({
+          name: t.name || t.type,
+          value: t.id,
+        })),
+      });
+    } else {
+      // Fallback: use default engine if test types API failed
+      testType = 1;
+    }
   }
 
   if (questions.length > 0) {
@@ -75,8 +95,9 @@ async function createCommand(options) {
 
   try {
     const result = await createCheck(name, languageId, testType);
-    createSpinner.succeed(`Check created: ${chalk.cyan(result.check?.name || name)} (ID: ${result.check?.id || 'N/A'})`);
-    return result.check || result;
+    // API returns the Assignment object directly
+    createSpinner.succeed(`Check created: ${chalk.cyan(result.name || name)} (ID: ${result.id || 'N/A'})`);
+    return result;
   } catch (error) {
     createSpinner.fail('Failed to create check.');
   }

package/src/commands/results.js

@@ -27,7 +27,7 @@ async function resultsCommand(options) {
 
     // Filter to completed checks
     const completed = checks.filter(
-      (c) => c.status === 5 || c.status_name === 'Completed' || c.status === 'completed'
+      (c) => c.status_id === 4 || c.assignmentstatuses?.status === 'Completed'
     );
 
     if (completed.length === 0) {
@@ -88,8 +88,8 @@ async function resultsCommand(options) {
           name: 'submissionId',
           message: 'Select a submission:',
           choices: submissions.map((s) => ({
-            name: `${s.id || s.submission_id} - ${s.filename || s.name}`,
-            value: s.id || s.submission_id,
+            name: `${s.id} - ${s.filename || 'unknown'}`,
+            value: s.id,
           })),
         },
       ]);
@@ -103,7 +103,8 @@ async function resultsCommand(options) {
         detailSpinner.fail('Failed to fetch details.');
       }
     } else if (action === 'browser') {
-      await open(`https://codequiry.com/results/${checkId}`);
+      const url = overview?.overviewURL || `https://codequiry.com/results/${checkId}`;
+      await open(url);
       console.log(chalk.dim('  Opened in browser.\n'));
     }
   }

package/src/commands/scan.js

@@ -5,11 +5,17 @@ const chalk = require('chalk');
 const inquirer = require('inquirer');
 const ora = require('ora');
 const { requireAuth } = require('../utils/errors');
-const { getLanguages, getTestTypes, createCheck, uploadZip, uploadBatch, startCheck } = require('../api/endpoints');
+const { getLanguages, getTestTypes, createCheck, uploadZip, uploadBatch, startCheck, getOverview } = require('../api/endpoints');
 const { prepareUploads, cleanupTempFiles } = require('../utils/zipper');
 const { pollUntilComplete } = require('../utils/poller');
 const { overviewTable } = require('../utils/display');
-const { getOverview } = require('../api/endpoints');
+
+const accent = chalk.hex('#8b5cf6');
+const dim = chalk.dim;
+
+function spin(text) {
+  return ora({ text, spinner: 'dots12', color: 'magenta' });
+}
 
 async function scanCommand(inputPath, options) {
   requireAuth();
@@ -39,6 +45,13 @@ async function scanCommand(inputPath, options) {
   }
 
   const resolvedPath = path.resolve(inputPath);
+  const startTime = Date.now();
+
+  if (!isJson) {
+    console.log('');
+    console.log('  ' + accent.bold('codequiry scan') + dim(' · ' + resolvedPath));
+    console.log('');
+  }
 
   // 2. Get language + test type
   let languageId = options.language;
@@ -46,69 +59,82 @@ async function scanCommand(inputPath, options) {
   let checkName = options.name || path.basename(resolvedPath);
 
   if (!languageId || !testType) {
-    const spinner = ora('Loading options...').start();
-    let languages, testTypes;
+    const spinner = spin('Loading options...').start();
+    let langList = [];
+    let typeList = [];
     try {
-      [languages, testTypes] = await Promise.all([getLanguages(), getTestTypes()]);
+      const fetches = [];
+      fetches.push(!languageId ? getLanguages() : Promise.resolve(null));
+      fetches.push(!testType ? getTestTypes().catch(() => null) : Promise.resolve(null));
+      const [languages, testTypes] = await Promise.all(fetches);
       spinner.stop();
+
+      if (languages) {
+        langList = Array.isArray(languages) ? languages : languages?.languages || [];
+      }
+      if (testTypes) {
+        typeList = Array.isArray(testTypes) ? testTypes : testTypes?.test_types || [];
+      }
+
+      if (!languageId && langList.length === 0) {
+        spinner.fail('Failed to load languages.');
+        process.exit(1);
+      }
     } catch (error) {
       spinner.fail('Failed to load options.');
       process.exit(1);
     }
 
-    const langList = Array.isArray(languages) ? languages : languages?.languages || [];
-    const typeList = Array.isArray(testTypes) ? testTypes : testTypes?.test_types || [];
-
     if (isTTY) {
-      const answers = await inquirer.prompt([
-        ...(!languageId
-          ? [
-              {
-                type: 'list',
-                name: 'languageId',
-                message: 'Programming language:',
-                choices: langList.map((l) => ({ name: l.name || l.language, value: l.id })),
-              },
-            ]
-          : []),
-        ...(!testType
-          ? [
-              {
-                type: 'list',
-                name: 'testType',
-                message: 'Check engine:',
-                choices: typeList.map((t) => ({ name: t.name || t.type, value: t.id })),
-              },
-            ]
-          : []),
-      ]);
-      languageId = languageId || answers.languageId;
-      testType = testType || answers.testType;
+      const prompts = [];
+      if (!languageId) {
+        prompts.push({
+          type: 'list',
+          name: 'languageId',
+          message: 'Programming language:',
+          pageSize: 15,
+          choices: langList.map((l) => ({ name: l.language || l.name, value: l.id })),
+        });
+      }
+      if (!testType && typeList.length > 0) {
+        prompts.push({
+          type: 'list',
+          name: 'testType',
+          message: 'Check engine:',
+          choices: typeList.map((t) => ({ name: t.name || t.type, value: t.id })),
+        });
+      }
+      if (prompts.length > 0) {
+        const answers = await inquirer.prompt(prompts);
+        languageId = languageId || answers.languageId;
+        testType = testType || answers.testType;
+      }
     } else {
-      // Non-TTY: use defaults
       languageId = languageId || (langList[0] && langList[0].id);
       testType = testType || (typeList[0] && typeList[0].id);
     }
+
+    if (!testType) testType = 1;
   }
 
   // 3. Zip
-  const zipSpinner = ora('Preparing files...').start();
+  const zipSpinner = spin('Preparing files...').start();
   let zipFiles;
   try {
     zipFiles = await prepareUploads(resolvedPath);
-    zipSpinner.succeed(`Prepared ${zipFiles.length} file(s)`);
+    zipSpinner.succeed(`Prepared ${accent.bold(zipFiles.length)} file(s)`);
   } catch (error) {
     zipSpinner.fail('Failed to prepare files: ' + error.message);
     process.exit(1);
   }
 
   // 4. Create check
-  const createSpinner = ora('Creating check...').start();
+  const createSpinner = spin('Creating check...').start();
   let check;
   try {
     const result = await createCheck(checkName, languageId, testType);
-    check = result.check || result;
-    createSpinner.succeed(`Check created: ${chalk.cyan(check.name || checkName)} (ID: ${check.id})`);
+    check = result;
+    createSpinner.succeed(`Check created ${dim('·')} ${accent(check.name || checkName)} ${dim('#' + check.id)}`);
   } catch (error) {
     createSpinner.fail('Failed to create check.');
     cleanupTempFiles(zipFiles);
@@ -116,7 +142,7 @@ async function scanCommand(inputPath, options) {
   }
 
   // 5. Upload
-  const uploadSpinner = ora('Uploading files...').start();
+  const uploadSpinner = spin('Uploading files...').start();
   try {
     if (zipFiles.length === 1) {
       await uploadZip(check.id, zipFiles[0]);
@@ -124,10 +150,11 @@ async function scanCommand(inputPath, options) {
       for (let i = 0; i < zipFiles.length; i += 50) {
         const chunk = zipFiles.slice(i, i + 50);
         await uploadBatch(check.id, chunk);
-        uploadSpinner.text = `Uploading... (${Math.min(i + 50, zipFiles.length)}/${zipFiles.length})`;
+        const done = Math.min(i + 50, zipFiles.length);
+        uploadSpinner.text = `Uploading... ${accent(done + '/' + zipFiles.length)}`;
       }
     }
-    uploadSpinner.succeed(`Uploaded ${zipFiles.length} file(s)`);
+    uploadSpinner.succeed(`Uploaded ${accent.bold(zipFiles.length)} file(s)`);
   } catch (error) {
     uploadSpinner.fail('Upload failed.');
     cleanupTempFiles(zipFiles);
@@ -140,10 +167,10 @@ async function scanCommand(inputPath, options) {
   const webcheck = options.web ? 1 : 0;
   const dbcheck = options.db ? 1 : 0;
 
-  const startSpinner = ora('Starting check...').start();
+  const startSpinner = spin('Starting check...').start();
   try {
     await startCheck(check.id, webcheck, dbcheck);
-    startSpinner.succeed('Check started!');
+    startSpinner.succeed('Check started');
   } catch (error) {
     startSpinner.fail('Failed to start check.');
     process.exit(1);
@@ -157,30 +184,37 @@ async function scanCommand(inputPath, options) {
   if (finalStatus) {
     try {
       const overview = await getOverview(check.id);
+      const elapsed = Math.round((Date.now() - startTime) / 1000);
+      const elapsedStr = elapsed < 60 ? `${elapsed}s` : `${Math.floor(elapsed / 60)}m ${elapsed % 60}s`;
 
       if (isJson) {
         console.log(JSON.stringify(overview, null, 2));
       } else {
-        console.log(chalk.bold('\n  Results'));
+        console.log('');
+        console.log('  ' + chalk.bold('Results') + dim(` · completed in ${elapsedStr}`));
         overviewTable(overview);
-        console.log(
-          chalk.dim(`  View full results: https://codequiry.com/results/${check.id}\n`)
-        );
+
+        const url = overview?.overviewURL || `https://codequiry.com/results/${check.id}`;
+        console.log(dim(`  Full results: ${url}`));
+        console.log('');
       }
 
-      // Exit code based on results for CI
+      // Exit code for CI threshold
       if (options.threshold) {
         const submissions = overview?.submissions || overview || [];
         const maxScore = Math.max(
-          ...submissions.map((s) => parseFloat(s.result_score || s.similarity || 0))
+          ...submissions.map((s) => parseFloat(s.result1 || s.total_result || 0))
         );
         if (maxScore > parseFloat(options.threshold)) {
+          if (!isJson) {
+            console.log(chalk.red(`  Threshold exceeded: ${maxScore.toFixed(1)}% > ${options.threshold}%`));
+          }
           process.exit(1);
         }
       }
     } catch (error) {
       if (!isJson) {
-        console.log(chalk.dim(`\n  View results at: https://codequiry.com/results/${check.id}\n`));
+        console.log(dim(`\n  View results at: https://codequiry.com/results/${check.id}\n`));
       }
     }
   }

package/src/commands/status.js

@@ -53,8 +53,8 @@ async function statusCommand(options) {
     try {
       const status = await getCheckStatus(checkId);
       spinner.stop();
-      const s = status?.status_name || status?.status || 'Unknown';
-      const p = status?.progress ?? status?.percentage ?? '';
+      const s = status?.status || 'Unknown';
+      const p = status?.progress ?? '';
       console.log(`\n  Check ${chalk.cyan(checkId)}: ${statusColor(s)}${p ? ` (${p}%)` : ''}\n`);
     } catch (error) {
       spinner.fail('Failed to fetch status.');

package/src/index.js

@@ -1,12 +1,16 @@
 'use strict';
 
 const { Command } = require('commander');
+const { checkForUpdate } = require('./utils/update-check');
 const program = new Command();
 
+// Start update check in background (non-blocking)
+const updater = checkForUpdate();
+
 program
   .name('codequiry')
   .description('Codequiry CLI - Source Code Similarity Checker')
-  .version('2.0.0');
+  .version('2.1.0');
 
 // Auth command
 program
@@ -120,13 +124,21 @@ program
     await scanCommand(inputPath, options);
   });
 
-// Default: interactive TUI when no args
-if (process.argv.length <= 2) {
-  const { mainMenu } = require('./ui/menu');
-  mainMenu().catch((err) => {
-    console.error(err.message);
-    process.exit(1);
-  });
-} else {
-  program.parse(process.argv);
+// Show update notice when process exits
+process.on('exit', () => {});
+async function run() {
+  if (process.argv.length <= 2) {
+    // Interactive TUI when no args
+    const { mainMenu } = require('./ui/menu');
+    await mainMenu();
+  } else {
+    await program.parseAsync(process.argv);
+  }
+  // Show update notice after command completes
+  await updater.notify();
 }
+
+run().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/src/ui/menu.js

@@ -4,12 +4,17 @@ const chalk = require('chalk');
 const inquirer = require('inquirer');
 const { showBanner } = require('../utils/banner');
 const { isAuthenticated } = require('../utils/config');
+const { checkForUpdate } = require('../utils/update-check');
+
+const accent = chalk.hex('#8b5cf6');
+const dim = chalk.dim;
 
 async function mainMenu() {
+  const updater = checkForUpdate();
   showBanner();
 
   if (!isAuthenticated()) {
-    console.log(chalk.yellow('  You need to authenticate first.\n'));
+    console.log(chalk.yellow('  Not authenticated yet.\n'));
     const authCommand = require('../commands/auth');
     await authCommand({});
     if (!isAuthenticated()) return;
@@ -23,19 +28,22 @@ async function mainMenu() {
       {
         type: 'list',
         name: 'action',
-        message: 'What would you like to do?',
+        message: accent('What would you like to do?'),
+        pageSize: 12,
         choices: [
-          { name: '🔍  Scan - Analyze code similarity', value: 'scan' },
-          { name: '📋  Checks - View all checks', value: 'checks' },
-          { name: '➕  Create - New check', value: 'create' },
-          { name: '📤  Upload - Upload files to a check', value: 'upload' },
-          { name: '▶️   Start - Start a check', value: 'start' },
-          { name: '📊  Status - Check progress', value: 'status' },
-          { name: '📈  Results - View results', value: 'results' },
-          { name: '👤  Account - Account info', value: 'account' },
-          { name: '🔑  Auth - Manage API key', value: 'auth' },
-          new inquirer.Separator(),
-          { name: '🚪  Exit', value: 'exit' },
+          new inquirer.Separator(dim('─── Commands ────────────────')),
+          { name: accent.bold(' scan     ') + dim('Full scan: zip, upload, check, results'), value: 'scan' },
+          { name: accent.bold(' checks   ') + dim('List all your checks'), value: 'checks' },
+          { name: accent.bold(' create   ') + dim('Create a new check'), value: 'create' },
+          { name: accent.bold(' upload   ') + dim('Upload files to a check'), value: 'upload' },
+          { name: accent.bold(' start    ') + dim('Start a check'), value: 'start' },
+          { name: accent.bold(' status   ') + dim('Check progress'), value: 'status' },
+          { name: accent.bold(' results  ') + dim('View similarity results'), value: 'results' },
+          new inquirer.Separator(dim('─── Settings ────────────────')),
+          { name: accent.bold(' account  ') + dim('Account info & quota'), value: 'account' },
+          { name: accent.bold(' auth     ') + dim('Manage API key'), value: 'auth' },
+          new inquirer.Separator(dim('─────────────────────────────')),
+          { name: dim(' exit'), value: 'exit' },
         ],
       },
     ]);
@@ -73,11 +81,16 @@ async function mainMenu() {
           break;
         case 'exit':
           running = false;
-          console.log(chalk.dim('  Goodbye!\n'));
+          await updater.notify();
+          console.log(dim('  See you next time.\n'));
           break;
       }
     } catch (error) {
-      console.error(chalk.red('\n  Error: ' + error.message + '\n'));
+      console.error(chalk.red('\n  Error: ') + error.message + '\n');
+    }
+
+    if (running) {
+      console.log(''); // Breathing room between commands
     }
   }
 }

package/src/utils/banner.js

@@ -1,20 +1,50 @@
 'use strict';
 
-const figlet = require('figlet');
-const gradient = require('gradient-string');
 const chalk = require('chalk');
+const gradient = require('gradient-string');
+
+// Premium gradient palette
+const cqGradient = gradient(['#6366f1', '#8b5cf6', '#a78bfa']);
 
 function showBanner() {
+  const logo = [
+    '',
+    '   ██████╗ ██████╗ ██████╗ ███████╗ ██████╗ ██╗   ██╗██╗██████╗ ██╗   ██╗',
+    '  ██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔═══██╗██║   ██║██║██╔══██╗╚██╗ ██╔╝',
+    '  ██║     ██║   ██║██║  ██║█████╗  ██║   ██║██║   ██║██║██████╔╝ ╚████╔╝ ',
+    '  ██║     ██║   ██║██║  ██║██╔══╝  ██║▄▄ ██║██║   ██║██║██╔══██╗  ╚██╔╝  ',
+    '  ╚██████╗╚██████╔╝██████╔╝███████╗╚██████╔╝╚██████╔╝██║██║  ██║   ██║   ',
+    '   ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝ ╚══▀▀═╝  ╚═════╝ ╚═╝╚═╝  ╚═╝   ╚═╝   ',
+    '',
+  ];
+
   try {
-    const text = figlet.textSync('Codequiry', {
-      font: 'Standard',
-      horizontalLayout: 'default',
-    });
-    console.log(gradient.vice(text));
-    console.log(chalk.dim('  Source Code Similarity Checker') + '  ' + chalk.dim('v2.0.0\n'));
+    logo.forEach(line => console.log(cqGradient(line)));
   } catch {
-    console.log(gradient.vice('\n  Codequiry CLI v2.0.0\n'));
+    // Fallback for terminals that don't support gradients
+    logo.forEach(line => console.log(chalk.hex('#8b5cf6')(line)));
   }
+
+  console.log(
+    chalk.dim('  Code Plagiarism Detection') +
+    '  ' +
+    chalk.hex('#8b5cf6').bold('v2.1.0') +
+    chalk.dim('  ·  ') +
+    chalk.dim('codequiry.com')
+  );
+  console.log('');
+}
+
+function showCompactBanner() {
+  console.log('');
+  console.log(
+    '  ' +
+    cqGradient('▌') +
+    ' ' +
+    chalk.bold('codequiry') +
+    chalk.dim(' v2.1.0')
+  );
+  console.log('');
 }
 
-module.exports = { showBanner };
+module.exports = { showBanner, showCompactBanner };

package/src/utils/display.js

@@ -3,114 +3,185 @@
 const Table = require('cli-table3');
 const chalk = require('chalk');
 
+// Color palette matching modern CLI tools
+const dim = chalk.dim;
+const bold = chalk.bold;
+const accent = chalk.hex('#8b5cf6');
+const muted = chalk.hex('#6b7280');
+
 function colorScore(score) {
   const num = parseFloat(score);
-  if (isNaN(num)) return chalk.dim(score);
-  if (num > 70) return chalk.red.bold(num.toFixed(1) + '%');
-  if (num > 30) return chalk.yellow(num.toFixed(1) + '%');
-  return chalk.green(num.toFixed(1) + '%');
+  if (isNaN(num)) return dim(score);
+  const str = num.toFixed(1) + '%';
+  if (num >= 70) return chalk.red.bold(str);
+  if (num >= 40) return chalk.yellow(str);
+  if (num >= 20) return chalk.hex('#fb923c')(str);  // orange
+  return chalk.green(str);
+}
+
+function scoreBar(score, width = 16) {
+  const num = parseFloat(score);
+  if (isNaN(num)) return '';
+  const filled = Math.round((num / 100) * width);
+  const empty = width - filled;
+  let color = chalk.green;
+  if (num >= 70) color = chalk.red;
+  else if (num >= 40) color = chalk.yellow;
+  else if (num >= 20) color = chalk.hex('#fb923c');
+  return color('█'.repeat(filled)) + dim('░'.repeat(empty));
 }
 
 function statusColor(status) {
   const s = String(status).toLowerCase();
-  if (s === 'completed' || s === 'done') return chalk.green(status);
-  if (s === 'processing' || s === 'running' || s === 'in_progress') return chalk.yellow(status);
-  if (s === 'failed' || s === 'error') return chalk.red(status);
-  return chalk.dim(status);
+  if (s === 'completed' || s === 'done') return chalk.green('● ') + chalk.green(status);
+  if (s === 'checking' || s === 'waiting' || s === 'uploading') return chalk.yellow('◌ ') + chalk.yellow(status);
+  if (s === 'failed' || s === 'error') return chalk.red('✖ ') + chalk.red(status);
+  if (s === 'new check') return dim('○ ') + dim(status);
+  return dim(status);
 }
 
 function checksTable(checks) {
-  const table = new Table({
-    head: [
-      chalk.cyan('ID'),
-      chalk.cyan('Name'),
-      chalk.cyan('Language'),
-      chalk.cyan('Status'),
-      chalk.cyan('Submissions'),
-      chalk.cyan('Created'),
-    ],
-    style: { head: [], border: ['dim'] },
-  });
-
-  const list = Array.isArray(checks) ? checks : checks?.checks || [];
+  const list = Array.isArray(checks) ? checks : [];
 
   if (list.length === 0) {
-    console.log(chalk.dim('\n  No checks found.\n'));
+    console.log('');
+    console.log(muted('  No checks found. Create one with ') + accent('codequiry create'));
+    console.log('');
     return;
   }
 
+  const table = new Table({
+    head: [
+      dim('#'),
+      dim('Name'),
+      dim('Lang'),
+      dim('Status'),
+      dim('Created'),
+    ],
+    style: { head: [], border: ['dim'], compact: true },
+    colWidths: [9, 38, 8, 14, 12],
+    wordWrap: true,
+  });
+
   list.forEach((c) => {
+    const statusName = c.assignmentstatuses?.status || 'Unknown';
     table.push([
-      chalk.white(c.id),
-      c.name || '',
-      c.language_name || c.language || '',
-      statusColor(c.status_name || c.status || ''),
-      String(c.submission_count || c.submissions || 0),
-      c.created_at ? new Date(c.created_at).toLocaleDateString() : '',
+      accent(String(c.id)),
+      c.name || dim('Untitled'),
+      dim(String(c.language_id || '–')),
+      statusColor(statusName),
+      c.created_at ? dim(new Date(c.created_at).toLocaleDateString()) : dim('–'),
     ]);
   });
 
-  console.log('\n' + table.toString() + '\n');
+  console.log('');
+  console.log(
+    '  ' + bold('Your Checks') +
+    dim(` (${list.length} total)`)
+  );
+  console.log(table.toString());
 }
 
 function overviewTable(overview) {
-  const submissions = overview?.submissions || overview || [];
+  const submissions = overview?.submissions || [];
 
   if (!Array.isArray(submissions) || submissions.length === 0) {
-    console.log(chalk.dim('\n  No results available.\n'));
+    console.log('');
+    console.log(muted('  No results available yet.'));
+    console.log('');
     return;
   }
 
+  // Calculate stats
+  const scores = submissions.map(s => parseFloat(s.result1 || s.total_result || 0)).filter(n => !isNaN(n));
+  const maxScore = Math.max(...scores);
+  const avgScore = scores.reduce((a, b) => a + b, 0) / scores.length;
+
   const table = new Table({
     head: [
-      chalk.cyan('ID'),
-      chalk.cyan('Filename'),
-      chalk.cyan('Similarity'),
-      chalk.cyan('Matches'),
+      dim('#'),
+      dim('Submission'),
+      dim('Similarity'),
+      dim(''),
     ],
     style: { head: [], border: ['dim'] },
+    colWidths: [9, 30, 13, 20],
   });
 
   submissions.forEach((s) => {
+    const score = s.result1 || s.total_result || 0;
     table.push([
-      chalk.white(s.id || s.submission_id || ''),
-      s.filename || s.name || '',
-      colorScore(s.result_score || s.similarity || s.score || 0),
-      String(s.match_count || s.matches || ''),
+      accent(String(s.id || '')),
+      s.filename || dim('unknown'),
+      colorScore(score),
+      scoreBar(score),
     ]);
   });
 
-  console.log('\n' + table.toString() + '\n');
+  console.log(table.toString());
+
+  // Stats line
+  console.log(
+    '  ' +
+    dim('Max: ') + colorScore(maxScore) +
+    dim('  Avg: ') + colorScore(avgScore) +
+    dim(`  Submissions: ${submissions.length}`)
+  );
+  console.log('');
 }
 
 function resultsDetailTable(results) {
-  const matches = results?.matches || results?.results || results || [];
+  const matches = results?.other_matches || [];
 
   if (!Array.isArray(matches) || matches.length === 0) {
-    console.log(chalk.dim('\n  No matches found.\n'));
+    console.log('');
+    console.log(muted('  No matches found for this submission.'));
+    console.log('');
     return;
   }
 
   const table = new Table({
     head: [
-      chalk.cyan('Matched With'),
-      chalk.cyan('Similarity'),
-      chalk.cyan('Lines Matched'),
-      chalk.cyan('Type'),
+      dim('Matched With'),
+      dim('Tokens'),
+      dim('Type'),
     ],
     style: { head: [], border: ['dim'] },
   });
 
   matches.forEach((m) => {
     table.push([
-      m.matched_filename || m.other_filename || m.name || '',
-      colorScore(m.score || m.similarity || 0),
-      String(m.lines_matched || m.matched_lines || ''),
-      m.type || m.match_type || '',
+      m.filename || m.other_filename || dim('unknown'),
+      chalk.white.bold(String(m.tokens || '–')),
+      m.type ? accent(m.type) : dim('–'),
     ]);
   });
 
-  console.log('\n' + table.toString() + '\n');
+  console.log(table.toString());
+
+  // Stats summary
+  if (results.avg !== undefined) {
+    console.log(
+      '  ' +
+      dim('Avg: ') + colorScore(results.avg) +
+      dim('  Max: ') + colorScore(results.max) +
+      dim('  Min: ') + colorScore(results.min)
+    );
+  }
+  console.log('');
+}
+
+// Compact single-line result for scan output
+function scanResultLine(submission) {
+  const score = parseFloat(submission.result1 || submission.total_result || 0);
+  const name = submission.filename || 'unknown';
+  const truncName = name.length > 28 ? name.substring(0, 25) + '...' : name;
+  return (
+    '  ' + accent(String(submission.id).padEnd(8)) +
+    truncName.padEnd(30) +
+    colorScore(score).padStart(8) +
+    '  ' + scoreBar(score, 12)
+  );
 }
 
-module.exports = { colorScore, statusColor, checksTable, overviewTable, resultsDetailTable };
+module.exports = { colorScore, scoreBar, statusColor, checksTable, overviewTable, resultsDetailTable, scanResultLine };

package/src/utils/poller.js

@@ -2,51 +2,78 @@
 
 const ora = require('ora');
 const chalk = require('chalk');
-const cliProgress = require('cli-progress');
 const { getCheckStatus } = require('../api/endpoints');
 
+const accent = chalk.hex('#8b5cf6');
+const dim = chalk.dim;
+
+// Animated progress bar
+function progressBar(percent, width = 24) {
+  const p = Math.min(100, Math.max(0, percent));
+  const filled = Math.round((p / 100) * width);
+  const empty = width - filled;
+  return accent('━'.repeat(filled)) + dim('─'.repeat(empty));
+}
+
 async function pollUntilComplete(checkId, { silent = false } = {}) {
   const POLL_INTERVAL = 3000;
   let spinner;
-  let progressBar;
   let interrupted = false;
+  let startTime = Date.now();
 
   const cleanup = () => {
     interrupted = true;
     if (spinner) spinner.stop();
-    if (progressBar) progressBar.stop();
   };
 
   process.on('SIGINT', cleanup);
 
   if (!silent) {
-    spinner = ora('Waiting for check to complete...').start();
+    spinner = ora({
+      text: 'Waiting for check to complete...',
+      spinner: 'dots12',
+      color: 'magenta',
+    }).start();
   }
 
   try {
     while (!interrupted) {
       const status = await getCheckStatus(checkId);
-      const statusVal = status?.status ?? status?.check_status ?? status;
-      const progress = status?.progress ?? status?.percentage ?? 0;
+      const statusId = status?.status_id;
+      const progress = status?.progress ?? 0;
+      const elapsed = Math.round((Date.now() - startTime) / 1000);
+      const elapsedStr = elapsed < 60 ? `${elapsed}s` : `${Math.floor(elapsed / 60)}m ${elapsed % 60}s`;
 
-      // Check if completed
-      if (statusVal === 5 || statusVal === 'completed' || statusVal === 'done') {
-        if (spinner) spinner.succeed('Check completed!');
-        if (progressBar) progressBar.stop();
+      // status_id 4 = Completed
+      if (statusId === 4) {
+        if (spinner) {
+          spinner.succeed(
+            chalk.green('Check completed!') +
+            dim(` (${elapsedStr})`)
+          );
+        }
         return status;
       }
 
-      // Check if failed
-      if (statusVal === 'failed' || statusVal === 'error' || statusVal === -1) {
-        if (spinner) spinner.fail('Check failed.');
-        if (progressBar) progressBar.stop();
+      // status_id 5 = Error/Failed
+      if (statusId === 5 || statusId === -1) {
+        if (spinner) {
+          spinner.fail(
+            chalk.red('Check failed') +
+            dim(': ' + (status?.status_message || status?.status || 'Unknown error'))
+          );
+        }
         return status;
       }
 
       // Update progress display
       if (!silent && spinner) {
-        const pct = typeof progress === 'number' ? progress : 0;
-        spinner.text = `Processing... ${chalk.cyan(pct + '%')}`;
+        const statusText = status?.status || 'Processing';
+        spinner.text =
+          dim(statusText) + '  ' +
+          progressBar(progress) + '  ' +
+          accent.bold(progress + '%') +
+          dim('  ' + elapsedStr);
       }
 
       await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL));

package/src/utils/update-check.js

@@ -0,0 +1,137 @@
+'use strict';
+
+const https = require('https');
+const path = require('path');
+const fs = require('fs');
+const chalk = require('chalk');
+const boxen = require('boxen');
+
+const PKG = require('../../package.json');
+const CURRENT_VERSION = PKG.version;
+const PACKAGE_NAME = PKG.name;
+
+// Cache file to avoid hammering NPM on every run
+const CACHE_DIR = path.join(require('os').homedir(), '.codequiry');
+const CACHE_FILE = path.join(CACHE_DIR, '.update-check');
+const CHECK_INTERVAL = 4 * 60 * 60 * 1000; // 4 hours
+
+function fetchLatestVersion() {
+  return new Promise((resolve, reject) => {
+    const url = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+    const req = https.get(url, { headers: { 'Accept': 'application/json' }, timeout: 3000 }, (res) => {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const json = JSON.parse(data);
+          resolve(json.version || null);
+        } catch {
+          resolve(null);
+        }
+      });
+    });
+    req.on('error', () => resolve(null));
+    req.on('timeout', () => { req.destroy(); resolve(null); });
+  });
+}
+
+function readCache() {
+  try {
+    const raw = fs.readFileSync(CACHE_FILE, 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+function writeCache(data) {
+  try {
+    if (!fs.existsSync(CACHE_DIR)) fs.mkdirSync(CACHE_DIR, { recursive: true });
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(data));
+  } catch {
+    // Ignore write errors
+  }
+}
+
+function compareVersions(current, latest) {
+  const a = current.split('.').map(Number);
+  const b = latest.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((b[i] || 0) > (a[i] || 0)) return true;
+    if ((b[i] || 0) < (a[i] || 0)) return false;
+  }
+  return false;
+}
+
+/**
+ * Check for updates in the background. Shows a notification after the
+ * command finishes if a newer version is available.
+ * Returns a function you call at the end to print the notice (if any).
+ */
+function checkForUpdate() {
+  let updateMessage = null;
+
+  // Start the check immediately (non-blocking)
+  const promise = (async () => {
+    try {
+      // Check cache first
+      const cache = readCache();
+      const now = Date.now();
+
+      let latest;
+      if (cache && cache.latest && (now - cache.checkedAt) < CHECK_INTERVAL) {
+        latest = cache.latest;
+      } else {
+        latest = await fetchLatestVersion();
+        if (latest) {
+          writeCache({ latest, checkedAt: now });
+        }
+      }
+
+      if (latest && compareVersions(CURRENT_VERSION, latest)) {
+        const accent = chalk.hex('#8b5cf6');
+        const dim = chalk.dim;
+        const isWindows = process.platform === 'win32';
+
+        const lines = [
+          accent.bold('Update available!') + ' ' +
+          dim(CURRENT_VERSION) + dim(' → ') + chalk.green.bold(latest),
+          '',
+          dim('Update with:'),
+          '  ' + chalk.cyan.bold(`npm install -g ${PACKAGE_NAME}`),
+        ];
+
+        if (isWindows) {
+          lines.push(dim('  or: ') + chalk.cyan(`irm https://codequiry.com/install.ps1 | iex`));
+        } else {
+          lines.push(dim('  or: ') + chalk.cyan(`curl -fsSL https://codequiry.com/install.sh | bash`));
+        }
+
+        updateMessage = boxen(
+          lines.join('\n'),
+          {
+            padding: { top: 0, bottom: 0, left: 1, right: 1 },
+            margin: { top: 1, bottom: 1, left: 1, right: 0 },
+            borderStyle: 'round',
+            borderColor: '#8b5cf6',
+            dimBorder: true,
+          }
+        );
+      }
+    } catch {
+      // Never let update check crash the CLI
+    }
+  })();
+
+  return {
+    /** Call this after your command completes to print the update notice */
+    async notify() {
+      await promise;
+      if (updateMessage) {
+        console.log(updateMessage);
+      }
+    },
+  };
+}
+
+module.exports = { checkForUpdate, CURRENT_VERSION };