@voidlabs.gg/voidshift 0.4.2 → 0.4.4

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
@@ -50,15 +50,24 @@ Five agents, installed into Claude Code (and Codex if you use it):
 | QA | CI, then code review, then a usability check in a headless browser |
 
 Use them yourself (`/vs-plan ENG-123` in Claude Code), or let a **workflow**
-run them. A workflow starts when one of your Linear cards gets a label, runs
-agents in order in a project (a repo on your Mac), and sends work back to the
-step that made it when a check fails:
+run them. A workflow starts when one of your Linear or VoidTrack cards gets a
+label, or on a schedule, runs agents in order in a project (a repo on your
+machine), and sends work back to the step that made it when a check fails:
 
 ```
 when ENG + vs-plan:  Dev → QA  in tether-relay
 ```
 
-The runner checks Linear every minute, works in its own copy of the repo so
+Triggers, as `--trigger` takes them:
+
+```
+ENG:vs-plan                           # a Linear card in ENG assigned to you gets vs-plan
+voidtrack:ORG:vs-start                # the same for VoidTrack (vsf agents key --voidtrack)
+"cron:0 5 * * 1:Update dependencies"  # every Monday 05:00, no card, on its own branch
+```
+
+A schedule fires once when due (a missed one is made up within a day) and
+`vsf agents run --workflow NAME` fires it now. The runner checks every minute, works in its own copy of the repo so
 your checkout is never touched, and keeps two labels on the card as it goes: the
 stage (`vs-planning`, `vs-plan-review`, `vs-dev`, `vs-qa`, then `vs-qa-verified`
 or `vs-parked`) and the round (`vs-v1`, `vs-v2`). On Linear it posts the plan and
@@ -104,10 +113,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/dist/tui/data.d.ts

@@ -63,8 +63,10 @@ export interface WorkflowItem {
     name: string;
     triggers: {
         source: string;
-        team: string;
-        label: string;
+        team?: string;
+        label?: string;
+        schedule?: string;
+        task?: string;
     }[];
     steps: string[];
     maxRounds: number;

package/dist/tui/screens/workflow-form.js

@@ -8,7 +8,7 @@ import { useBackGuard, useEquivalent, useHints, useKeys, useScreen } from "../co
 import { theme } from "../theme.js";
 import { Panel, Select, TextInput } from "../widgets.js";
 import { tilde } from "../format.js";
-import { matchWarnings, stepLabel, stepName, triggerText, warningText, sameTriggerLike } from "./workflows.js";
+import { matchWarnings, stepLabel, stepName, triggerSpec, triggerText, warningText, sameTriggerLike } from "./workflows.js";
 const h = React.createElement;
 export function formReducer(s, a) {
     switch (a.type) {
@@ -38,7 +38,7 @@ export function formReducer(s, a) {
 }
 export function initialForm(w, name, projects) {
     if (w)
-        return { name, triggers: w.triggers.map((t) => ({ team: t.team, label: t.label })), steps: [...w.steps], project: w.project, rounds: w.maxRounds };
+        return { name, triggers: w.triggers.map((t) => ({ ...t })), steps: [...w.steps], project: w.project, rounds: w.maxRounds };
     return { name: '', triggers: [], steps: [], project: projects.length === 1 ? projects[0] : '', rounds: 3 };
 }
 const FALLBACK_PRODUCERS = ['vs-plan', 'vs-dev'];
@@ -95,7 +95,7 @@ export function saveArgs(s, isNew, catalog) {
         'workflow',
         isNew ? 'add' : 'edit',
         s.name.trim(),
-        ...s.triggers.flatMap((t) => ['--trigger', `${t.team}:${t.label}`]),
+        ...s.triggers.flatMap((t) => ['--trigger', triggerSpec(t)]),
         '--steps',
         s.steps.map((id) => stepName(catalog, id)).join(','),
         '--project',
@@ -105,17 +105,19 @@ export function saveArgs(s, isNew, catalog) {
     ];
 }
 export const renameArgs = (from, to) => ['agents', 'workflow', 'rename', from, to];
-// A trigger from the two text fields, or a complaint.
+// A trigger from the two text fields, or a complaint. A team written as
+// voidtrack:ORG is a VoidTrack team; schedules are added with the CLI.
 export function makeTrigger(team, label) {
-    const t = team.trim().toUpperCase();
+    const voidtrack = /^voidtrack:/i.test(team.trim());
+    const t = team.trim().replace(/^voidtrack:/i, '').toUpperCase();
     const l = label.trim();
     if (!t)
-        return { error: 'Give the Linear team, like ENG.' };
+        return { error: 'Give the team, like ENG, or voidtrack:ORG for VoidTrack.' };
     if (t.includes(':') || /\s/.test(t))
-        return { error: 'The team is a short key like ENG.' };
+        return { error: 'The team is a short key like ENG, or voidtrack:ORG.' };
     if (!l)
         return { error: 'Give the label, like vs-plan.' };
-    return { trigger: { team: t, label: l } };
+    return { trigger: { source: voidtrack ? 'voidtrack' : 'linear', team: t, label: l } };
 }
 // Warnings for triggers this workflow shares with another. In place when
 // editing, last in order when new.
@@ -348,7 +350,7 @@ function WorkflowForm(props) {
     // Triggers
     h(Box, null, h(Label, { text: 'Starts when', focused: where === 'triggers' }), h(Box, { flexDirection: 'column', flexGrow: 1 }, form.triggers.length === 0 ? h(Text, { color: theme.dim }, ' no trigger yet') : null, ...form.triggers.map((t, i) => {
         const on = where === 'triggers' && i === tCursor && adding === null;
-        return h(Text, { key: `${t.team}:${t.label}`, backgroundColor: on ? theme.selected : undefined, bold: on, color: on ? theme.bold : undefined }, ` ${triggerText(t)} `);
+        return h(Text, { key: triggerSpec(t), backgroundColor: on ? theme.selected : undefined, bold: on, color: on ? theme.bold : undefined }, ` ${triggerText(t)} `);
     }), adding !== null
         ? h(Box, { flexDirection: 'column' }, h(Box, null, h(Text, { color: theme.dim }, ' team '), h(TextInput, { value: newTeam, onChange: setNewTeam, focus: adding === 'team', placeholder: 'ENG', onSubmit: () => setAdding('label') }), h(Text, { color: theme.dim }, '  label '), h(TextInput, { value: newLabel, onChange: setNewLabel, focus: adding === 'label', placeholder: 'vs-plan', onSubmit: commitTrigger })), addError ? h(Text, { color: theme.red }, `  ${addError}`) : null)
         : null), h(Box, { flexShrink: 0, marginLeft: 2 }, h(Text, { color: theme.dim }, where === 'triggers' ? 'a add trigger · x remove' : ''))), h(Text, null, ' '), 

package/dist/tui/screens/workflows.d.ts

@@ -4,10 +4,14 @@ import type { Screen } from '../screens.ts';
 export declare function stepLabel(catalog: StepsCatalog | null, id: string): string;
 export declare function stepName(catalog: StepsCatalog | null, id: string): string;
 export interface TriggerLike {
-    team: string;
-    label: string;
+    source?: string;
+    team?: string;
+    label?: string;
+    schedule?: string;
+    task?: string;
 }
 export declare const triggerText: (t: TriggerLike) => string;
+export declare const triggerSpec: (t: TriggerLike) => string;
 export declare const triggersText: (triggers: TriggerLike[]) => string;
 export declare const sameTriggerLike: (a: TriggerLike, b: TriggerLike) => boolean;
 export declare const stepsText: (catalog: StepsCatalog | null, steps: string[]) => string;

package/dist/tui/screens/workflows.js

@@ -28,9 +28,11 @@ export function stepLabel(catalog, id) {
 export function stepName(catalog, id) {
     return catalog?.steps.find((s) => s.id === id)?.name ?? id.replace(/^vs-/, '');
 }
-export const triggerText = (t) => `${t.team} + ${t.label}`;
+export const triggerText = (t) => t.source === 'cron' ? `cron ${t.schedule}` : `${t.source === 'voidtrack' ? 'VoidTrack ' : ''}${t.team} + ${t.label}`;
+// The form `--trigger` takes.
+export const triggerSpec = (t) => t.source === 'cron' ? `cron:${t.schedule}:${t.task}` : t.source === 'voidtrack' ? `voidtrack:${t.team}:${t.label}` : `${t.team}:${t.label}`;
 export const triggersText = (triggers) => triggers.map(triggerText).join(', ');
-export const sameTriggerLike = (a, b) => a.team === b.team && a.label === b.label;
+export const sameTriggerLike = (a, b) => triggerSpec(a) === triggerSpec(b);
 export const stepsText = (catalog, steps) => steps.map((s) => stepLabel(catalog, s)).join(' → ');
 // Two workflows that start on the same TEAM:LABEL: only the first in order
 // starts the card. One entry per (loser, winner) pair.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidlabs.gg/voidshift",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "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"
   },