@voidlabs.gg/voidshift 0.4.2 → 0.4.3

package/README.md

@@ -5,7 +5,7 @@ One CLI for the Void dev tools. Install it once, run `vsf` (short for
 defaults you can change. Everything setup does can be seen and changed later
 from the command line.
 
-> Early release. macOS only for now; Windows and Linux are next.
+> Early release. macOS and Linux (awake is macOS only); Windows is next.
 
 ```sh
 npm i -g @voidlabs.gg/voidshift
@@ -104,10 +104,13 @@ to trust the recall hook once: run `/hooks` in Codex.
 - **Your own logins.** Agents run the official `claude` and `codex` CLIs you
   already use, signed in with your own account. VoidShift never reads or
   stores those credentials. The Linear API key for the runner lives in your
-  macOS Keychain.
+  macOS Keychain, or on Linux in `~/.config/voidshift/agents/secrets.json`
+  (mode 0600).
 - **Trust.** The Dev agent can run shell commands inside its copy of the repo
   so it can install and test. Review its pull requests like any other.
 - **Your config** lives in `~/.config/voidshift`.
+- **Linux.** The runner is a systemd user timer. Run
+  `sudo loginctl enable-linger $USER` so it keeps going after you log out.
 
 ```sh
 vsf doctor                     # check everything is set up, and whether an update is out

package/dist/checks.js

@@ -19,23 +19,24 @@ function firstLine(s) {
 }
 export function baseChecks(platform, nodeVersion, exec) {
     const checks = [];
-    checks.push(platform === 'darwin'
-        ? { name: 'macOS', status: 'ok', detail: 'supported' }
-        : { name: 'macOS', status: 'fail', detail: `${platform} is not supported yet`, fix: 'The MVP runs on macOS only' });
+    const linux = platform === 'linux';
+    checks.push(platform === 'darwin' || linux
+        ? { name: 'platform', status: 'ok', detail: linux ? 'Linux, supported' : 'macOS, supported' }
+        : { name: 'platform', status: 'fail', detail: `${platform} is not supported yet`, fix: 'Run on macOS or Linux' });
     checks.push(atLeast(nodeVersion, '22.18')
         ? { name: 'Node', status: 'ok', detail: nodeVersion }
         : { name: 'Node', status: 'fail', detail: `${nodeVersion} is too old`, fix: 'Install Node 22.18 or newer' });
     const git = exec('git', ['--version']);
     checks.push(git.ok
         ? { name: 'git', status: 'ok', detail: git.stdout }
-        : { name: 'git', status: 'fail', detail: 'not found', fix: 'xcode-select --install' });
+        : { name: 'git', status: 'fail', detail: 'not found', fix: linux ? 'Install git with your package manager' : 'xcode-select --install' });
     const gh = exec('gh', ['auth', 'token']);
     const ghInstalled = gh.ok || exec('gh', ['--version']).ok;
     checks.push(gh.ok
         ? { name: 'GitHub CLI', status: 'ok', detail: 'logged in' }
         : ghInstalled
             ? { name: 'GitHub CLI', status: 'warn', detail: 'not logged in', fix: 'gh auth login' }
-            : { name: 'GitHub CLI', status: 'warn', detail: 'not found', fix: 'brew install gh' });
+            : { name: 'GitHub CLI', status: 'warn', detail: 'not found', fix: linux ? 'https://cli.github.com' : 'brew install gh' });
     const claude = exec('claude', ['--version']);
     const codex = exec('codex', ['--version']);
     checks.push(claude.ok

package/dist/commands/setup.js

@@ -2,7 +2,7 @@ import * as p from '@clack/prompts';
 import { baseChecks, run } from "../checks.js";
 import { context, readConfig, writeConfig } from "../config.js";
 import { fetchTool, loadTool } from "../loader.js";
-import { findTool, registry } from "../registry.js";
+import { findTool, registry, unavailable } from "../registry.js";
 import { needsTerminal, parseFlags } from "./args.js";
 import { usages } from "./help.js";
 import { Cancelled } from "../ui.js";
@@ -82,18 +82,18 @@ export async function setup(defaults = false) {
     const ctx = context(true, defaults);
     const config = readConfig();
     try {
-        const available = registry.filter((t) => t.status !== 'planned').map((t) => t.name);
+        const available = registry.filter((t) => !unavailable(t)).map((t) => t.name);
         const picked = defaults
-            ? [...new Set([...config.tools, ...available])]
+            ? [...new Set([...config.tools.filter((n) => available.includes(n)), ...available])]
             : await p.multiselect({
                 message: 'Which tools do you want?',
                 options: registry.map((t) => ({
                     value: t.name,
                     label: t.name,
-                    hint: t.status === 'planned' ? `${t.summary} (coming soon)` : t.summary,
-                    disabled: t.status === 'planned',
+                    hint: unavailable(t) ? `${t.summary} (${unavailable(t)})` : t.summary,
+                    disabled: !!unavailable(t),
                 })),
-                initialValues: config.tools,
+                initialValues: config.tools.filter((n) => available.includes(n)),
                 required: false,
             });
         if (p.isCancel(picked))

package/dist/commands/tools.js

@@ -1,12 +1,13 @@
 import { context, readConfig, writeConfig } from "../config.js";
 import { fetchTool, loadTool } from "../loader.js";
-import { findTool, registry } from "../registry.js";
+import { findTool, registry, unavailable } from "../registry.js";
 import { needsTerminal, wantsHelp } from "./args.js";
 export function listTools() {
     const installed = new Set(readConfig().tools);
     const width = Math.max(...registry.map((t) => t.name.length));
     for (const t of registry) {
-        const tag = installed.has(t.name) ? ' (added)' : t.status === 'planned' ? ' (coming soon)' : '';
+        const why = unavailable(t);
+        const tag = installed.has(t.name) ? ' (added)' : why ? ` (${why})` : '';
         console.log(`${t.name.padEnd(width)}  ${t.summary}${tag}`);
     }
     return 0;
@@ -31,6 +32,10 @@ export async function addTool(name) {
         console.error(`${entry.name} is not released yet.`);
         return 1;
     }
+    if (unavailable(entry)) {
+        console.error(`${entry.name} runs on macOS only.`);
+        return 1;
+    }
     const ctx = context();
     if (!fetchTool(entry, ctx.configDir)) {
         console.error(`could not download ${entry.pkg}`);

package/dist/registry.d.ts

@@ -3,6 +3,9 @@ export interface ToolEntry {
     summary: string;
     pkg: string;
     status: 'planned' | 'available';
+    platforms?: NodeJS.Platform[];
 }
 export declare const registry: ToolEntry[];
+export declare const runsHere: (t: ToolEntry, platform?: NodeJS.Platform) => boolean;
+export declare function unavailable(t: ToolEntry, platform?: NodeJS.Platform): string | null;
 export declare function findTool(name: string): ToolEntry | undefined;

package/dist/registry.js

@@ -7,6 +7,7 @@ export const registry = [
         summary: 'Keep the Mac running on battery with the lid closed, with guardrails',
         pkg: '@voidlabs.gg/voidshift-awake',
         status: 'available',
+        platforms: ['darwin'],
     },
     {
         name: 'agents',
@@ -21,6 +22,13 @@ export const registry = [
         status: 'available',
     },
 ];
+export const runsHere = (t, platform = process.platform) => !t.platforms || t.platforms.includes(platform);
+// Why a tool cannot be added here, or null when it can.
+export function unavailable(t, platform = process.platform) {
+    if (t.status === 'planned')
+        return 'coming soon';
+    return runsHere(t, platform) ? null : 'macOS only';
+}
 export function findTool(name) {
     return registry.find((t) => t.name === name);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidlabs.gg/voidshift",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "One CLI for the Void dev tools: keep your Mac awake, run agents in the background, shared skills and memory for Claude Code and Codex.",
   "license": "Apache-2.0",
   "repository": {
@@ -18,7 +18,8 @@
     "agents",
     "linear",
     "cli",
-    "macos"
+    "macos",
+    "linux"
   ],
   "type": "module",
   "bin": {
@@ -30,9 +31,6 @@
     "LICENSE",
     "README.md"
   ],
-  "os": [
-    "darwin"
-  ],
   "engines": {
     "node": ">=22.18"
   },