@paxnax/berliner 0.9.0 → 0.10.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Panta Dev EOOD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -14,7 +14,7 @@ With Bun, run `bunx --bun @paxnax/berliner@latest setup`. To install only the co
 
 ## Quickstart
 
-1. Sign in at https://berliner.app with GitHub.
+1. Sign in at https://berliner.app with GitHub and choose a plan.
 2. Run setup:
 
    ```sh
@@ -127,6 +127,7 @@ Other commands:
 - `berliner delete <session-id>`: delete a session, or one item with `--evidence <id>`. Asks to confirm unless `--yes`.
 - `berliner evidence public <id>`: let anyone with the link view one file, and print its public URL and Markdown line. `berliner evidence private <id>` makes it private again. `berliner session` shows the ids, and the URL of each public file.
 - `berliner skill`: print the agent skill (`SKILL.md`) to install in your agent.
+- `berliner version [--json]`, or `berliner --version`: print this CLI's version and whether it is the latest release, with `berliner upgrade` to run when it is not. It looks the latest release up at most every 5 minutes; when the registry can't be reached it still prints the version and says so.
 - `berliner upgrade [--yes] [--no-skill] [--no-hooks]`: install the latest CLI and skill. It shows its plan (the versions, the exact install command, each skill file and each Berliner hook it updates) and asks before changing anything; a second question, or `--no-skill`, leaves your skill as it is, and `--no-hooks` leaves your hooks as they are. It brings a Berliner hook an older setup installed up to date, but never adds one; your token and config are never touched. When it updated a skill or hook, its last line names the tools to start a new session in so they load it.
 - `berliner hook <tool>`: run by the hooks setup installs, with the tool's payload on stdin. It never fails and never makes the agent wait, and prints only the reminder when a session starts; errors go to `${XDG_STATE_HOME:-~/.local/state}/berliner/hook.log`.
 

package/dist/args.js

@@ -25,6 +25,7 @@ const config = {
         json: { type: "boolean" },
         strict: { type: "boolean" },
         help: { type: "boolean" },
+        version: { type: "boolean" },
         yes: { type: "boolean" },
         "no-install": { type: "boolean" },
         "no-browser": { type: "boolean" },

package/dist/commands/version.js

@@ -0,0 +1,40 @@
+import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { cacheDir } from "../config.js";
+import { print } from "../output.js";
+import { currentVersion, latestVersion, newer, registryOf } from "../version.js";
+// Short, unlike the daily notice's day: someone asking for the version wants to see a release within minutes of it.
+const CACHE_MS = 5 * 60_000;
+const LOOKUP_TIMEOUT_MS = 3000;
+// The latest release, from the cache file while it is fresh (its mtime is when it was looked up); null when the registry
+// can't be reached.
+async function latest(env) {
+    const file = join(cacheDir(env), "latest-version");
+    try {
+        if (Date.now() - statSync(file).mtimeMs < CACHE_MS)
+            return readFileSync(file, "utf8").trim();
+    }
+    catch {
+        // Not looked up yet on this machine.
+    }
+    try {
+        const version = await latestVersion(env, LOOKUP_TIMEOUT_MS);
+        mkdirSync(cacheDir(env), { recursive: true, mode: 0o700 });
+        writeFileSync(file, version);
+        return version;
+    }
+    catch {
+        return null;
+    }
+}
+export async function version(env, values) {
+    const version = currentVersion();
+    const last = await latest(env);
+    const upToDate = last === null ? null : !newer(last, version);
+    const text = last === null
+        ? `berliner ${version} (couldn't reach ${registryOf(env)} to check for a newer release)`
+        : upToDate
+            ? `berliner ${version} (latest)`
+            : `berliner ${version}, ${last} is out: run berliner upgrade`;
+    print({ data: { version, latest: last, up_to_date: upToDate }, text }, values.json === true);
+}

package/dist/index.js

@@ -17,6 +17,7 @@ import { team } from "./commands/team.js";
 import { summary } from "./commands/summary.js";
 import { update } from "./commands/update.js";
 import { upgrade } from "./commands/upgrade.js";
+import { version } from "./commands/version.js";
 import { readConfig } from "./config.js";
 import { warn } from "./output.js";
 import { upgradeNotice } from "./version.js";
@@ -47,6 +48,7 @@ Commands:
   evidence private <id> make it viewable only by you again [--json]
   upgrade               install the latest CLI, skill and hooks [--yes --no-skill --no-hooks]
   skill                 print the bundled SKILL.md
+  version               print this version and whether it is the latest release [--json] (also --version)
   hook <tool>           run by the hooks of claude-code, codex or opencode; reads the payload on stdin
 
 Environment: BERLINER_TOKEN, BERLINER_URL, BERLINER_VENDOR_SUBSCRIPTION_SLUG (the subscription of new sessions),
@@ -70,6 +72,7 @@ const handled = new Set([
     "skill",
     "hook",
     "upgrade",
+    "version",
 ]);
 const cfg = () => readConfig(process.env);
 try {
@@ -80,6 +83,8 @@ try {
         await hook(process.env, args.positionals, args.values);
     else if (args.error)
         throw new CliError(args.error, "usage");
+    else if (args.command === "version" || args.values.version)
+        await version(process.env, args.values);
     else if (args.command === "setup")
         await setup(process.env, args.values);
     else if (args.command === "report")
@@ -117,8 +122,8 @@ catch (err) {
         console.error(usage);
     process.exitCode = softFail ? 0 : 1;
 }
-// The hook carries it in the session-start reminder instead, and upgrade looks for itself.
-if (args.command !== "hook" && args.command !== "upgrade") {
+// The hook carries it in the session-start reminder instead, and upgrade and version look for themselves.
+if (args.command !== "hook" && args.command !== "upgrade" && args.command !== "version" && !args.values.version) {
     const notice = await upgradeNotice(process.env);
     if (notice)
         console.error(notice);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@paxnax/berliner",
-  "version": "0.9.0",
-  "description": "Report coding-agent sessions to Berliner",
+  "version": "0.10.1",
+  "description": "The receipt for agent work: reports coding-agent sessions to Berliner",
   "keywords": [
     "claude-code",
     "codex",
@@ -11,6 +11,7 @@
     "cli"
   ],
   "homepage": "https://berliner.app",
+  "license": "MIT",
   "type": "module",
   "engines": {
     "node": ">=22"