TIMPs — The AI memory layer that gets smarter the longer you use it. 17 intelligence tools built on persistent memory.
A professional developer-tool grade web interface for TIMPs — the Trustworthy Interactive Memory Partner System.
A beautiful, responsive web interface featuring:
┌─────────────────────────────────────────────┬─────────────────────┐
│ TIMPs v1.0 💾 12 memories │ Settings │
├─────────────────────────────────────────────┼─────────────────────┤
│ Conversation Panel (70%) │ Memory Panel (30%) │
│ │ │
│ timps › Welcome. I'm TIMPs... │ 📋 Memory Log │
│ 12:45 PM │ │
│ │ [2] REFLECTION │
│ You › Hi! How are you? │ ⭐⭐⭐⭐⭐ │
│ 12:46 PM │ favorite language.. │
│ │ 2/17/2026 │
│ timps › Great! How can I help? │ │
│ 12:46 PM │ [1] EXPLICIT │
│ │ ⭐⭐ │
│ │ React is my... │
├─────────────────────────────────────────────┴─────────────────────┤
│ [Input] Type a message... [send] │
│ !blame !forget !audit Enter to send · Shift+Enter newline
└─────────────────────────────────────────────────────────────────────┘
cd /Users/sandeepreddy/Desktop/testbot/sandeep-ai
npm install
Terminal 1: PostgreSQL (ensure running on localhost:5432)
# Check your .env for credentials
Terminal 2: Ollama (if using local models)
ollama serve
Terminal 3: TIMPs Server + Web Interface
npm run server
🌐 http://localhost:3000
That's it! Your browser will open to the landing page with a "Start Session" button.
| Command | Purpose |
|---|---|
!blame <keyword> | Search memories containing keyword |
!forget <keyword> | Delete memories matching keyword |
!audit | View last 10 stored memories |
Click settings button in top-right to configure:
All commands work in the input box:
Search for memories containing keyword
Search your memory for a specific keyword
Browser display:
timps › Found 2 memory item(s) matching "TypeScript":
[2] REFLECTION ⭐⭐⭐⭐⭐
favorite language is TypeScript
[1] EXPLICIT ⭐⭐⭐
TypeScript helps catch bugs early
Backend processing:
Delete all memories matching keyword (with confirmation)
Browser display:
[Confirmation Dialog]
!forget "React"
Delete all memories matching "React"?
Removes from PostgreSQL and Qdrant. Cannot be undone.
[Cancel] [Delete]
After confirmation:
View your last 10 stored memories
Browser display:
timps › AUDIT LOG — Last 10 memories
[2] REFLECTION ⭐⭐⭐⭐⭐
favorite language is TypeScript
2/16/2026, 6:47:52 PM · retrieved 1×
[1] EXPLICIT ⭐⭐
TypeScript helps catch bugs early
2/16/2026, 6:50:15 PM · retrieved 0×
Toggle Ephemeral Mode in settings to disable persistence:
Settings are stored in browser localStorage and can be configured via the web UI:
Via Settings Modal:
Via .env file (backend configuration):
# Database
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DATABASE=sandeep_ai
POSTGRES_USER=postgres
POSTGRES_PASSWORD=yourpassword
# Vector Search (optional)
QDRANT_URL=http://localhost:6333
QDRANT_COLLECTION=sandeep_ai_memories
# LLM
OLLAMA_API_URL=http://localhost:11434
# or
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=...
# Server
PORT=3000
NODE_ENV=development
The Memory Panel (right side) shows up to 30 recent memories:
| Field | Meaning |
|---|---|
[#ID] | Database record identifier |
TYPE | REFLECTION or EXPLICIT memory |
⭐ | Importance level (1-5 stars) |
| Content | Memory text (2-line preview) |
| Date | When created |
retrieved N× | How many times searched |
| Issue | Solution |
|---|---|
| White/blank page | Check browser console (F12), verify server running |
| "Cannot reach TIMPs server" | Start server: npm run server |
| Memories not loading | Ensure PostgreSQL & Qdrant running, check .env |
| Settings not persisting | Check browser allows localStorage |
| Search finds nothing | Try !audit first to verify memories exist |
| Slow responses | Vector store (Qdrant) may be under load |
| Ephemeral mode not working | Clear localStorage, toggle in settings |
Dark theme with professional gradients:
| Element | Color | Usage |
|---|---|---|
| Background | #0c0c0c | Main surface |
| Border | #222222 | Panel dividers |
| Text | #e8e4e0 | Primary text |
| Accent | #c8c0b8 | Headers, titles |
| Green | #6ee7b7 | Status, assistant |
| Muted | #666660 | Secondary text |
Font: IBM Plex (Mono for code, Sans for UI)
cd /Users/sandeepreddy/Desktop/testbot/sandeep-ai
npm run server
# Edit public/index.html or public/chat.html
# Changes auto-refresh (static files)
npm run build
npm start
Enable verbose API logging:
NODE_ENV=development npm run server
public/
├── index.html # Landing page
└── chat.html # Main chat interface
api/
├── server.ts # Express server + static serving
└── routes.ts # API endpoints
config/
└── env.ts # Environment variables
db/
├── postgres.ts # Memory storage
└── vector.ts # Vector search (Qdrant)
core/
├── agent.ts # Main AI logic
├── executor.ts # Task execution
├── planner.ts # Planning
└── reflection.ts # Memory reflection
All endpoints are called from the web interface:
| Method | Endpoint | Purpose |
|---|---|---|
POST | /api/chat | Send message, get AI response |
GET | /api/memory/:userId | Fetch user's memories |
DELETE | /api/memory/:userId | Delete memories (via !forget) |
GET | /api/health | Server health check |
MIT
Ready to remember everything that matters? Open http://localhost:3000 🚀
FAQs
TIMPs - A persistent cognitive partner that remembers, evolves, and builds with its user
The npm package timps receives a total of 2 weekly downloads. As such, timps popularity was classified as not popular.
We found that timps demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Research
/Security News
Socket researchers found 18 Chrome extensions and one Edge extension delivering a wallet drainer, credential theft, and other malicious payloads.
Product
Create ClickUp tasks from Socket alerts, automate ticketing with custom rules, and keep alert and task status synchronized.
Product
Create and manage Asana tasks directly from Socket alerts, with manual task creation, automated ticketing rules, and two-way sync.