loop-task 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quique Fdez Guerra
+
+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

@@ -0,0 +1,113 @@
+# loop-task
+
+A cross-platform CLI that repeatedly executes a shell command at a human-readable interval.
+
+Inspired by agent loops, but intentionally simple.
+
+## Installation
+
+```bash
+npm install -g loop-task
+```
+
+Or use directly with npx:
+
+```bash
+npx loop-task 30m npm test
+```
+
+## Usage
+
+```bash
+loop [options] <interval> <command>
+```
+
+### Basic examples
+
+```bash
+loop 30m npm test
+loop 1h opencode --prompt '/ob-init'
+loop 1d node sync.js
+```
+
+### With npx
+
+```bash
+npx loop-task 30m npm test
+npx loop-task 1h opencode --prompt '/ob-init'
+```
+
+### Options
+
+Options must come before the interval:
+
+| Option            | Description                      |
+| ----------------- | -------------------------------- |
+| `--immediate`     | Run immediately before waiting   |
+| `--max-runs <n>`  | Stop after N executions          |
+| `--verbose`       | Show execution details           |
+| `-h, --help`      | Display help                     |
+| `-V, --version`   | Display version                  |
+
+## Examples
+
+### Agent workflows
+
+```bash
+npx loop-task 30m opencode --prompt "search for missing translation text and translate them, 3 maximum" --model "opencode/big-pickle"
+```
+
+### Run tests every 30 minutes
+
+```bash
+loop 30m npm test
+```
+
+### Run immediately, then every hour
+
+```bash
+loop --immediate 1h npm test
+```
+
+### Run up to 5 times then stop
+
+```bash
+loop --max-runs 5 5m npm test
+```
+
+### Verbose mode
+
+```bash
+loop --verbose 30m npm test
+```
+
+Shows start/end timestamps, exit code, execution duration, and next scheduled run.
+
+## Supported intervals
+
+| Format | Description |
+| ------ | ----------- |
+| `10s`  | 10 seconds  |
+| `5m`   | 5 minutes   |
+| `1h`   | 1 hour      |
+| `1d`   | 1 day       |
+| `1w`   | 1 week      |
+
+## Behavior
+
+- **No overlapping**: waits for the command to finish before starting the next interval
+- **Resilient**: continues looping even if a command exits with a non-zero code
+- **Graceful shutdown**: finishes current execution on Ctrl+C, then exits cleanly
+
+## Development
+
+```bash
+pnpm install
+pnpm run build
+pnpm run test
+pnpm run lint
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { parseDuration } from "./duration.js";
+import { Logger } from "./logger.js";
+import { runLoop } from "./loop.js";
+const program = new Command();
+program
+    .name("loop")
+    .description("Repeatedly execute a shell command at a human-readable interval")
+    .version("1.0.0")
+    .argument("<interval>", "Interval between runs (e.g. 10s, 5m, 1h, 1d, 1w)")
+    .argument("<command...>", "Command to execute")
+    .option("--immediate", "Run immediately before waiting", false)
+    .option("--max-runs <n>", "Stop after N executions", (v) => {
+    const n = parseInt(v, 10);
+    if (isNaN(n) || n < 1) {
+        throw new Error("--max-runs must be a positive integer");
+    }
+    return n;
+}, null)
+    .option("--verbose", "Show execution details", false)
+    .enablePositionalOptions()
+    .passThroughOptions()
+    .addHelpText("before", `
+Usage:
+  loop [options] <interval> <command>
+
+Examples:
+  loop 30m npm test
+  loop 1h opencode --prompt '/ob-init'
+  loop --immediate 1h npm test
+  loop --max-runs 5 5m npm test
+`)
+    .action(async (intervalStr, commandParts, opts) => {
+    const logger = new Logger(opts.verbose);
+    let interval;
+    try {
+        interval = parseDuration(intervalStr);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`Error: ${message}`);
+        process.exit(1);
+    }
+    const command = commandParts.join(" ");
+    const options = {
+        interval,
+        command,
+        immediate: opts.immediate,
+        maxRuns: opts.maxRuns,
+        verbose: opts.verbose,
+    };
+    const controller = new AbortController();
+    process.on("SIGINT", () => controller.abort());
+    process.on("SIGTERM", () => controller.abort());
+    await runLoop(options, logger, controller.signal);
+    process.exit(0);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CACV,iEAAiE,CAClE;KACA,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,YAAY,EAAE,kDAAkD,CAAC;KAC1E,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;KAC9C,MAAM,CAAC,aAAa,EAAE,gCAAgC,EAAE,KAAK,CAAC;KAC9D,MAAM,CAAC,gBAAgB,EAAE,yBAAyB,EAAE,CAAC,CAAC,EAAE,EAAE;IACzD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,EAAE,IAAI,CAAC;KACP,MAAM,CAAC,WAAW,EAAE,wBAAwB,EAAE,KAAK,CAAC;KACpD,uBAAuB,EAAE;KACzB,kBAAkB,EAAE;KACpB,WAAW,CACV,QAAQ,EACR;;;;;;;;;CASH,CACE;KACA,MAAM,CAAC,KAAK,EAAE,WAAmB,EAAE,YAAsB,EAAE,IAA6B,EAAE,EAAE;IAC3F,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAkB,CAAC,CAAC;IAEnD,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAgB;QAC3B,QAAQ;QACR,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,SAAoB;QACpC,OAAO,EAAE,IAAI,CAAC,OAAwB;QACtC,OAAO,EAAE,IAAI,CAAC,OAAkB;KACjC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAEhD,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/duration.d.ts

@@ -0,0 +1,3 @@
+export declare function parseDuration(input: string): number;
+export declare function formatDuration(value: number): string;
+//# sourceMappingURL=duration.d.ts.map

package/dist/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBnD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/duration.js

@@ -0,0 +1,19 @@
+import ms from "ms";
+export function parseDuration(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error("Duration cannot be empty");
+    }
+    const result = ms(trimmed);
+    if (typeof result !== "number" || isNaN(result)) {
+        throw new Error(`Invalid duration: "${input}". Use formats like 10s, 5m, 1h, 1d, 1w`);
+    }
+    if (result <= 0) {
+        throw new Error(`Duration must be positive, got: "${input}"`);
+    }
+    return result;
+}
+export function formatDuration(value) {
+    return ms(value, { long: true });
+}
+//# sourceMappingURL=duration.js.map

package/dist/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC,OAA8C,CAAC,CAAC;IAElE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,yCAAyC,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+export declare class Logger {
+    private verbose;
+    constructor(verbose?: boolean);
+    info(message: string): void;
+    error(message: string): void;
+    success(message: string): void;
+    debug(message: string): void;
+    warn(message: string): void;
+    timestamp(): string;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,UAAQ;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,SAAS,IAAI,MAAM;CAGpB"}

package/dist/logger.js

@@ -0,0 +1,27 @@
+export class Logger {
+    verbose;
+    constructor(verbose = false) {
+        this.verbose = verbose;
+    }
+    info(message) {
+        console.log(message);
+    }
+    error(message) {
+        console.error(message);
+    }
+    success(message) {
+        console.log(message);
+    }
+    debug(message) {
+        if (this.verbose) {
+            console.log(`[verbose] ${message}`);
+        }
+    }
+    warn(message) {
+        console.warn(message);
+    }
+    timestamp() {
+        return new Date().toISOString();
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,MAAM;IACT,OAAO,CAAU;IAEzB,YAAY,OAAO,GAAG,KAAK;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}

package/dist/loop.d.ts

@@ -0,0 +1,5 @@
+import type { LoopOptions, ExecutionResult } from "./types.js";
+import { Logger } from "./logger.js";
+export declare function executeCommand(command: string, logger: Logger): Promise<ExecutionResult>;
+export declare function runLoop(options: LoopOptions, logger: Logger, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAa,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAwBrC,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAiC1B;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAyFf"}

package/dist/loop.js

@@ -0,0 +1,118 @@
+import { execaCommand } from "execa";
+import { formatDuration } from "./duration.js";
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export async function executeCommand(command, logger) {
+    const startedAt = new Date();
+    logger.debug(`Executing: ${command}`);
+    try {
+        const result = await execaCommand(command, {
+            stdout: "inherit",
+            stderr: "inherit",
+            stdin: "inherit",
+        });
+        const endedAt = new Date();
+        return {
+            exitCode: result.exitCode ?? 0,
+            duration: endedAt.getTime() - startedAt.getTime(),
+            startedAt,
+            endedAt,
+        };
+    }
+    catch (error) {
+        const endedAt = new Date();
+        const exitCode = error && typeof error === "object" && "exitCode" in error
+            ? error.exitCode
+            : 1;
+        return {
+            exitCode,
+            duration: endedAt.getTime() - startedAt.getTime(),
+            startedAt,
+            endedAt,
+        };
+    }
+}
+export async function runLoop(options, logger, signal) {
+    const state = {
+        running: false,
+        runCount: 0,
+        shuttingDown: false,
+    };
+    const onSignal = () => {
+        state.shuttingDown = true;
+        logger.info("\nShutting down gracefully...");
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+        let isFirstRun = true;
+        while (!state.shuttingDown) {
+            if (options.maxRuns !== null &&
+                state.runCount >= options.maxRuns) {
+                logger.info(`Completed ${state.runCount} run(s). Exiting.`);
+                break;
+            }
+            if (isFirstRun && !options.immediate) {
+                logger.info(`Waiting ${formatDuration(options.interval)} before first run...`);
+                try {
+                    await sleep(options.interval, signal);
+                }
+                catch {
+                    break;
+                }
+                if (state.shuttingDown)
+                    break;
+            }
+            isFirstRun = false;
+            state.running = true;
+            state.runCount++;
+            logger.info(`\n--- Run ${state.runCount}${options.maxRuns !== null ? `/${options.maxRuns}` : ""} ---`);
+            const result = await executeCommand(options.command, logger);
+            state.running = false;
+            if (result.exitCode !== 0) {
+                logger.error(`Command failed with exit code ${result.exitCode}`);
+            }
+            if (options.verbose) {
+                logger.debug(`Started at:  ${result.startedAt.toISOString()}`);
+                logger.debug(`Ended at:    ${result.endedAt.toISOString()}`);
+                logger.debug(`Exit code:   ${result.exitCode}`);
+                logger.debug(`Duration:    ${formatDuration(result.duration)}`);
+            }
+            if (state.shuttingDown)
+                break;
+            if (options.maxRuns !== null &&
+                state.runCount >= options.maxRuns) {
+                logger.info(`Completed ${state.runCount} run(s). Exiting.`);
+                break;
+            }
+            const nextRun = new Date(Date.now() + options.interval);
+            logger.info(`Next run in ${formatDuration(options.interval)} (at ${nextRun.toLocaleTimeString()})`);
+            try {
+                await sleep(options.interval, signal);
+            }
+            catch {
+                break;
+            }
+        }
+    }
+    finally {
+        process.removeListener("SIGINT", onSignal);
+        process.removeListener("SIGTERM", onSignal);
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+export interface LoopOptions {
+    interval: number;
+    command: string;
+    immediate: boolean;
+    maxRuns: number | null;
+    verbose: boolean;
+}
+export interface ExecutionResult {
+    exitCode: number;
+    duration: number;
+    startedAt: Date;
+    endedAt: Date;
+}
+export interface LoopState {
+    running: boolean;
+    runCount: number;
+    shuttingDown: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "loop-task",
+  "version": "1.0.0",
+  "description": "A cross-platform CLI that repeatedly executes a shell command at a human-readable interval",
+  "type": "module",
+  "bin": {
+    "loop": "dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "cli",
+    "loop",
+    "repeat",
+    "interval",
+    "schedule",
+    "timer",
+    "cron",
+    "automation",
+    "devops",
+    "agent"
+  ],
+  "author": "Quique Fdez Guerra",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "execa": "^9.6.0",
+    "ms": "^2.1.3"
+  },
+  "devDependencies": {
+    "@types/ms": "^2.1.0",
+    "@types/node": "^22.15.0",
+    "@vitest/coverage-v8": "^3.1.0",
+    "eslint": "^9.25.0",
+    "typescript": "^5.8.0",
+    "typescript-eslint": "^8.30.0",
+    "vitest": "^3.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ tests/",
+    "typecheck": "tsc --noEmit",
+    "release:dry": "pnpm run build && pnpm publish --dry-run",
+    "release": "pnpm run build && pnpm publish"
+  }
+}