Skip to content

Commit e238bed

Browse files
author
StackMemory Bot (CLI)
committed
docs: update descriptions for v1.5 features (loop, conductor, snapshot)
- Update package.json description with loop/watch, conductor, snapshot, preflight - Add Loop/Watch CLI section to README with usage examples - Add conductor and loop/watch to README features list - Add loop command to CLAUDE.md - Add 3 feature cards to GitHub Pages site (conductor, loop/watch, snapshot) - Update site meta descriptions
1 parent 783ddec commit e238bed

File tree

4 files changed

+40
-4
lines changed

4 files changed

+40
-4
lines changed

CLAUDE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,7 @@ stackmemory snapshot save # Post-run context snapshot (alias: snap)
6363
stackmemory snapshot list # List recent snapshots
6464
stackmemory preflight # File overlap check for parallel tasks (alias: pf)
6565
stackmemory conductor start # Autonomous Linear→worktree→agent orchestrator
66+
stackmemory loop "<cmd>" --until "<pattern>" # Poll until condition met (alias: watch)
6667
```
6768

6869
## Working Directory

README.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,8 @@ StackMemory is a **production-ready memory runtime** for AI coding tools that pr
2424
- **Automatic hooks** for task tracking, Linear sync, and spec progress
2525
- **Snapshot capture** — post-run context snapshots for session handoff (`snapshot save`)
2626
- **Pre-flight overlap check** — predict file conflicts before parallel task dispatch (`preflight`)
27-
- **Conductor orchestrator** — polls Linear, creates worktrees, spawns agents with bounded concurrency
27+
- **Conductor orchestrator** — polls Linear, creates worktrees, spawns agents with bounded concurrency and auto team detection
28+
- **Loop/Watch command** — poll any shell command until a condition is met (monitor CI, deploys, logs)
2829
- **Memory monitor daemon** with automatic capture/clear on RAM pressure
2930
- **Auto-save service** for periodic context persistence
3031
- **Comprehensive test coverage** across all core modules
@@ -68,6 +69,8 @@ Tools forget decisions and constraints between sessions. StackMemory makes conte
6869
- **Safe branches**: worktree isolation with `--worktree` or `-w`
6970
- **Snapshot**: post-run context capture — records what changed, commits, and decisions (`stackmemory snapshot`)
7071
- **Pre-flight check**: file overlap prediction before parallel task dispatch (`stackmemory preflight`)
72+
- **Loop/Watch**: poll shell commands until conditions are met — monitor CI, deploys, logs (`stackmemory loop`)
73+
- **Conductor**: autonomous orchestrator — polls Linear, creates worktrees, spawns agents with auto team detection
7174
- **Persistent context**: frames, anchors, decisions, retrieval
7275
- **Integrations**: Linear (API key + OAuth), DiffMem, Browser MCP, log-mcp (log analysis)
7376

@@ -389,6 +392,26 @@ stackmemory pf "auth work" "db migration" -f "task1:src/auth.ts;task2:src/db.ts"
389392
stackmemory pf "task A" "task B" "task C" --json
390393
```
391394

395+
### Loop / Watch (`loop` / `watch`)
396+
397+
Poll a shell command until a condition is met. Useful for monitoring CI runs, deploy logs, inboxes, or any external state.
398+
399+
```bash
400+
# Monitor GitHub Actions until complete
401+
stackmemory loop "gh run view <id> --json status -q .status" --until "completed"
402+
403+
# Watch deploy logs for success
404+
stackmemory watch "railway logs --latest" --until "deployed" -i 5s
405+
406+
# Wait for health check to pass
407+
stackmemory loop "curl -s http://localhost:3000/health" --until "ok" -i 3s -t 5m
408+
409+
# JSON output for programmatic use
410+
stackmemory loop "gh pr checks 42 --json state -q '.[0].state'" --until "SUCCESS" --json
411+
```
412+
413+
Options: `--until`, `--until-not`, `--until-empty`, `--until-non-empty`, `--until-exit`, `-i/--interval` (default 10s), `-t/--timeout` (default 30m), `--json`, `-q/--quiet`
414+
392415
---
393416

394417
## Documentation

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@stackmemoryai/stackmemory",
33
"version": "1.5.2",
4-
"description": "Project-scoped memory for AI coding tools. Durable context across sessions with 56 MCP tools, FTS5 search, Claude/Codex/OpenCode wrappers, Linear sync, automatic hooks, and log analysis.",
4+
"description": "Lossless, project-scoped memory for AI coding tools. Durable context across sessions with 56 MCP tools, FTS5 search, conductor orchestrator, loop/watch monitoring, snapshot capture, pre-flight overlap checks, Claude/Codex/OpenCode wrappers, Linear sync, and automatic hooks.",
55
"engines": {
66
"node": ">=20.0.0",
77
"npm": ">=10.0.0"

site/index.html

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
66
<title>StackMemory — Lossless memory for AI coding tools</title>
7-
<meta name="description" content="Lossless, project-scoped memory for AI coding tools. Durable context across sessions with MCP tools, FTS5 search, Linear sync, and automatic hooks.">
7+
<meta name="description" content="Lossless, project-scoped memory for AI coding tools. Durable context across sessions with 56 MCP tools, FTS5 search, conductor orchestrator, loop/watch monitoring, snapshot capture, Linear sync, and automatic hooks.">
88

99
<!-- Open Graph -->
1010
<meta property="og:type" content="website">
1111
<meta property="og:title" content="StackMemory — Lossless memory for AI coding tools">
12-
<meta property="og:description" content="Project-scoped memory runtime that preserves full context across sessions. 56 MCP tools, FTS5 search, Linear sync, Claude/Codex/OpenCode wrappers.">
12+
<meta property="og:description" content="Lossless memory runtime that preserves full context across sessions. 56 MCP tools, FTS5 search, conductor orchestrator, loop/watch monitoring, Linear sync, Claude/Codex/OpenCode wrappers.">
1313
<meta property="og:url" content="https://stackmemoryai.github.io/stackmemory/">
1414
<meta property="og:image" content="https://stackmemoryai.github.io/stackmemory/og-image.png">
1515
<meta property="og:site_name" content="StackMemory">
@@ -138,6 +138,18 @@ <h3 class="font-semibold text-sm">Wrapper Scripts</h3>
138138
<h3 class="font-semibold text-sm">Skills System</h3>
139139
<p class="mt-2 text-sm text-neutral-600 dark:text-neutral-400 leading-relaxed"><code class="bg-neutral-100 dark:bg-neutral-800 px-1 rounded text-xs">/spec</code> for iterative specs, <code class="bg-neutral-100 dark:bg-neutral-800 px-1 rounded text-xs">/linear-run</code> for task execution via RLM orchestration.</p>
140140
</div>
141+
<div class="p-5 rounded-lg border border-neutral-200 dark:border-neutral-800">
142+
<h3 class="font-semibold text-sm">Conductor Orchestrator</h3>
143+
<p class="mt-2 text-sm text-neutral-600 dark:text-neutral-400 leading-relaxed">Polls Linear for tasks, creates git worktrees, spawns agents with bounded concurrency and auto team detection.</p>
144+
</div>
145+
<div class="p-5 rounded-lg border border-neutral-200 dark:border-neutral-800">
146+
<h3 class="font-semibold text-sm">Loop / Watch</h3>
147+
<p class="mt-2 text-sm text-neutral-600 dark:text-neutral-400 leading-relaxed">Poll any shell command until a condition is met. Monitor CI runs, deploy logs, inboxes, and external state with <code class="bg-neutral-100 dark:bg-neutral-800 px-1 rounded text-xs">stackmemory loop</code>.</p>
148+
</div>
149+
<div class="p-5 rounded-lg border border-neutral-200 dark:border-neutral-800">
150+
<h3 class="font-semibold text-sm">Snapshot &amp; Pre-flight</h3>
151+
<p class="mt-2 text-sm text-neutral-600 dark:text-neutral-400 leading-relaxed">Capture post-run context snapshots for session handoff. Pre-flight checks predict file overlaps before parallel task dispatch.</p>
152+
</div>
141153
</div>
142154
</section>
143155

0 commit comments

Comments
 (0)