beads-ui 0.9.2 → 0.9.3

package/CHANGES.md

@@ -1,5 +1,12 @@
 # Changes
 
+## 0.9.3
+
+- [`2e04bc1`](https://github.com/mantoni/beads-ui/commit/2e04bc1eeb5c43e6934d858cd017d80f745a38bb)
+  Add -v/—version flag to CLI (#46) (Brent Traut)
+
+_Released by [Maximilian Antoni](https://github.com/mantoni) on 2026-01-23._
+
 ## 0.9.2
 
 - [`ffa376c`](https://github.com/mantoni/beads-ui/commit/ffa376cab432b0e321232e8bc0de2caca20a6b17)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beads-ui",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Local UI for Beads — Collaborate on issues with your coding agent.",
   "keywords": [
     "agent",

package/server/cli/index.js

@@ -1,3 +1,4 @@
+import { readFile } from 'node:fs/promises';
 import { enableAllDebug } from '../logging.js';
 import { handleRestart, handleStart, handleStop } from './commands.js';
 import { printUsage } from './usage.js';
@@ -30,6 +31,10 @@ export function parseArgs(args) {
       flags.push('open');
       continue;
     }
+    if (token === '--version' || token === '-v') {
+      flags.push('version');
+      continue;
+    }
     if (token === '--host' && i + 1 < args.length) {
       options.host = args[++i];
       continue;
@@ -54,6 +59,22 @@ export function parseArgs(args) {
   return { command, flags, options };
 }
 
+/**
+ * Load the package.json version string.
+ *
+ * @returns {Promise<string>}
+ */
+async function loadVersion() {
+  const package_url = new URL('../../package.json', import.meta.url);
+  const package_text = await readFile(package_url, 'utf8');
+  const package_data = JSON.parse(package_text);
+  const version = package_data.version;
+  if (typeof version !== 'string') {
+    throw new Error('Invalid package.json version');
+  }
+  return version;
+}
+
 /**
  * CLI main entry. Returns an exit code and prints usage on `--help` or errors.
  * No side effects beyond invoking stub handlers.
@@ -69,6 +90,11 @@ export async function main(args) {
     enableAllDebug();
   }
 
+  if (flags.includes('version')) {
+    const version = await loadVersion();
+    process.stdout.write(`${version}\n`);
+    return 0;
+  }
   if (flags.includes('help')) {
     printUsage(process.stdout);
     return 0;

package/server/cli/usage.js

@@ -14,6 +14,7 @@ export function printUsage(out_stream) {
     '',
     'Options:',
     '  -h, --help        Show this help message',
+    '  -v, --version     Show the CLI version',
     '  -d, --debug       Enable debug logging',
     '      --open        Open the browser after start/restart',
     '      --host <addr> Bind to a specific host (default: 127.0.0.1)',