@openagentsinc/pylon 0.1.16 → 0.1.17

package/README.md

@@ -16,6 +16,7 @@ bun install -g @openagentsinc/pylon && pylon
 npx @openagentsinc/pylon --version 0.1.16
 npx @openagentsinc/pylon --no-launch
 npx @openagentsinc/pylon --no-updates
+npx @openagentsinc/pylon status --json
 npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --run-diagnostics
 npx @openagentsinc/pylon --verbose
 ```
@@ -60,23 +61,29 @@ The launcher:
 - starts the installed `pylon-tui` by default after the smoke path; that TUI
   starts and supervises the earning worker
   unless `--no-launch` is set
+- forwards CLI subcommands such as `pylon status --json` to the installed
+  `pylon` binary after bootstrap instead of opening `pylon-tui`
 - while the TUI is running on the default release track, checks GitHub Releases
-  every 30 seconds and restarts the TUI from a newer trusted cached release
+  on a six-hour cadence and restarts the TUI from a newer trusted cached release
   without replacing the global npm/bun command
 - use `--no-updates` to keep the current installed release running without
-  background GitHub release checks; `--version` remains a pinned release run
+  background GitHub release checks; `--version` remains a pinned release run.
+  Set `GITHUB_TOKEN` or `GH_TOKEN` when you want authenticated GitHub release
+  lookups.
 - owns the current auto-update contract. Directly extracted GitHub release
   assets do not contain a native updater today; if an operator runs
   `./pylon` from an unpacked archive, that process stays on its compiled
   version until the operator manually replaces the archive or switches back to
   the npm/bun launcher.
-- for hosted homework/training work, use launcher `0.1.16` or newer so the
+- for hosted homework/training work, use launcher `0.1.17` or newer so the
   cached standalone binary auto-updates while the dashboard is open. The
   `pylon-v0.1.16` standalone binary keeps the long hosted homework ID hashing
   from `0.1.14`, refuses to seal terminal training windows until the worker
   contribution artifact bundle has uploaded and verified for validator replay,
   and packages the minimal Psionic training runtime so standalone installs can
-  advertise homework-worker capability.
+  advertise homework-worker capability. Launcher `0.1.17` adds CLI subcommand
+  forwarding and bounds background GitHub release checks to avoid
+  unauthenticated rate-limit churn.
 - does not try to install or register a local runtime automatically; the
   bootstrap stays honest about the separate local Gemma runtime
   prerequisite instead of mutating the host behind the user's back

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagentsinc/pylon",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Bootstrap the standalone OpenAgents Pylon release asset and run first-run smoke checks.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -6,11 +6,11 @@ import {
   DEFAULT_RELEASE_REPO,
   bootstrapInstalledPylon,
   ensureReleaseInstall,
-  launchInstalledPylon,
   launchInstalledPylonWithUpdates,
   resolveBootstrapOutcome,
   resolvePlatformTarget,
   renderBootstrapSummary,
+  runInstalledPylonCli,
 } from "./index.js";
 import {
   createTelemetryClient,
@@ -78,6 +78,8 @@ export function usage() {
   npx @openagentsinc/pylon [options]
   bunx @openagentsinc/pylon [options]
   pylon [options]
+  pylon [options] <pylon-command> [pylon-options]
+  pylon [options] -- <pylon-command> [pylon-options]
 
 Description:
   Download the latest tagged standalone Pylon release asset for this machine,
@@ -86,11 +88,15 @@ Description:
   and build it locally instead. Cache the binaries, run the first-run smoke
   path, and then start the Pylon terminal UI by default. The terminal UI manages
   the earning worker and keeps live status visible. The launcher checks GitHub
-  for newer tagged pylon-v... releases on each default run and every 30 seconds
+  for newer tagged pylon-v... releases on each default run and periodically
   while the dashboard is open. Only releases initiated by AtlantisPleb are
   accepted. New standalone binaries are cached under the local bootstrap root;
   the global npm or bun pylon command is not replaced.
 
+  When a Pylon command is provided, the launcher bootstraps the managed release
+  and forwards that command to the installed pylon binary instead of opening
+  pylon-tui. For example: pylon status --json.
+
 Options:
   --version <x.y.z>                    Resolve a specific Pylon release.
   --install-root <path>                Override the launcher cache/install root.
@@ -109,7 +115,7 @@ Options:
   --skip-model-download                Keep the curated GGUF cache skipped.
   --skip-diagnostics                   Keep optional pylon gemma diagnose skipped.
   --no-launch                          Do not start pylon-tui after bootstrap.
-  --no-updates                         Disable 30-second GitHub release polling
+  --no-updates                         Disable background GitHub release polling
                                        and dashboard restart while pylon runs.
   --verbose                            Print extra network and recovery detail.
   --debug-network                      Alias for --verbose.
@@ -140,10 +146,19 @@ export function parseArgs(argv) {
     verbose: false,
     json: false,
     help: false,
+    pylonArgs: [],
   };
 
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
+    if (arg === "--") {
+      options.pylonArgs = argv.slice(index + 1);
+      break;
+    }
+    if (!arg.startsWith("-")) {
+      options.pylonArgs = argv.slice(index);
+      break;
+    }
     switch (arg) {
       case "--version":
         options.version = argv[++index];
@@ -241,6 +256,7 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
     ensureReleaseInstallImpl = ensureReleaseInstall,
     bootstrapInstalledPylonImpl = bootstrapInstalledPylon,
     launchInstalledPylonImpl = launchInstalledPylonWithUpdates,
+    runInstalledPylonCliImpl = runInstalledPylonCli,
     createTelemetryClientImpl = createTelemetryClient,
   } = dependencies;
   const options = parseArgs(argv);
@@ -320,7 +336,21 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
         reporter?.warning(`Pylon ${outcome.verdict}`, outcome.detail);
       }
       console.log(renderBootstrapSummary(summary));
-      if (!options.noLaunch) {
+      if (options.pylonArgs.length > 0) {
+        await runInstalledPylonCliImpl(
+          {
+            ...options,
+            ...install,
+            version: install.version,
+          },
+          options.pylonArgs,
+          {
+            ...dependencies,
+            onStatus: reporter?.status,
+            telemetryClient,
+          },
+        );
+      } else if (!options.noLaunch) {
         await launchInstalledPylonImpl(
           {
             ...options,

package/src/index.js

@@ -20,7 +20,7 @@ export const DEFAULT_MODEL_ID = "gemma-4-e4b";
 export const DEFAULT_DIAGNOSTIC_REPEATS = 3;
 export const DEFAULT_DIAGNOSTIC_MAX_OUTPUT_TOKENS = 96;
 export const DEFAULT_FETCH_TIMEOUT_MS = 15_000;
-export const DEFAULT_UPDATE_CHECK_INTERVAL_MS = 30_000;
+export const DEFAULT_UPDATE_CHECK_INTERVAL_MS = 6 * 60 * 60 * 1000;
 export const DEFAULT_TRUSTED_RELEASE_AUTHOR = "AtlantisPleb";
 const PYLON_RELEASE_TAG_PREFIX = "pylon-v";
 const RELEASE_ASSET_INSTALL_METHOD = "release_asset";
@@ -215,8 +215,9 @@ function requestHeaders() {
     accept: "application/vnd.github+json",
     "user-agent": "@openagentsinc/pylon bootstrap",
   };
-  if (process.env.GITHUB_TOKEN) {
-    headers.authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+  const githubToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+  if (githubToken) {
+    headers.authorization = `Bearer ${githubToken}`;
   }
   return headers;
 }
@@ -2016,6 +2017,26 @@ export async function launchInstalledPylon(
 
 export const launchInstalledPylonTui = launchInstalledPylon;
 
+export async function runInstalledPylonCli(
+  options,
+  args = [],
+  {
+    runProcessImpl = runProcess,
+    onStatus = null,
+  } = {},
+) {
+  const pylonPath = path.resolve(options.pylonPath);
+  emitStatus(
+    onStatus,
+    "Running Pylon CLI command",
+    [path.basename(pylonPath), ...args].join(" "),
+  );
+  return runProcessImpl(pylonPath, args, {
+    env: buildPylonEnv(options),
+    stdio: "inherit",
+  });
+}
+
 export async function launchInstalledPylonWithUpdates(
   options,
   {