@askviraj/ai-plugins 1.0.0 → 1.0.1

package/bin/installer.js

@@ -290,14 +290,18 @@ class Installer extends Command {
   }
 }
 
-Installer.description =
+// Use `summary` (not `description`) so oclif prints this once at the top of
+// --help; setting `description` would also render a duplicate DESCRIPTION block.
+Installer.summary =
   "Install Viraj Patel's Claude Code toolkit: marketplace plugins (via the `claude` CLI) and the powerline statusline. Checks required tools (brew/mise/claude/rtk/pnpm/…) first and prints install hints for any that are missing.";
 
+// Users invoke this via pnpx (npx works too), never the bare `ai-plugins` bin,
+// so spell the runnable command out rather than using <%= config.bin %>.
 Installer.examples = [
-  "<%= config.bin %> --all",
-  "<%= config.bin %> --plugins",
-  "<%= config.bin %> --plugin vwf --plugin dart-lsp",
-  "<%= config.bin %> --statusline --subagentstatusline --yes",
+  "pnpx @askviraj/ai-plugins --all",
+  "pnpx @askviraj/ai-plugins --plugins",
+  "pnpx @askviraj/ai-plugins --plugin vwf --plugin dart-lsp",
+  "pnpx @askviraj/ai-plugins --statusline --subagentstatusline --yes",
 ];
 
 Installer.flags = {

package/package.json

@@ -28,5 +28,5 @@
     "url": "github:virajp/ai-plugins"
   },
   "type": "commonjs",
-  "version": "1.0.0"
+  "version": "1.0.1"
 }

package/tools/statusline/statusline

@@ -300,6 +300,20 @@ function gitDirtyMark(cwd) {
   return "";
 }
 
+// Up-arrow marker when the branch is ahead of its upstream (local commits not
+// pushed). Empty when in sync, when there is no upstream, or on any git error.
+// One bounded git call (250ms).
+function gitAheadMark(cwd) {
+  const { execFileSync } = require("child_process");
+  const opts = { cwd, encoding: "utf8", timeout: 250, stdio: ["ignore", "pipe", "ignore"] };
+  try {
+    const out = execFileSync("git", ["rev-list", "--count", "@{upstream}..HEAD"], opts).trim();
+    return parseInt(out, 10) > 0 ? SYM.ahead : "";
+  } catch (_) {
+    return "";
+  }
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Segment registry — each builder takes the resolved context `c` and returns the
 // segment TEXT (a string), or null to omit (when its data is absent). All styling
@@ -323,6 +337,7 @@ const SEGMENTS = {
   branch: (c) => {
     if (!c.branch) return null;
     let t = c.wt ? `${SYM.worktree} ${SYM.branch} ${c.branch}` : `${SYM.branch} ${c.branch}`;
+    if (c.ahead) t += ` ${c.ahead}`;
     if (c.dirty) t += ` ${c.dirty}`;
     return t;
   },
@@ -384,6 +399,7 @@ function renderMain(d) {
     projectSym: SYM.project,
     wt: worktreeSubpath(cwd),
     branch: git.branch,
+    ahead: git.branch ? gitAheadMark(cwd) : "",
     dirty: git.branch ? gitDirtyMark(cwd) : "",
   };
 

package/tools/statusline/statusline.json

@@ -166,6 +166,7 @@
   },
   "symbols": {
     "agent": "",
+    "ahead": "↑",
     "branch": "",
     "context": "",
     "cost": "",