TIMPs — AI Memory Intelligence

Memory-backed inline warnings directly in your editor, powered by AI.

TIMPs learns from your coding patterns, past bugs, and decisions — then warns you before you repeat them.

Features

🐛 Bug Pattern Warnings

Inline highlights when your code matches personal bug-writing triggers. TIMPs tracks patterns like:

Unhandled promises
setTimeout with implicit globals
Hardcoded secrets and API keys
SQL injection vulnerabilities

⚠️ Tech Debt Alerts

Warns when patterns match past production incidents in your codebase. Your historical bugs become future prevention.

🔍 API Quirk Lookup

Instantly see known gotchas for any API you're working with. Never get bitten by undocumented behavior again.

🧠 Contradiction Detection

Check if a decision contradicts your past positions. TIMPs remembers what you decided before.

💾 Memory Panel

View all your stored memories, patterns, and insights directly in VS Code.

📊 Status Bar

Live connection status to TIMPs cloud backend.

Quick Start

1. Install from Marketplace

Install TIMPs from VS Code Marketplace

Or search for "TIMPs" in VS Code Extensions panel (Ctrl+Shift+X / Cmd+Shift+X)

2. Start Coding

That's it! TIMPs connects to the free hosted backend automatically.

Inline warnings appear as you code or on file save.

No server setup required. The extension connects to https://timps-api.onrender.com by default.

Commands

Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Command	Description
`TIMPs: Check for Contradictions`	Check selected text against your stored positions
`TIMPs: Look Up API Quirks`	Look up known undocumented behavior for any API
`TIMPs: Check Bug Pattern Risk`	Check current coding context against your bug triggers
`TIMPs: Open Intelligence Dashboard`	Open TIMPs dashboard in browser
`TIMPs: Show My Memories`	View all stored memories in a panel

Settings

Setting	Default	Description
`timps.serverUrl`	`https://timps-api.onrender.com`	TIMPs server URL
`timps.userId`	`1`	Your TIMPs user ID
`timps.enableInlineWarnings`	`true`	Show inline code warnings
`timps.checkOnSave`	`true`	Analyze file on save

Self-Hosted Mode

If you prefer to run your own backend:

# 1. Clone the repo
git clone https://github.com/Sandeeprdy1729/timps.git
cd timps

# 2. Start with Docker
docker compose up -d

# 3. Configure VS Code
# Set "timps.serverUrl": "http://localhost:3000" in VS Code settings

Architecture

┌─────────────┐     HTTP      ┌──────────────────┐     LangChain     ┌─────────┐
│ VS Code     │ ───────────── │ TIMPs Backend    │ ───────────────── │ Memory  │
│ Extension   │               │ (Express/Render) │                    │ (SQLite)│
└─────────────┘               └──────────────────┘                    └─────────┘

VS Code Extension: Inline warnings, commands, memory panel
Backend API: Chat, memory storage, pattern analysis
LangChain: Memory layer with reflection and curation

Development

# Clone repo
git clone https://github.com/Sandeeprdy1729/timps.git
cd timps/timps-vscode

# Install dependencies
npm install

# Run in development mode (F5)
npm run watch

# Build
npm run compile

# Package
npx vsce package

Contributing

Contributions welcome! See main repo for:

TIMPs CLI (timps-code/)
Backend API (sandeep-ai/)
Memory layer with 17 tools

License

MIT — github.com/Sandeeprdy1729/timps