@agentmessier/restwalker 1.0.0 → 1.0.1

package/README.md

@@ -9,22 +9,22 @@ Runs as a LaunchAgent on port **47290** with a SQLite database, a dashboard UI,
 ## How it works
 
 1. You add tasks to the queue (via dashboard, REST API, or MCP tools in Claude Code)
-2. The gate checks live Claude usage from `api.anthropic.com` — same source as `ccstatusline`
-3. When usage is low and you're outside your coding window, tasks run automatically
+2. The gate checks live Claude usage from `api.anthropic.com` — Claude tracks your token spend in rolling 5-hour and weekly windows
+3. **All gates must be open simultaneously** for a task to run — coding window, 5h budget, and weekly budget
 4. Sessions are recorded; results, token counts, and transcripts are stored per task
 
 ### Budget gates (all configurable)
 
 | Gate | Default | Behaviour |
 |---|---|---|
-| Coding window | 4 PM – 2 AM | Always paused during active hours |
-| 5h usage | ≥ 75% | Pause to protect interactive budget |
+| Coding window | disabled | Optional — enable in Settings to pause during a set time range each day |
+| 5h rolling usage | ≥ 75% | Pause to protect your interactive budget |
 | Weekly ceiling | ≥ 65% | Pause background jobs |
 | Weekly hard stop | ≥ 90% | Hard stop regardless |
 
 ## Install
 
-**Requirements:** macOS, Node.js 20+, Claude Code CLI (must be logged in)
+**Requirements:** macOS, Node.js 20+, Claude Code CLI (`claude login` must have been run — restwalker reads your credentials from the macOS Keychain)
 
 ```bash
 git clone https://github.com/agentmessier-ai/restwalker.git
@@ -57,14 +57,18 @@ Stops the service, removes the LaunchAgent, and optionally deletes `~/.restwalke
 
 `http://localhost:47290`
 
+![Dashboard](docs/screenshot-dashboard.png)
+
 - Live gate status, 5h and weekly usage, next window
 - 48h trend chart with threshold overlays and coding-window shading
 - Task queue: add, paginate, expand rows to view session transcripts and reasoning blocks
-- Agent providers: configure which CLI runs tasks and with what arguments
+- Agent providers: configure which CLI runs tasks (a provider is a command template like `claude --print {{task}}`)
 - Settings: all thresholds configurable without restart
 
 ## Task queue
 
+![Queue](docs/screenshot-queue.png)
+
 Tasks have a description (the prompt), an optional working directory, model, provider, and schedule:
 
 | Schedule | Behaviour |
@@ -88,10 +92,11 @@ The MCP server (`node/mcp.ts`) exposes 17 tools for Claude Code via stdio transp
 | Discovery | `list_models`, `list_projects` |
 | Settings | `get_settings`, `update_settings` |
 
-Register manually if you skipped it during install:
+Register manually if you skipped it during install (replace `~/dev/restwalker` with your clone path):
 
 ```bash
-claude mcp add --scope user restwalker -- node /path/to/node_modules/.bin/tsx /path/to/node/mcp.ts
+claude mcp add --scope user restwalker -- \
+  node ~/dev/restwalker/node/node_modules/.bin/tsx ~/dev/restwalker/node/mcp.ts
 ```
 
 ## API

package/index.html

@@ -214,7 +214,7 @@
       <div class="sub" id="card-weekly-sub"></div>
     </div>
     <div class="card">
-      <div class="label">Next Milestone</div>
+      <div class="label">Next Reset</div>
       <div class="value" id="card-next" style="font-size:18px;padding-top:4px">—</div>
       <div class="sub" id="card-next-sub"></div>
     </div>
@@ -298,7 +298,7 @@
       <div class="setting-row">
         <div>
           <div class="setting-label">Timezone</div>
-          <div class="setting-hint">Coding window hours are interpreted in this timezone</div>
+          <div class="setting-hint">Used for coding window hours</div>
         </div>
         <div class="setting-input-wrap">
           <select class="setting-input" id="s-TIMEZONE" style="width:14rem"></select>
@@ -306,20 +306,34 @@
       </div>
       <div class="setting-row">
         <div>
-          <div class="setting-label">Coding window start</div>
-          <div class="setting-hint">Jobs pause after this time</div>
+          <div class="setting-label">Coding window</div>
+          <div class="setting-hint">Pause jobs during a set time range each day</div>
         </div>
-        <div class="setting-input-wrap">
-          <select class="setting-input" id="s-CODING_START_H" style="width:9rem"></select>
+        <div class="setting-input-wrap" style="display:flex;align-items:center;gap:8px">
+          <label style="display:flex;align-items:center;gap:6px;cursor:pointer;font-size:13px;color:var(--text)">
+            <input type="checkbox" id="s-CODING_WINDOW_ENABLED" onchange="toggleCodingWindow(this.checked)" style="width:15px;height:15px;cursor:pointer;accent-color:var(--blue)">
+            Enable
+          </label>
         </div>
       </div>
-      <div class="setting-row">
-        <div>
-          <div class="setting-label">Coding window end</div>
-          <div class="setting-hint">Jobs resume after this time</div>
+      <div id="coding-window-times" style="display:none">
+        <div class="setting-row" style="padding-left:16px">
+          <div>
+            <div class="setting-label">Start</div>
+            <div class="setting-hint">Jobs pause from this hour</div>
+          </div>
+          <div class="setting-input-wrap">
+            <select class="setting-input" id="s-CODING_START_H" style="width:9rem"></select>
+          </div>
         </div>
-        <div class="setting-input-wrap">
-          <select class="setting-input" id="s-CODING_END_H" style="width:9rem"></select>
+        <div class="setting-row" style="padding-left:16px">
+          <div>
+            <div class="setting-label">End</div>
+            <div class="setting-hint">Jobs resume at this hour</div>
+          </div>
+          <div class="setting-input-wrap">
+            <select class="setting-input" id="s-CODING_END_H" style="width:9rem"></select>
+          </div>
         </div>
       </div>
     </div>
@@ -444,10 +458,10 @@ function barColor(pct, warnAt, stopAt) {
 function isCodingHour(date, startH, endH) {
   try {
     const h = parseInt(new Intl.DateTimeFormat('en-US',{timeZone:tz,hour:'numeric',hour12:false}).format(date));
-    return h >= startH || h < endH;
+    return startH < endH ? h >= startH && h < endH : h >= startH || h < endH;
   } catch {
     const pstH = ((date.getUTCHours() - 8 + 24) % 24);
-    return pstH >= startH || pstH < endH;
+    return startH < endH ? pstH >= startH && pstH < endH : pstH >= startH || pstH < endH;
   }
 }
 function slope(points) {
@@ -480,9 +494,9 @@ function buildCodingBands(startMs, endMs, startH, endH) {
 function renderChart(fiveH, weekly, startMs, endMs, thr) {
   const ctx = document.getElementById('chart').getContext('2d');
   if (chart) chart.destroy();
-  const startH = thr.coding_start_h ?? 16;
-  const endH   = thr.coding_end_h   ?? 2;
-  const coding = buildCodingBands(startMs, endMs, startH, endH);
+  const startH = thr.coding_start_h ?? 9;
+  const endH   = thr.coding_end_h   ?? 18;
+  const coding = thr.coding_window_enabled ? buildCodingBands(startMs, endMs, startH, endH) : [];
 
   chart = new Chart(ctx, {
     type: 'line',
@@ -690,7 +704,11 @@ function buildHourSelects() {
   });
 }
 
-const SETTING_KEYS = ['CODING_START_H','CODING_END_H','TIMEZONE','FIVE_HOUR_PAUSE_PCT','WEEKLY_RESERVE_PCT','WEEKLY_HARD_STOP_PCT','POLL_INTERVAL_MIN','CACHE_STALE_MIN'];
+const SETTING_KEYS = ['CODING_WINDOW_ENABLED','CODING_START_H','CODING_END_H','TIMEZONE','FIVE_HOUR_PAUSE_PCT','WEEKLY_RESERVE_PCT','WEEKLY_HARD_STOP_PCT','POLL_INTERVAL_MIN','CACHE_STALE_MIN'];
+
+function toggleCodingWindow(enabled) {
+  document.getElementById('coding-window-times').style.display = enabled ? 'block' : 'none';
+}
 
 async function openSettings() {
   buildHourSelects();
@@ -702,6 +720,7 @@ async function openSettings() {
   for (const k of SETTING_KEYS) {
     const el = document.getElementById('s-'+k);
     if (!el) continue;
+    if (el.type === 'checkbox') { el.checked = cfg[k] === '1'; toggleCodingWindow(el.checked); continue; }
     el.value = cfg[k] ?? '';
     const vEl = document.getElementById('v-'+k);
     if (vEl && SLIDER_KEYS[k]) vEl.textContent = (cfg[k] ?? '') + SLIDER_KEYS[k];
@@ -723,7 +742,8 @@ async function saveSettings() {
   const body = {};
   for (const k of SETTING_KEYS) {
     const el = document.getElementById('s-'+k);
-    if (el) body[k] = el.value;
+    if (!el) continue;
+    body[k] = el.type === 'checkbox' ? (el.checked ? '1' : '0') : el.value;
   }
   const res = await fetch('/settings', { method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify(body) });
   if (res.ok) {
@@ -857,7 +877,8 @@ async function loadProjects() {
   sel.innerHTML =
     `<option value="">— home dir (blank) —</option>` +
     projects.map(p => {
-      const label = p.cwd.replace('/Users/missa/', '~/').replace('/Users/missa', '~')
+      const home = data?.home ?? ''
+      const label = home ? p.cwd.replace(home + '/', '~/').replace(home, '~') : p.cwd
       return `<option value="${p.cwd}">${label}</option>`
     }).join('') +
     `<option value="__custom__">Other…</option>`
@@ -906,7 +927,7 @@ function scheduleChip(t) {
   if (!t.schedule || t.schedule === 'once') return ''
   const label = SCHEDULE_LABELS[t.schedule] || t.schedule
   if (t.status === 'scheduled' && t.next_run_at) {
-    return `<span style="font-size:10px;background:rgba(167,139,250,.15);color:#a78bfa;padding:1px 6px;border-radius:3px;margin-left:4px">${label} · runs ${qTimeSince(t.next_run_at)}</span>`
+    return `<span style="font-size:10px;background:rgba(167,139,250,.15);color:#a78bfa;padding:1px 6px;border-radius:3px;margin-left:4px">${label} · next run ${qTimeSince(t.next_run_at)}</span>`
   }
   return `<span style="font-size:10px;background:rgba(167,139,250,.15);color:#a78bfa;padding:1px 6px;border-radius:3px;margin-left:4px">${label}</span>`
 }
@@ -914,9 +935,16 @@ function scheduleChip(t) {
 function qTimeSince(iso) {
   if (!iso) return ''
   const d = (Date.now() - new Date(iso).getTime()) / 1000
+  if (d < 0) {
+    const f = -d
+    if (f < 3600) return `in ${Math.round(f/60)}m`
+    if (f < 86400) return `in ${Math.round(f/3600)}h`
+    return `in ${Math.round(f/86400)}d`
+  }
   if (d < 60) return `${Math.round(d)}s ago`
   if (d < 3600) return `${Math.round(d/60)}m ago`
-  return `${Math.round(d/3600)}h ago`
+  if (d < 86400) return `${Math.round(d/3600)}h ago`
+  return `${Math.round(d/86400)}d ago`
 }
 
 function qBadge(status) {

package/node/app.ts

@@ -219,6 +219,7 @@ app.get('/status', {
           thresholds: {
             type: 'object',
             properties: {
+              coding_window_enabled: { type: 'boolean' },
               coding_start_h:       { type: 'number' },
               coding_end_h:         { type: 'number' },
               timezone:             { type: 'string' },
@@ -246,7 +247,7 @@ app.get('/status', {
   const tz     = cfg.TIMEZONE
 
   return {
-    window:         scheduler.isCodingWindow(now, startH, endH, tz) ? 'coding' : 'idle',
+    window:         cfg.CODING_WINDOW_ENABLED === '1' && scheduler.isCodingWindow(now, startH, endH, tz) ? 'coding' : 'idle',
     next_idle_in_s: scheduler.nextIdleInS(now, startH, endH, tz),
     ok:             decision.ok,
     provider:       decision.provider,
@@ -261,6 +262,7 @@ app.get('/status', {
     },
     last_db_snapshot: snap,
     thresholds: {
+      coding_window_enabled: cfg.CODING_WINDOW_ENABLED === '1',
       coding_start_h:       startH,
       coding_end_h:         endH,
       timezone:             tz,
@@ -471,6 +473,7 @@ app.get('/projects', {
   } catch { return { projects: [] } }
 
   return {
+    home: homedir(),
     projects: [...seen.entries()]
       .sort((a, b) => b[1] - a[1])
       .map(([cwd, ts]) => ({ cwd, last_active: new Date(ts).toISOString() }))

package/node/db.ts

@@ -24,6 +24,7 @@ const db = drizzle(client, { schema })
 // ── Types ──────────────────────────────────────────────────────────────────────
 
 export interface Settings {
+  CODING_WINDOW_ENABLED: string   // '0' or '1'
   CODING_START_H:       string
   CODING_END_H:         string
   TIMEZONE:             string
@@ -56,8 +57,9 @@ export interface Snapshot {
 }
 
 export const SETTING_DEFAULTS: Settings = {
-  CODING_START_H:       process.env.CODING_START_H        ?? '16',
-  CODING_END_H:         process.env.CODING_END_H          ?? '2',
+  CODING_WINDOW_ENABLED: process.env.CODING_WINDOW_ENABLED ?? '0',
+  CODING_START_H:       process.env.CODING_START_H        ?? '9',
+  CODING_END_H:         process.env.CODING_END_H          ?? '18',
   TIMEZONE:             process.env.TIMEZONE              ?? 'America/Los_Angeles',
   FIVE_HOUR_PAUSE_PCT:  process.env.FIVE_HOUR_PAUSE_PCT   ?? '75',
   WEEKLY_RESERVE_PCT:   process.env.WEEKLY_RESERVE_PCT    ?? '35',

package/node/mcp.ts

@@ -196,6 +196,7 @@ server.tool(
   'update_settings',
   'Update one or more daemon settings',
   {
+    CODING_WINDOW_ENABLED: z.enum(['0','1']).optional().describe('Enable coding window time gate (1=on, 0=off)'),
     CODING_START_H:       z.string().optional().describe('Hour (0-23) coding window starts'),
     CODING_END_H:         z.string().optional().describe('Hour (0-23) coding window ends'),
     TIMEZONE:             z.string().optional().describe('IANA timezone, e.g. America/Los_Angeles'),

package/node/scheduler.ts

@@ -162,12 +162,14 @@ function localHour(date: Date, tz: string): number {
   }
 }
 
-export function isCodingWindow(now = new Date(), startH = 16, endH = 2, tz = 'America/Los_Angeles'): boolean {
+export function isCodingWindow(now = new Date(), startH = 0, endH = 0, tz = 'America/Los_Angeles'): boolean {
+  if (startH === endH) return false  // 0,0 = disabled
   const h = localHour(now, tz)
-  return h >= startH || h < endH
+  if (startH < endH) return h >= startH && h < endH
+  return h >= startH || h < endH    // wraps midnight e.g. 22–6
 }
 
-export function nextIdleInS(now = new Date(), startH = 16, endH = 2, tz = 'America/Los_Angeles'): number {
+export function nextIdleInS(now = new Date(), startH = 0, endH = 0, tz = 'America/Los_Angeles'): number {
   if (!isCodingWindow(now, startH, endH, tz)) return 0
   const h = localHour(now, tz)
   const m = now.getMinutes()
@@ -191,7 +193,7 @@ export async function canRun(usage: UsageData | null, cfg: Settings): Promise<Ca
 
   const now = new Date()
 
-  if (isCodingWindow(now, startH, endH, tz)) {
+  if (cfg.CODING_WINDOW_ENABLED === '1' && isCodingWindow(now, startH, endH, tz)) {
     const idleIn = nextIdleInS(now, startH, endH, tz)
     return {
       ok: false, provider: null, next_idle_in_s: idleIn,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmessier/restwalker",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "While you rest, it walks — idle-time Claude task runner for Mac",
   "type": "module",
   "bin": {