Agentic OS Runner — Development skill for Claude Code

agentic-os-runner

Code companion for a build guide that wires Obsidian + Claude Code into a personal agentic operating system.

This repo contains the orchestration plumbing — the background daemon, the activity-logging hook, and metric-pull script templates. **It is incomplete on its own.** The build guide (separate, paywalled inside the Chase AI+ Skool community) explains the vault layout, daily-note schema, MCP wiring, skill design, and Obsidian plugin that make these pieces useful.

If you're following the guide, clone this repo as instructed and the guide tells Claude Code where each piece lives.

Contents

runner/
  runner.js              # Node daemon — watches the vault's intent queue,
                         # spawns headless `claude -p` subprocesses, writes
                         # run records back to the vault.
                         # Parallel pool (MAX_CONCURRENT=3) + serial-skill
                         # + dedupe-skill gates.
  start-runner.vbs       # Windows launcher (drop in Startup folder)
  start-runner.sh        # macOS / Linux launcher
  package.json

hooks/
  activity-log.js        # PostToolUse hook — appends Claude's tool calls
                         # to today's daily note's `## Activity Log` section.
                         # Cross-process atomic file lock.
  settings.example.json  # Snippet to merge into ~/.claude/settings.json
  package.json

metric-scripts/
  _common.py             # Shared helpers: CSV append, snapshot write, env loader
  pull_template_api.py   # Template — REST API metric pull
  pull_template_scrape.py# Template — Playwright scrape metric pull
  pull_template_local.py # Template — read a local file as a metric
  run_all.ps1            # Windows wrapper — runs every pull_*.py in parallel
  run_all.sh             # macOS / Linux wrapper

Installation

The build guide walks through each step in order. Quick reference for paid members already following along:

# Clone
git clone https://gi