Skip to content

Commit 504e791

Browse files
feat: add Prompt Forge (GEPA), extensions system, and feature docs
- Prompt Forge: Genetic Eval-driven Prompt Algorithm for CLAUDE.md optimization - Auto-optimize watcher with before/after comparison - 6 mutation strategies: rephrase, add_examples, remove_redundancy, etc. - Reflection engine for targeted improvements - Integrated into claude-sm/claude-smd wrappers - Extension system: Plugin architecture for custom integrations - Provider adapters for multi-model support - Custom tools framework with validation - Browser sandbox runtime for safe execution - Extension loader with hot-reload capability - Feature documentation in README.md: - Predictive Edit, Code Review, Prompt Forge - Model Switcher, Safe Branch, Mobile Sync - Session Insights, Task Alert - Updated package.json description and keywords Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 097cad1 commit 504e791

29 files changed

Lines changed: 9209 additions & 168 deletions

CLAUDE.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,8 @@ Quick reference (agent_docs/):
3535
- claude_hooks.md - Hooks
3636

3737
Full documentation (docs/):
38+
- principles.md - Agent programming paradigm
39+
- architecture.md - Extension model and browser sandbox
3840
- SPEC.md - Technical specification
3941
- API_REFERENCE.md - API docs
4042
- DEVELOPMENT.md - Dev guide

README.md

Lines changed: 105 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# StackMemory
22

3-
**Lossless, project-scoped memory for AI tools** • v0.5.51
3+
**Lossless, project-scoped memory for AI tools** • v0.5.59
44

55
StackMemory is a **production-ready memory runtime** for AI coding tools that preserves full project context across sessions:
66

@@ -36,6 +36,110 @@ StackMemory solves this by:
3636

3737
---
3838

39+
## Features
40+
41+
StackMemory includes powerful features to enhance your AI coding workflow. Enable/disable with `claude-sm config setup`.
42+
43+
### Predictive Edit
44+
45+
Anticipates your next edit and displays suggestions as a status bar overlay. Powered by llama-server and Claude Code's PostToolUse hooks.
46+
47+
```bash
48+
claude-sm --sweep # Enable (default: on)
49+
claude-sm --no-sweep # Disable
50+
```
51+
52+
- **How it works**: Analyzes tool outputs and predicts likely follow-up edits
53+
- **Interface**: Tab to accept, Esc to dismiss
54+
- **Requirement**: Installs `node-pty` on first use
55+
56+
### Code Review
57+
58+
AI-powered code review using Greptile's codebase-aware analysis. Automatically registers the Greptile MCP server for deep repository understanding.
59+
60+
```bash
61+
claude-sm --greptile # Enable (default: on)
62+
claude-sm --no-greptile # Disable
63+
```
64+
65+
- **Tools provided**: `index_repository`, `query_repository`, `get_repository_info`
66+
- **Requirement**: `GREPTILE_API_KEY` in `.env`
67+
68+
### Prompt Forge
69+
70+
Genetic Eval-driven Prompt Algorithm (GEPA) for automatic system prompt optimization. Evolves your `CLAUDE.md` through mutation, evaluation, and selection.
71+
72+
```bash
73+
claude-sm --gepa # Enable
74+
claude-sm --no-gepa # Disable (default)
75+
```
76+
77+
- **Auto-optimize**: Watches `CLAUDE.md` and runs optimization on changes
78+
- **Strategies**: rephrase, add_examples, remove_redundancy, restructure, add_constraints, simplify
79+
- **Output**: Before/after comparison with metrics (lines, tokens, rules)
80+
81+
### Model Switcher
82+
83+
Dynamic model routing based on task complexity. Automatically selects the optimal model (Haiku/Sonnet/Opus) for each request.
84+
85+
```bash
86+
claude-sm --model-routing # Enable
87+
claude-sm --no-model-routing # Disable (default)
88+
```
89+
90+
- **Cost optimization**: Uses cheaper models for simple tasks
91+
- **Quality preservation**: Routes complex tasks to more capable models
92+
93+
### Safe Branch
94+
95+
Git worktree isolation for experimental changes. Each session operates in an isolated branch, preventing accidental commits to main.
96+
97+
```bash
98+
claude-sm --worktree # Enable
99+
claude-sm --no-worktree # Disable (default)
100+
```
101+
102+
- **Isolation**: Changes happen in a separate worktree
103+
- **Safety**: Main branch remains untouched until explicit merge
104+
105+
### Mobile Sync
106+
107+
WhatsApp notifications for session updates and task completion. Stay informed even when away from your terminal.
108+
109+
```bash
110+
claude-sm --whatsapp # Enable
111+
claude-sm --no-whatsapp # Disable (default)
112+
```
113+
114+
- **Notifications**: Session start, task completion, errors
115+
- **Interactive**: Reply to trigger actions remotely
116+
117+
### Session Insights
118+
119+
Detailed tracing of session activity for debugging and optimization. Tracks tool calls, timing, and decision paths.
120+
121+
```bash
122+
claude-sm --tracing # Enable
123+
claude-sm --no-tracing # Disable (default)
124+
```
125+
126+
- **Visibility**: Full execution trace
127+
- **Analytics**: Performance metrics and patterns
128+
129+
### Task Alert
130+
131+
Desktop/terminal notifications when long-running tasks complete. Never miss a completed build or test run.
132+
133+
```bash
134+
claude-sm --notify-on-done # Enable (default: on)
135+
claude-sm --no-notify-on-done # Disable
136+
```
137+
138+
- **Platforms**: macOS notifications, terminal bell
139+
- **Smart**: Only notifies for tasks taking >10 seconds
140+
141+
---
142+
39143
## Core concepts (quick mental model)
40144

41145
| Concept | Meaning |

0 commit comments

Comments
 (0)