agentic-os-runner - GitLite

KO | EN

gitlite — search

#rag #list #ai #react #pytorch #dotnet #database #claude-code #swift #command-line

agentic-os-runner

(★ 9)

Background daemon + hook + metric-pull templates. Code companion for a private Obsidian agentic-OS build guide.

파일 탐색기

ZIP 다운로드

- - main.ts
  - settings.ts
  - view.tsx
- esbuild.config.mjs.template
- manifest.json.template
- package.json.template
- README.md
- styles.css
- tsconfig.json
- activity-log.js
- package.json
- settings.example.json
- _common.py
- pull_template_api.py
- pull_template_local.py
- pull_template_scrape.py
- run_all.ps1
- run_all.sh
- package.json
- runner.js
- start-runner.sh
- start-runner.vbs
.gitignore
LICENSE
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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:

```bash
# Clone
git clone https://github.com/cth9191/agentic-os-runner.git
cd agentic-os-runner

# Install where the guide expects the files
mkdir -p ~/.claude/agentic-os-runner ~/.claude/hooks ~/.claude/skills/metrics-pull/scripts
cp runner/* ~/.claude/agentic-os-runner/
cp hooks/activity-log.js ~/.claude/hooks/
cp metric-scripts/* ~/.claude/skills/metrics-pull/scripts/
```

Then follow the guide's Phase 4 (metrics) + Phase 5 (runner) + Phase 8 (hook) to wire everything together.

## Configuration

Both `runner.js` and `activity-log.js` resolve the vault root in this order:

1. `AGENTIC_OS_VAULT` environment variable
2. `AGENTIC_OS_VAULT` entry inside `~/.claude/.env`
3. Fallback: `~/the-vault`

Set this once and the whole stack picks it up. The guide explains where to put it.

## Requirements

- Node.js 20+ (runner + hook)
- Python 3.11+ with `playwright` for scrape-template pulls
- Claude Code CLI authenticated
- Obsidian (for the vault these scripts read/write)
- Windows 10/11, macOS 12+, or Linux

## License

MIT. See [LICENSE](./LICENSE).

## Get the full guide

The plumbing here is roughly a third of the build. The vault structure, daily-note schema, plugin scaffold, MCP connector wiring, and the actual skills that drive the cockpit live in the build guide — available inside the Chase AI+ Skool community at https://chaseai.plus (link placeholder).

If you found this repo independently and want to understand what it's for, the video walkthrough on the Chase AI YouTube channel covers the architecture without the install steps.