Local JSON Storage Plugin - A stable, no-dependencies solution for basic project search and memory in Claude Code.

Provide a rock-solid plugin that enhances Claude Code's understanding of your project without complexity. This version focuses on essential features using only local JSON storage.

• Simple & Fast: Local JSON indexing with no external dependencies
• Zero Configuration: Works out of the box with sensible defaults
• Cross Platform: Windows, macOS, Linux support
• Memory Efficient: <50MB total usage
• Production Ready: Stable, tested, and reliable

• Not advanced search: Simple keyword matching only
• Not AI-powered: No external services or processing
• Not complex: No additional features or configuration needed
• Not cloud-based: Everything runs locally on your machine

/plugin install prism-project-memory@claude-plugins-official

# Clone the repository
git clone https://github.com/SuperInstance/Claude-prism-local-json.git
cd Claude-prism-local-json

# Install and register
npm install
claude plugin install .

v0.6 brings major improvements to performance, efficiency, and reliability:

• JSON Compression: 60-70% smaller index files using gzip compression
• Delta Indexing: 3-4x faster incremental updates with change detection
• Intelligent Caching: Multi-level cache with predictive optimization
• Fragmentation Analysis: Automatic index health monitoring

• Automatic Cleanup: Background removal of unused and old files
• Memory Management: Predictive garbage collection with emergency cleanup
• Error Recovery: Robust error handling and automatic recovery
• Performance Monitoring: Real-time metrics and insights

• Health Checks: Comprehensive diagnostics and fragmentation analysis
• Optimization Tools: Automatic index optimization and cleanup
• Statistics API: Detailed performance and usage statistics
• Benchmarking Suite: Built-in performance testing tools

3. Start searching:

   # Check status
   /prism status
   
   # Search for files
   /prism search "authentication middleware"
   
   # Reindex if needed
   /prism index

• JavaScript, TypeScript (React, Vue, Angular)
• Python (Django, Flask, FastAPI)
• Go, Rust, Java, C#, PHP, Ruby

• Source code: .js, .ts, .jsx, .tsx, .py, .go, .rs, .java, .cs, .php, .rb
• Documentation: .md, .txt
• Configuration: .json, .yaml, .yml
• Build files: package.json, pyproject.toml, go.mod, Cargo.toml

• node_modules/, .git/, dist/, build/
• Binary files
• Test files (unless specifically included)

# Optional: Customize behavior
export LOG_LEVEL=info           # Logging level
export PORT=8080               # Daemon port
export PROJECT_ROOT=/path/to/project  # Custom project root

Create .prism-config.json in your project root:

{
  "logLevel": "info",
  "excludePatterns": [
    "node_modules/**",
    ".git/**",
    "dist/**",
    "build/**"
  ],
  "indexPatterns": [
    "**/*.{js,ts,jsx,tsx,py,go,rs,java,csharp,php,rb}",
    "**/*.{md,json,yaml,yml}"
  ]
}

• Runs on port 8080
• Automatically indexes files
• Monitors for changes
• Provides HTTP API

• Real-time Updates: Automatically reindexes when files change
• Zero Configuration: Works out of the box
• Incremental Updates: Only changed files are reindexed
• Smart Debouncing: Batches rapid changes (500ms delay)
• Low Overhead: <0.1% CPU usage when idle

File Watcher Features:

# Check watcher status
curl http://localhost:8080/watcher/status

# Disable watcher if needed
curl -X POST http://localhost:8080/watcher/disable

# Re-enable watcher
curl -X POST http://localhost:8080/watcher/enable

See FILE_WATCHER.md for detailed documentation.

• All data stored in .prism/ directory
• JSON format for readability
• No external servers or APIs
• No data transmission outside your machine

• Basic file content search
• File name and path matching
• Keyword-based results
• Fast local indexing

For external integrations:

# Health check
curl http://localhost:8080/health

# Reindex project
curl -X POST http://localhost:8080/index

# Search files
curl -X POST http://localhost:8080/search \
  -H "Content-Type: application/json" \
  -d '{"query": "authentication"}'

# File watcher status
curl http://localhost:8080/watcher/status

# Enable/disable file watcher
curl -X POST http://localhost:8080/watcher/enable
curl -X POST http://localhost:8080/watcher/disable

Plugin not working:

# Check installation
/plugin list

# Test daemon
curl http://localhost:8080/health

# Restart plugin if needed

Search results poor:

# Check indexed files
curl http://localhost:8080/stats

# Manually reindex
/prism index

High memory usage:

# Check cache size
du -sh .prism/

# Clear cache if needed
rm -rf .prism/cache

# View memory usage
curl http://localhost:8080/cleanup

# Force cleanup
curl -X POST http://localhost:8080/cleanup/force

Poor search performance:

# Check fragmentation analysis
curl http://localhost:8080/fragmentation

# Optimize index
curl -X POST http://localhost:8080/optimize

# Clear and rebuild cache
curl -X POST http://localhost:8080/cache/clear

Index too large:

# Check compression ratio
curl http://localhost:8080/stats

# Analyze fragmentation
curl http://localhost:8080/fragmentation

# Optimize storage
curl -X POST http://localhost:8080/optimize

Debugging issues:

# View diagnostics
curl http://localhost:8080/diagnostics

# Check performance metrics
curl http://localhost:8080/performance

# View delta statistics
curl http://localhost:8080/delta/stats

File watcher not detecting changes:

# Check watcher status
curl http://localhost:8080/watcher/status

# Restart watcher
curl -X POST http://localhost:8080/watcher/disable
curl -X POST http://localhost:8080/watcher/enable

# Check if file matches include patterns
# (.js, .ts, .py, .go, .rs, .md, etc.)

File watcher using too much CPU:

# Temporarily disable file watcher
curl -X POST http://localhost:8080/watcher/disable

# Or set ENABLE_WATCHER=false in .mcp.json

• Issues: https://github.com/SuperInstance/Claude-prism-local-json/issues
• Documentation: See TECHNICAL-DOCUMENTATION.md
• Validation: Run node scripts/validate-marketplace.js

This is the Local JSON version of PRISM. Other versions may offer:

• PRISM Cloud: Cloud-hosted version with advanced features
• PRISM Enterprise: Team collaboration and support
• PRISM Self-Host: Private deployment options

Choose the version that best fits your needs.

MIT License - see LICENSE for details.

We welcome contributions! Please keep the focus on simplicity and stability.

1. Fork the repository
2. Create a feature branch (git checkout -b/simple-improvement)
3. Make your changes (keeping it simple!)
4. Commit and push
5. Open a Pull Request

PRISM Local JSON - Making Claude Code better, simply and reliably. 🚀