import { createMemory } from '@timps-ai/timps-sdk'

const memory = await createMemory({ projectPath: '.' })

await memory.store('This project uses tRPC for type-safe APIs')
const results = await memory.recall('API patterns')
console.log(results)
// [{ content: 'This project uses tRPC...', score: 0.92 }]

Quickstart

import { createMemory } from '@timps-ai/timps-sdk'

const memory = await createMemory({ projectPath: './my-project' })

// Store facts
await memory.store('The auth system uses JWT with 1h expiry')
await memory.store('Prefer functional components over class components', {
  metadata: { type: 'preference', tags: ['react', 'components'] }
})

// Recall with context
const results = await memory.recall('how does authentication work', { limit: 5 })
console.log(results[0].content)

Provider Configuration

Ollama (free, local)

const memory = await createMemory({
  projectPath: '.',
  provider: 'ollama'  // uses localhost:11434, nomic-embed-text
})

OpenAI (your API key)

const memory = await createMemory({
  projectPath: '.',
  provider: {
    name: 'openai',
    apiKey: process.env.OPENAI_API_KEY
  }
})

Keyword-only (no LLM dependency)

const memory = await createMemory({ projectPath: '.' })
// No provider → BM25 keyword search only, zero network dependencies

API

Method	Description
`store(content, metadata?)`	Store a semantic memory
`recall(query, options?)`	Recall memories matching query
`delete(id)`	Remove a memory
`storeBatch(entries)`	Store multiple memories at once
`on(event, handler)`	Listen for 'stored' or 'error' events
`getStats()`	Get memory usage statistics
`dispose()`	Clean up resources