Skip to content
/ Engram Public

tool for for (vibe)coders that remembers, recalls, warns and reuses to avoid huge mistakes.

License

Notifications You must be signed in to change notification settings

kwstx/Engram

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Engram

The gateway to code memory.

Engram is a privacy-first "Shadow Guard" for your AI coding workflow. It creates a semantic memory of your past mistakes and proactively injects them into your AI tools (Cursor, Copilot, Cline) to prevent them continuously.

Shadow Guard Demo

Why Engram?

Most AI tools have amnesia. They make the same mistake today that you fixed yesterday.

  • SonarLint simply catches syntax errors. It doesn't know your history or specific project constraints.
  • Cloud Tools require sending your code to external servers. Engram is 100% Local.
  • Engram remembers. It watches your workflow, learns your specific pain points, and stops the AI from repeating them.

"Saved me 2 hours on a Copilot regression where it kept using a deprecated API I explicitly moved away from last week." - Early User

Core Capabilities

AI Whisperer (Context Injection)

Don't just fix mistakes, teach your AI to avoid them. Engram translates your repetitive errors into natural language rules.

  • Universal Support: Automatically updates configuration files for Cursor and Copilot.
  • Smart Copy: Wraps your code with relevant mistake history when pasting into ChatGPT.
  • Prompt Injection Defense: Sanitizes all context to ensure security.

The Shadow Guard (Real-Time Policing)

A firewall for AI-generated code.

  • Honeymoon Mode: New mistakes are shown as subtle Info warnings (Blue), giving you a chance to fix them without interruption.
  • Strict Enforcement: Promote rules to "Blockers" (Red) only when you need absolute compliance.
  • Interactive Triage: Quickly ignore rules for specific file types (like tests) with a single click.

Mistake Shield

  • Active Warning System: Detects when you are about to repeat a known bad pattern.
  • Memory Cards: Hover over any warning to see exactly when this mistake happened before and how you fixed it.

Predictive Intuition (Auto-Enabled)

It reads your mind.

  • Ghost Text: Shows predictions when you hesitate.
  • Prompt Director: Knows when you want to ask a question.
  • Telepathy: Broadcasts its thoughts to .engram/intuition.md so other AI agents can read them.

Quick Start

  1. Install the extension.
  2. Code as usual. Engram learns quietly in the background.
  3. Watch for ghost text warnings or predictions.
  4. Paste smarter. Use "Engram: Smart Copy" when asking AI for help.
  5. Refine. Use the blue "Shadow Guard" warnings to tune your rules.

FAQ

Q: Does my code leave my computer? A: No. Engram is 100% local. All embeddings, rules, and logic run on your machine.

Q: Will it slow down my editor? A: No. The Shadow Guard uses a debounced background process (500ms) to ensure it never blocks your typing.

Q: Can I share my rules? A: Yes! Use Engram: Import Rules to load any JSON rule pack. Check out our Starter Kit for free bug patterns.

Community & Extensibility

Engram is designed to be hacked.

  • Rule Starter Kit: Run Engram: Load Starter Kit to instantly block common bugs (Console logs in prod, AWS Keys, etc).
  • Build Your Own: Export your fingerprints.json and share it with your team.
  • Open Source: Contribute your best patterns to our GitHub Repo.

Support

Experimental Features (Beta)

Engram isn't just a memory; it's a psychic companion.

Note: Pre-Cog (Intuition) is now a core feature! Check the Quick Start.

Photographic Memory & Hippocampus (Hidden Beta)

See walkthrough.md for instructions on how to enable these classified features.

About

tool for for (vibe)coders that remembers, recalls, warns and reuses to avoid huge mistakes.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published