Skip to content

Commit ab2bef8

Browse files
jonathanpeterwujonathanpeterwu
committed
feat(cli): interactive feature setup wizard and on-demand deps
- Add `claude-sm config setup` interactive checkbox wizard - Remove node-pty from optionalDependencies (install on demand) - Auto-install node-pty when Sweep enabled in setup - Prompt for GREPTILE_API_KEY and register MCP in setup - Add E2E test script for setup flow - Version bump to 0.5.51
1 parent 0ad8e58 commit ab2bef8

File tree

4 files changed

+317
-8
lines changed

4 files changed

+317
-8
lines changed

‎README.md‎

Lines changed: 8 additions & 5 deletions
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.50
3+
**Lossless, project-scoped memory for AI tools** • v0.5.51
44

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

@@ -488,19 +488,22 @@ stackmemory mcp-server [--port 3001]
488488
- Hosted: **Private beta**
489489
- OSS mirror: **Production ready**
490490
- MCP integration: **Stable**
491-
- CLI: **v0.5.50** - Zero-config setup, diagnostics, full task/context/Linear management
491+
- CLI: **v0.5.51** - Zero-config setup, diagnostics, full task/context/Linear management
492492
- Two-tier storage: **Complete**
493493
- Test Suite: **480 tests passing**
494494

495495
---
496496

497497
## Changelog
498498

499-
### v0.5.50 (2026-01-28)
499+
### v0.5.51 (2026-01-28)
500+
- **Interactive feature setup**: `claude-sm config setup` wizard to toggle features and install deps on demand
501+
- Checkbox prompt for all features (Sweep, Greptile, Model Routing, Worktree, WhatsApp, Tracing)
502+
- Auto-installs `node-pty` when Sweep is enabled
503+
- Prompts for `GREPTILE_API_KEY` and registers MCP server when Greptile is enabled
500504
- **Sweep next-edit predictions**: PTY wrapper displays predicted edits as a status bar in Claude Code sessions. Tab to accept, Esc to dismiss. Powered by llama-server via PostToolUse hooks.
501505
- `claude-sm --sweep` (default: on) or `stackmemory sweep wrap`
502-
- Optional dependency: `npm install node-pty`
503-
- Components: state-watcher, status-bar, tab-interceptor, pty-wrapper
506+
- `node-pty` installed on demand via setup (no longer in optionalDependencies)
504507
- **Greptile AI code review**: Auto-registers Greptile MCP server for codebase-aware code review.
505508
- `claude-sm --greptile` (default: on)
506509
- Requires `GREPTILE_API_KEY` in `.env`

‎package.json‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@stackmemoryai/stackmemory",
3-
"version": "0.5.50",
3+
"version": "0.5.51",
44
"description": "Lossless memory runtime for AI coding tools - organizes context as a call stack instead of linear chat logs, with team collaboration and infinite retention",
55
"engines": {
66
"node": ">=20.0.0",
@@ -151,7 +151,6 @@
151151
"optionalDependencies": {
152152
"blessed": "^0.1.81",
153153
"blessed-contrib": "^4.11.0",
154-
"chokidar": "^5.0.0",
155-
"node-pty": "^1.1.0"
154+
"chokidar": "^5.0.0"
156155
}
157156
}

‎scripts/test-setup-e2e.sh‎

Lines changed: 154 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
1+
#!/usr/bin/env bash
2+
# E2E test for claude-sm config setup
3+
# Tests the interactive setup wizard flow
4+
5+
set -euo pipefail
6+
7+
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
8+
PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
9+
CONFIG_PATH="$HOME/.stackmemory/claude-sm.json"
10+
BACKUP_PATH="$HOME/.stackmemory/claude-sm.json.bak"
11+
12+
# Colors
13+
RED='\033[0;31m'
14+
GREEN='\033[0;32m'
15+
GRAY='\033[0;90m'
16+
NC='\033[0m'
17+
18+
pass=0
19+
fail=0
20+
21+
ok() { echo -e " ${GREEN}PASS${NC} $1"; pass=$((pass + 1)); }
22+
ko() { echo -e " ${RED}FAIL${NC} $1"; fail=$((fail + 1)); }
23+
24+
echo "=== claude-sm config setup E2E tests ==="
25+
echo ""
26+
27+
# Backup existing config
28+
if [ -f "$CONFIG_PATH" ]; then
29+
cp "$CONFIG_PATH" "$BACKUP_PATH"
30+
echo -e "${GRAY}Backed up existing config${NC}"
31+
fi
32+
33+
# 1. Test config show works
34+
echo "--- Test: config show ---"
35+
output=$(node "$PROJECT_DIR/dist/cli/claude-sm.js" config show 2>&1 || true)
36+
if echo "$output" | grep -q "defaultSweep"; then
37+
ok "config show displays defaultSweep"
38+
else
39+
ko "config show missing defaultSweep"
40+
fi
41+
if echo "$output" | grep -q "defaultGreptile"; then
42+
ok "config show displays defaultGreptile"
43+
else
44+
ko "config show missing defaultGreptile"
45+
fi
46+
47+
# 2. Test config set sweep
48+
echo "--- Test: config set sweep ---"
49+
node "$PROJECT_DIR/dist/cli/claude-sm.js" config set sweep false 2>&1
50+
output=$(node "$PROJECT_DIR/dist/cli/claude-sm.js" config show 2>&1 || true)
51+
if echo "$output" | grep -q "defaultSweep.*false\|defaultSweep"; then
52+
ok "config set sweep false applied"
53+
else
54+
ko "config set sweep false not applied"
55+
fi
56+
57+
node "$PROJECT_DIR/dist/cli/claude-sm.js" config set sweep true 2>&1
58+
output=$(node "$PROJECT_DIR/dist/cli/claude-sm.js" config show 2>&1 || true)
59+
if echo "$output" | grep -q "defaultSweep.*true\|defaultSweep"; then
60+
ok "config set sweep true applied"
61+
else
62+
ko "config set sweep true not applied"
63+
fi
64+
65+
# 3. Test config set greptile
66+
echo "--- Test: config set greptile ---"
67+
node "$PROJECT_DIR/dist/cli/claude-sm.js" config set greptile false 2>&1
68+
output=$(node "$PROJECT_DIR/dist/cli/claude-sm.js" config show 2>&1 || true)
69+
if echo "$output" | grep -q "defaultGreptile"; then
70+
ok "config set greptile applied"
71+
else
72+
ko "config set greptile not applied"
73+
fi
74+
75+
# 4. Test config greptile-on / greptile-off
76+
echo "--- Test: greptile-on/off ---"
77+
node "$PROJECT_DIR/dist/cli/claude-sm.js" config greptile-on 2>&1
78+
if grep -q '"defaultGreptile":.*true' "$CONFIG_PATH"; then
79+
ok "greptile-on sets true in config file"
80+
else
81+
ko "greptile-on did not set true"
82+
fi
83+
84+
node "$PROJECT_DIR/dist/cli/claude-sm.js" config greptile-off 2>&1
85+
if grep -q '"defaultGreptile":.*false' "$CONFIG_PATH"; then
86+
ok "greptile-off sets false in config file"
87+
else
88+
ko "greptile-off did not set false"
89+
fi
90+
91+
# 5. Test that setup command exists (non-interactive check)
92+
echo "--- Test: setup command exists ---"
93+
output=$(node "$PROJECT_DIR/dist/cli/claude-sm.js" config --help 2>&1 || true)
94+
if echo "$output" | grep -q "setup"; then
95+
ok "setup command listed in config help"
96+
else
97+
ko "setup command not in config help"
98+
fi
99+
100+
# 6. Test node-pty dynamic import (should not crash if missing)
101+
echo "--- Test: node-pty optional ---"
102+
node -e "
103+
import('node-pty')
104+
.then(() => { console.log('node-pty: installed'); process.exit(0); })
105+
.catch(() => { console.log('node-pty: not installed (OK)'); process.exit(0); });
106+
" 2>&1
107+
ok "node-pty check does not crash"
108+
109+
# 7. Verify node-pty is NOT in optionalDependencies
110+
echo "--- Test: node-pty removed from optionalDeps ---"
111+
if grep -q '"node-pty"' "$PROJECT_DIR/package.json"; then
112+
ko "node-pty still in package.json"
113+
else
114+
ok "node-pty removed from package.json"
115+
fi
116+
117+
# 8. Test feature flags include greptile
118+
echo "--- Test: feature flags ---"
119+
node -e "
120+
import { getFeatureFlags } from '$PROJECT_DIR/dist/core/config/feature-flags.js';
121+
const flags = getFeatureFlags();
122+
if ('greptile' in flags) {
123+
console.log('greptile flag exists: ' + flags.greptile);
124+
process.exit(0);
125+
} else {
126+
console.error('greptile flag missing');
127+
process.exit(1);
128+
}
129+
" 2>&1 && ok "greptile feature flag exists" || ko "greptile feature flag missing"
130+
131+
# 9. Verify build artifacts exist
132+
echo "--- Test: build artifacts ---"
133+
if [ -f "$PROJECT_DIR/dist/cli/claude-sm.js" ]; then
134+
ok "dist/cli/claude-sm.js exists"
135+
else
136+
ko "dist/cli/claude-sm.js missing"
137+
fi
138+
139+
if [ -f "$PROJECT_DIR/dist/features/sweep/pty-wrapper.js" ]; then
140+
ok "dist/features/sweep/pty-wrapper.js exists"
141+
else
142+
ko "dist/features/sweep/pty-wrapper.js missing"
143+
fi
144+
145+
# Restore config
146+
if [ -f "$BACKUP_PATH" ]; then
147+
mv "$BACKUP_PATH" "$CONFIG_PATH"
148+
echo -e "${GRAY}Restored original config${NC}"
149+
fi
150+
151+
# Summary
152+
echo ""
153+
echo "=== Results: ${GREEN}$pass passed${NC}, ${RED}$fail failed${NC} ==="
154+
[ "$fail" -eq 0 ] && exit 0 || exit 1

‎src/cli/claude-sm.ts‎

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1323,6 +1323,159 @@ configCmd
13231323
console.log(chalk.green('Greptile disabled by default'));
13241324
});
13251325

1326+
configCmd
1327+
.command('setup')
1328+
.description('Interactive feature setup wizard')
1329+
.action(async () => {
1330+
const inquirer = await import('inquirer');
1331+
const ora = (await import('ora')).default;
1332+
const config = loadSMConfig();
1333+
1334+
console.log(chalk.cyan('\nClaude-SM Feature Setup\n'));
1335+
1336+
interface FeatureDef {
1337+
key: keyof ClaudeSMConfig;
1338+
name: string;
1339+
desc: string;
1340+
}
1341+
1342+
const features: FeatureDef[] = [
1343+
{
1344+
key: 'defaultSweep',
1345+
name: 'Sweep',
1346+
desc: 'Next-edit predictions via PTY wrapper (installs node-pty)',
1347+
},
1348+
{
1349+
key: 'defaultGreptile',
1350+
name: 'Greptile',
1351+
desc: 'AI code review MCP server (requires GREPTILE_API_KEY)',
1352+
},
1353+
{
1354+
key: 'defaultModelRouting',
1355+
name: 'Model Routing',
1356+
desc: 'Route tasks to Qwen/other providers',
1357+
},
1358+
{
1359+
key: 'defaultWorktree',
1360+
name: 'Worktree',
1361+
desc: 'Git worktree isolation per instance',
1362+
},
1363+
{
1364+
key: 'defaultWhatsApp',
1365+
name: 'WhatsApp',
1366+
desc: 'Notifications and remote control',
1367+
},
1368+
{
1369+
key: 'defaultTracing',
1370+
name: 'Tracing',
1371+
desc: 'Debug trace logging',
1372+
},
1373+
{
1374+
key: 'defaultNotifyOnDone',
1375+
name: 'Notify on Done',
1376+
desc: 'Notification when session ends',
1377+
},
1378+
];
1379+
1380+
const choices = features.map((f) => ({
1381+
name: `${f.name} - ${f.desc}`,
1382+
value: f.key,
1383+
checked: config[f.key],
1384+
}));
1385+
1386+
const { selected } = await inquirer.default.prompt([
1387+
{
1388+
type: 'checkbox',
1389+
name: 'selected',
1390+
message: 'Select features to enable:',
1391+
choices,
1392+
},
1393+
]);
1394+
1395+
const selectedKeys = selected as string[];
1396+
1397+
// Apply all toggles
1398+
for (const f of features) {
1399+
config[f.key] = selectedKeys.includes(f.key);
1400+
}
1401+
saveSMConfig(config);
1402+
1403+
// Post-install: Sweep -> install node-pty
1404+
if (config.defaultSweep) {
1405+
let hasPty = false;
1406+
try {
1407+
await import('node-pty');
1408+
hasPty = true;
1409+
} catch {
1410+
// not installed
1411+
}
1412+
if (!hasPty) {
1413+
const spinner = ora('Installing node-pty...').start();
1414+
try {
1415+
execSync('npm install node-pty', {
1416+
stdio: 'ignore',
1417+
cwd: process.cwd(),
1418+
});
1419+
spinner.succeed('node-pty installed');
1420+
} catch {
1421+
spinner.fail('Failed to install node-pty');
1422+
console.log(chalk.gray(' Install manually: npm install node-pty'));
1423+
}
1424+
}
1425+
}
1426+
1427+
// Post-install: Greptile -> prompt for API key, register MCP
1428+
if (config.defaultGreptile) {
1429+
const apiKey = process.env['GREPTILE_API_KEY'];
1430+
if (!apiKey) {
1431+
const { key } = await inquirer.default.prompt([
1432+
{
1433+
type: 'password',
1434+
name: 'key',
1435+
message: 'Enter your Greptile API key (from app.greptile.com):',
1436+
mask: '*',
1437+
},
1438+
]);
1439+
if (key && key.trim()) {
1440+
// Append to .env
1441+
const envPath = path.join(process.cwd(), '.env');
1442+
const line = `\nGREPTILE_API_KEY=${key.trim()}\n`;
1443+
fs.appendFileSync(envPath, line);
1444+
process.env['GREPTILE_API_KEY'] = key.trim();
1445+
console.log(chalk.green(' API key saved to .env'));
1446+
}
1447+
}
1448+
1449+
// Register MCP server
1450+
const currentKey = process.env['GREPTILE_API_KEY'];
1451+
if (currentKey) {
1452+
try {
1453+
const result = execSync('claude mcp list 2>/dev/null', {
1454+
encoding: 'utf-8',
1455+
});
1456+
if (!result.includes('greptile')) {
1457+
execSync(
1458+
`claude mcp add --transport http greptile https://api.greptile.com/mcp --header "Authorization: Bearer ${currentKey}"`,
1459+
{ stdio: 'ignore' }
1460+
);
1461+
console.log(chalk.green(' Greptile MCP server registered'));
1462+
}
1463+
} catch {
1464+
// ignore registration failures
1465+
}
1466+
}
1467+
}
1468+
1469+
// Summary
1470+
console.log(chalk.cyan('\nFeature summary:'));
1471+
for (const f of features) {
1472+
const on = config[f.key];
1473+
const mark = on ? chalk.green('ON') : chalk.gray('OFF');
1474+
console.log(` ${mark} ${f.name}`);
1475+
}
1476+
console.log(chalk.gray(`\nSaved to ${getConfigPath()}`));
1477+
});
1478+
13261479
// Main command (default action when no subcommand)
13271480
program
13281481
.option('-w, --worktree', 'Create isolated worktree for this instance')

0 commit comments

Comments
 (0)