superlocalmemory 2.3.0

package/skills/slm-remember/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: slm-remember
+description: Save content to SuperLocalMemory with intelligent indexing and knowledge graph integration. Use when the user wants to remember information, save context, store coding decisions, or persist knowledge for future sessions. Automatically indexes, graphs, and learns patterns.
+version: "2.1.0"
+license: MIT
+compatibility: "Requires SuperLocalMemory V2 installed at ~/.claude-memory/"
+attribution:
+  creator: Varun Pratap Bhardwaj
+  role: Solution Architect & Original Creator
+  project: SuperLocalMemory V2
+---
+
+# SuperLocalMemory: Remember
+
+Save content to your local memory system with automatic indexing, knowledge graph integration, and pattern learning.
+
+## Usage
+
+```bash
+slm remember "<content>" [--tags tag1,tag2] [--project name] [--importance 1-10]
+```
+
+## Examples
+
+### Example 1: Basic Memory
+```bash
+slm remember "We use FastAPI for REST APIs"
+```
+
+**What happens:**
+- Content saved to SQLite database
+- TF-IDF vectors generated for semantic search
+- Entities extracted and added to knowledge graph
+- Pattern learning analyzes for coding preferences
+- Memory ID returned (e.g., 42)
+
+### Example 2: With Tags
+```bash
+slm remember "JWT tokens expire after 24 hours" --tags security,auth,jwt
+```
+
+**Tags help with:**
+- Organization
+- Filtering
+- Related memory discovery
+
+### Example 3: With Project
+```bash
+slm remember "Database uses PostgreSQL 15 with UUID primary keys" --project myapp --tags database,postgresql
+```
+
+**Project isolation:**
+- Separate memories per project
+- Switch profiles with `slm switch-profile`
+- No context bleeding
+
+### Example 4: Important Memory
+```bash
+slm remember "CRITICAL: Production deploy requires approval from @lead" --importance 10 --tags deployment,production
+```
+
+**Importance (1-10):**
+- 1-3: Low priority (notes, ideas)
+- 4-6: Normal (coding patterns, decisions)
+- 7-9: High priority (critical info, warnings)
+- 10: Critical (blockers, security issues)
+
+## Arguments
+
+| Argument | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `<content>` | string | Yes | - | The text to remember |
+| `--tags` | string | No | None | Comma-separated tags |
+| `--project` | string | No | "default" | Project name |
+| `--importance` | integer | No | 5 | Priority level (1-10) |
+
+## Output
+
+```
+Memory added with ID: 42
+
+✅ Memory saved successfully
+
+Next steps:
+  • Use `slm recall <query>` to search this memory
+  • Use `slm list` to see recent memories
+```
+
+## What Happens Behind the Scenes
+
+1. **Content Storage:** Saved to SQLite (`~/.claude-memory/memory.db`)
+2. **Semantic Indexing:** TF-IDF vectors generated for similarity search
+3. **Knowledge Graph:** Entities extracted and nodes/edges created
+4. **Pattern Learning:** Analyzes content for coding preferences (frameworks, style, testing)
+5. **Full-Text Index:** FTS5 index updated for fast keyword search
+6. **Timestamp:** Created timestamp recorded
+
+## Advanced Usage
+
+### Natural Language (in AI chat)
+
+Most AI assistants will automatically invoke this skill when you say:
+- "Remember that..."
+- "Save this for later..."
+- "I want to store..."
+- "Keep track of..."
+
+**Example in Cursor/Claude:**
+```
+You: "Remember that we decided to use React hooks over class components"
+AI: [Automatically invokes slm-remember skill]
+✓ Memory saved
+```
+
+### Bulk Import
+
+Save multiple memories from a file:
+```bash
+# From text file (one memory per line)
+while IFS= read -r line; do
+  slm remember "$line" --project bulk-import
+done < memories.txt
+
+# From CSV (content,tags,project)
+while IFS=',' read -r content tags project; do
+  slm remember "$content" --tags "$tags" --project "$project"
+done < memories.csv
+```
+
+### Integration with Git Hooks
+
+**Pre-commit hook** (save commit messages):
+```bash
+#!/bin/bash
+# .git/hooks/post-commit
+
+commit_msg=$(git log -1 --pretty=%B)
+commit_hash=$(git log -1 --pretty=%H)
+
+slm remember "Commit: $commit_msg (${commit_hash:0:7})" \
+  --tags git,commit \
+  --project "$(basename $(git rev-parse --show-toplevel))"
+```
+
+## Error Handling
+
+| Error | Cause | Solution |
+|-------|-------|----------|
+| "Database locked" | Another process accessing DB | Wait or `killall python3` |
+| "Content cannot be empty" | Empty string passed | Provide content |
+| "Invalid importance" | Value not 1-10 | Use number between 1-10 |
+| "Database not found" | SuperLocalMemory not installed | Run `./install.sh` |
+
+## Notes
+
+- **100% local:** Nothing leaves your machine
+- **Cross-tool sync:** All AI tools access same database (Cursor, ChatGPT, Claude, etc.)
+- **Unlimited:** No memory limits, no quotas
+- **Privacy:** Your data stays on your computer
+- **Profiles:** Use `slm switch-profile` for project isolation
+
+## Related Commands
+
+- `slm recall "<query>"` - Search memories semantically
+- `slm list` - List recent memories
+- `slm status` - Check system health
+- `slm build-graph` - Rebuild knowledge graph
+- `slm switch-profile <name>` - Switch memory profile
+
+## Technical Details
+
+**Database Schema:**
+- Table: `memories`
+- Fields: id, content, tags, project_name, importance, created_at, etc.
+- Indexes: Full-text search (FTS5), TF-IDF vectors, timestamps
+
+**Performance:**
+- Add memory: ~50ms
+- With knowledge graph: ~300ms
+- Large content (10KB): ~1s
+
+**Limits:**
+- Max content size: 1MB
+- Max tags: 50 per memory
+- Max project name: 64 characters
+
+---
+
+**Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
+**Project:** SuperLocalMemory V2
+**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**Repository:** https://github.com/varun369/SuperLocalMemoryV2
+
+*Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/skills/slm-status/SKILL.md

@@ -0,0 +1,363 @@
+---
+name: slm-status
+description: Check SuperLocalMemory system status, health, and statistics. Use when the user wants to know memory count, graph stats, patterns learned, database health, or system diagnostics. Shows comprehensive system health dashboard.
+version: "2.1.0"
+license: MIT
+compatibility: "Requires SuperLocalMemory V2 installed at ~/.claude-memory/"
+attribution:
+  creator: Varun Pratap Bhardwaj
+  role: Solution Architect & Original Creator
+  project: SuperLocalMemory V2
+---
+
+# SuperLocalMemory: Status
+
+Check system status, health metrics, and statistics for your local memory system.
+
+## Usage
+
+```bash
+slm status [--verbose] [--check-integrity]
+```
+
+## Example Output
+
+### Basic Status
+```bash
+$ slm status
+```
+
+**Output:**
+```
+╔══════════════════════════════════════════════════════╗
+║  SuperLocalMemory V2 - System Status                ║
+╚══════════════════════════════════════════════════════╝
+
+📊 Memory Statistics
+   Total Memories:        1,247
+   This Month:            143
+   This Week:             28
+   Today:                 5
+
+📈 Knowledge Graph
+   Nodes (Entities):      892
+   Edges (Relationships): 3,456
+   Clusters:              47
+   Avg Cluster Size:      19 memories
+
+🎯 Pattern Learning
+   Coding Patterns:       34
+   Framework Preferences: React (72%), Vue (18%), Angular (10%)
+   Testing Style:         TDD (65%), BDD (35%)
+   Performance Priority:  High (78%)
+
+💾 Database Health
+   Size:                  4.2 MB
+   Integrity:             ✅ OK
+   Last Backup:           2026-02-07 09:15
+   Backup Count:          12
+
+🔧 Current Profile
+   Name:                  default
+   Created:               2026-01-15
+   Last Used:             2026-02-07 14:23
+
+⚙️  System Info
+   Install Path:          ~/.claude-memory
+   Database:              memory.db
+   Python Version:        3.11.7
+   SQLite Version:        3.43.2
+
+✅ Status: HEALTHY
+```
+
+### Verbose Mode
+```bash
+$ slm status --verbose
+```
+
+**Additional information:**
+- Recent memory IDs
+- Top entities in graph
+- Pattern confidence scores
+- Database table sizes
+- Index statistics
+
+### Integrity Check
+```bash
+$ slm status --check-integrity
+```
+
+**Runs full database integrity check:**
+```
+Running integrity check...
+
+Database Structure:       ✅ OK
+FTS5 Index:              ✅ OK
+Graph Consistency:        ✅ OK
+Orphaned Nodes:          0 found
+Duplicate Memories:      0 found
+Corrupted Entries:       0 found
+
+✅ All checks passed
+```
+
+## What This Shows
+
+### 1. Memory Statistics
+- **Total:** All memories ever saved
+- **This Month:** Memories added in current month
+- **This Week:** Last 7 days
+- **Today:** Memories added today
+
+**Useful for:**
+- Understanding usage patterns
+- Tracking growth
+- Identifying active periods
+
+### 2. Knowledge Graph
+- **Nodes:** Unique entities extracted (people, technologies, concepts)
+- **Edges:** Relationships between entities
+- **Clusters:** Auto-discovered topic groups
+- **Avg Cluster Size:** Memories per cluster
+
+**Health indicators:**
+- High edges/nodes ratio = well-connected knowledge
+- Many clusters = diverse topics
+- Large clusters = focused work
+
+### 3. Pattern Learning
+- **Coding Patterns:** Identified preferences and decisions
+- **Framework Preferences:** Usage distribution
+- **Testing Style:** TDD vs BDD preference
+- **Performance Priority:** How important performance is to you
+
+**Based on:**
+- Keywords in memories ("prefer", "use", "avoid")
+- Frequency of mentions
+- Importance levels
+- Recency (recent patterns weighted higher)
+
+### 4. Database Health
+- **Size:** Database file size
+- **Integrity:** PRAGMA integrity_check result
+- **Last Backup:** Most recent backup timestamp
+- **Backup Count:** Total backups available
+
+**Warning signs:**
+- ❌ Integrity: NOT OK → Database corrupted
+- ⚠️  Size > 100MB → Consider archiving old memories
+- ⚠️  No backups → Enable backup system
+
+### 5. Current Profile
+- **Name:** Active profile (default, work, personal, etc.)
+- **Created:** When profile was created
+- **Last Used:** Last access timestamp
+
+**Profiles allow:**
+- Project isolation
+- Context switching
+- Separate memory spaces
+
+### 6. System Info
+- **Install Path:** Where SuperLocalMemory is installed
+- **Database:** Database filename
+- **Python Version:** Python interpreter version
+- **SQLite Version:** SQLite engine version
+
+## Options
+
+| Option | Description | Use Case |
+|--------|-------------|----------|
+| `--verbose` | Show detailed stats | Debugging, analysis |
+| `--check-integrity` | Run full DB check | Troubleshooting |
+| `--format json` | JSON output | Scripting |
+| `--format text` | Human-readable (default) | Terminal use |
+
+## Use Cases
+
+### 1. Health Check Before Important Work
+```bash
+slm status --check-integrity
+# Ensure DB is healthy before big import
+```
+
+### 2. Understanding Memory Usage
+```bash
+slm status
+# "Do I have enough memories for pattern learning?"
+# (Need 20+ for basic patterns, 50+ for advanced)
+```
+
+### 3. Performance Monitoring
+```bash
+slm status --verbose
+# Check graph stats, optimize if needed
+```
+
+### 4. Backup Verification
+```bash
+slm status | grep "Last Backup"
+# Ensure recent backup exists
+```
+
+### 5. Profile Switching Context
+```bash
+# Before switching
+slm status
+# Note: "Current Profile: work"
+
+slm switch-profile personal
+
+slm status
+# Note: "Current Profile: personal"
+```
+
+## Advanced Usage
+
+### Scripting & Automation
+
+**Daily health check (cron job):**
+```bash
+#!/bin/bash
+# Daily at 9 AM
+
+status=$(slm status --check-integrity)
+if echo "$status" | grep -q "NOT OK"; then
+  echo "SuperLocalMemory: Integrity check FAILED" | mail -s "Alert" you@example.com
+fi
+```
+
+**Monitoring script:**
+```bash
+#!/bin/bash
+# Monitor memory growth
+
+count=$(slm status | grep "Total Memories:" | awk '{print $3}' | tr -d ',')
+echo "$(date),${count}" >> memory-growth.csv
+```
+
+**JSON output for dashboards:**
+```bash
+slm status --format json > status.json
+# Parse with jq, send to monitoring system
+```
+
+### Performance Indicators
+
+**Good indicators:**
+- Graph nodes > 100 → Rich knowledge base
+- Edges/nodes ratio > 2 → Well-connected
+- Patterns learned > 10 → AI understands your style
+- Integrity: OK → Database healthy
+
+**Warning signs:**
+- Database size > 50MB but <100 memories → Possible issue
+- Backup count: 0 → No disaster recovery
+- Last used: >30 days ago → Stale data
+
+## Troubleshooting
+
+### "Status command hangs"
+**Cause:** Database locked by another process
+
+**Solution:**
+```bash
+# Check for locks
+lsof ~/.claude-memory/memory.db
+
+# Kill hanging processes
+killall python3
+
+# Try again
+slm status
+```
+
+### "Integrity check fails"
+**Cause:** Database corruption
+
+**Solution:**
+```bash
+# Restore from backup
+cp ~/.claude-memory/backups/memory.db.backup.* ~/.claude-memory/memory.db
+
+# Verify
+slm status --check-integrity
+```
+
+### "Pattern stats missing"
+**Cause:** Need more memories (minimum 20)
+
+**Solution:**
+```bash
+# Check memory count
+slm status | grep "Total Memories"
+
+# Add more memories
+slm remember "Prefer React hooks over classes"
+# ... add 20+ memories ...
+
+# Rebuild patterns
+slm build-graph
+```
+
+## Output Interpretation
+
+### Status: HEALTHY
+✅ All systems operational
+- Database intact
+- Graph built
+- Patterns learned
+- Backups available
+
+### Status: WARNING
+⚠️  Minor issues detected
+- Old backups
+- Large database
+- Few patterns learned
+
+**Action:** Review verbose output
+
+### Status: ERROR
+❌ Critical issues
+- Database corrupted
+- Integrity check failed
+- No accessible data
+
+**Action:** Restore from backup immediately
+
+## Performance Benchmarks
+
+| Command | Typical Time | Notes |
+|---------|-------------|-------|
+| `slm status` | ~200ms | Fast, lightweight |
+| `slm status --verbose` | ~500ms | More data fetching |
+| `slm status --check-integrity` | ~2s | Full DB scan |
+
+**For large databases (10,000+ memories):**
+- Basic status: ~500ms
+- Verbose: ~1.5s
+- Integrity check: ~10s
+
+## Notes
+
+- **Non-destructive:** Status check never modifies data
+- **Real-time:** Shows current state (not cached)
+- **Cross-tool:** Same status from all AI tools
+- **Privacy:** All checks local, no external calls
+
+## Related Commands
+
+- `slm list` - List recent memories
+- `slm build-graph` - Rebuild knowledge graph
+- `slm switch-profile` - Switch memory profile
+- `slm recall` - Search memories
+
+---
+
+**Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
+**Project:** SuperLocalMemory V2
+**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**Repository:** https://github.com/varun369/SuperLocalMemoryV2
+
+*Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*