# Local Task Runner

> Local Task Runner

- Skill: `javimosch/local-task-runner` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/local-task-runner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/local-task-runner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/local-task-runner

---

# Local Task Runner

This skill provides a mechanism to execute Node.js code snippets or full scripts locally on the host machine.
It is the **default execution method** when subagent spawning is unavailable or inefficient.

## Purpose

- **Replace Subagents**: Instead of spawning a full subagent for simple tasks, use this skill to run code directly.
- **Safety**: Isolates execution logic, handles cleanup, and enforces timeouts.
- **Convenience**: No manual file management required (`write` + `exec` + `rm`).

## Usage

When you need to perform a calculation, check system status, or run a utility script:

1.  Construct the Node.js code as a string.
2.  Call `run_task` (or execute via CLI) with the code.

### Command Line Interface

```bash
# Execute a task
node skills/local-task-runner/index.js run --code "console.log('Hello World')"

# Execute with timeout (ms)
node skills/local-task-runner/index.js run --code "while(true){}" --timeout 5000
```

### Response Format

Success:
```
[TASK: <id>] Completed in 123ms
--- STDOUT ---
...
```

Error:
```
[TASK: <id>] Failed in 123ms
Error: ...
--- STDERR ---
...
```