{"_id":"@ai-emart/mindr","_rev":"5-121663a6b60ed28a0b302c69a68cbca4","name":"@ai-emart/mindr","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@ai-emart/mindr","version":"1.0.0","keywords":["ai","memory","agents","mcp","codebase","typescript"],"author":{"name":"ai-emart"},"license":"MIT","_id":"@ai-emart/mindr@1.0.0","maintainers":[{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"}],"homepage":"https://github.com/ai-emart/mindr","bugs":{"url":"https://github.com/ai-emart/mindr/issues"},"dist":{"shasum":"1aea4500e4e80c570df39280f6df48857c1dc4fa","tarball":"https://registry.npmjs.org/@ai-emart/mindr/-/mindr-1.0.0.tgz","fileCount":6,"integrity":"sha512-uoU8aJInHFt9jnMPupxD6tSVYVHDOs+SX38rt5mtT/BmZRgEEJERHuO+pV0QlGsDP2URcui8lEEYRU7hpCB3+A==","signatures":[{"sig":"MEUCIDYyMcxo6vdDPquPkWFi9wvJHaEFi6YXH1+w/RI6BnblAiEAtCKSuDPzXOlVzYb/0KKun3Fm4+NQMtMMWiu0bljzuO4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57630},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6b2f936a8c61972c8360862bb5f3a000031442e8","private":false,"scripts":{"dev":"tsup --watch","lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest run","build":"tsup","clean":"rm -rf dist"},"_npmUser":{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"},"repository":{"url":"git+https://github.com/ai-emart/mindr.git","type":"git"},"_npmVersion":"9.9.4","description":"TypeScript SDK for Mindr — persistent codebase memory for AI coding agents","directories":{},"_nodeVersion":"22.21.1","dependencies":{"@remembr/sdk":"^0.2.0","@ai-emart/mindr-core":"workspace:*"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mindr_1.0.0_1778111686699_0.9747264171693775","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @emartai/mindr — install @emartai/mindr instead."},"1.0.1":{"name":"@ai-emart/mindr","version":"1.0.1","keywords":["ai","memory","agents","mcp","codebase","typescript"],"author":{"name":"ai-emart"},"license":"MIT","_id":"@ai-emart/mindr@1.0.1","maintainers":[{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"}],"homepage":"https://github.com/ai-emart/mindr","bugs":{"url":"https://github.com/ai-emart/mindr/issues"},"dist":{"shasum":"948f6163cff2b1fc9c5b6b7f026b33068b185596","tarball":"https://registry.npmjs.org/@ai-emart/mindr/-/mindr-1.0.1.tgz","fileCount":6,"integrity":"sha512-wrxzOPgjhuq+LhJs68npXlVKtseG58TqLMRn1WqAeAHKyxeREgS++Ba3Y+j2QrBQYhc4vltPfPo9RfQlmjWE+Q==","signatures":[{"sig":"MEUCIQD9YulJY0WbkhrcWO4K+GEGU4MjNPTu3azxsSiQPWMedQIgPZrS3apO6W8NNrbejFjkzvQqZk994PcscgBoaxIfJnc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57798},"main":"./dist/index.js","type":"module","_from":"file:ai-emart-mindr-1.0.1.tgz","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"private":false,"scripts":{"dev":"tsup --watch","lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest run","build":"tsup","clean":"rm -rf dist"},"_npmUser":{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"},"_resolved":"C:\\Users\\DELL\\AppData\\Local\\Temp\\7c5547dc79b5c891a0d22457606d3930\\ai-emart-mindr-1.0.1.tgz","_integrity":"sha512-wrxzOPgjhuq+LhJs68npXlVKtseG58TqLMRn1WqAeAHKyxeREgS++Ba3Y+j2QrBQYhc4vltPfPo9RfQlmjWE+Q==","repository":{"url":"git+https://github.com/ai-emart/mindr.git","type":"git"},"_npmVersion":"9.9.4","description":"TypeScript SDK for Mindr — persistent codebase memory for AI coding agents","directories":{},"_nodeVersion":"22.21.1","dependencies":{"@remembr/sdk":"^0.2.0","@ai-emart/mindr-core":"1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mindr_1.0.1_1778137731903_0.05759176180837433","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @emartai/mindr — install @emartai/mindr instead."},"1.0.3":{"name":"@ai-emart/mindr","version":"1.0.3","keywords":["ai","memory","agents","mcp","codebase","typescript"],"author":{"name":"ai-emart"},"license":"MIT","_id":"@ai-emart/mindr@1.0.3","maintainers":[{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"}],"homepage":"https://github.com/ai-emart/mindr","bugs":{"url":"https://github.com/ai-emart/mindr/issues"},"dist":{"shasum":"813018ae597c634baab590ffa92d31b912656653","tarball":"https://registry.npmjs.org/@ai-emart/mindr/-/mindr-1.0.3.tgz","fileCount":6,"integrity":"sha512-2Sb1fetcwDYUdPb/H54Q8E3Jv70zkGbKh4B7ev1xGy/+2WMRbJQMP3ARzknhOgSWDwWp8a0Ap/uwQkjaB20MvA==","signatures":[{"sig":"MEYCIQCYXvg63IR17O6l49BbRtTQSzyWp8FUeKN2sEC0agvx/gIhAIDOXsmftvGNrNm3EOofQUhmgK2F+rXCizXn7dJzlQYK","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57798},"main":"./dist/index.js","type":"module","_from":"file:ai-emart-mindr-1.0.3.tgz","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"private":false,"scripts":{"dev":"tsup --watch","lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest run","build":"tsup","clean":"rm -rf dist"},"_npmUser":{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"},"_resolved":"/tmp/d0a7263026b07c8b70c08778ecc83202/ai-emart-mindr-1.0.3.tgz","_integrity":"sha512-2Sb1fetcwDYUdPb/H54Q8E3Jv70zkGbKh4B7ev1xGy/+2WMRbJQMP3ARzknhOgSWDwWp8a0Ap/uwQkjaB20MvA==","repository":{"url":"git+https://github.com/ai-emart/mindr.git","type":"git"},"_npmVersion":"10.9.7","description":"TypeScript SDK for Mindr — persistent codebase memory for AI coding agents","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@remembr/sdk":"^0.2.0","@ai-emart/mindr-core":"1.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mindr_1.0.3_1778145041418_0.3998862294995471","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @emartai/mindr — install @emartai/mindr instead."},"1.1.0":{"name":"@ai-emart/mindr","version":"1.1.0","keywords":["ai","memory","agents","mcp","codebase","typescript"],"author":{"name":"ai-emart"},"license":"MIT","_id":"@ai-emart/mindr@1.1.0","maintainers":[{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"}],"homepage":"https://github.com/ai-emart/mindr","bugs":{"url":"https://github.com/ai-emart/mindr/issues"},"dist":{"shasum":"a553deaf5b5e05336958216b93b3d804104d793a","tarball":"https://registry.npmjs.org/@ai-emart/mindr/-/mindr-1.1.0.tgz","fileCount":6,"integrity":"sha512-EuXXO8gQXwcsGNsszalgOa/Pc+bRl4tZYSu+Np7vzWq+rahqTbP14CTSsLxoB26HOPdtadCzAyAZXmgKlbgZmw==","signatures":[{"sig":"MEUCIBiJeJm1cmCLYjM93ZxMZzeqEjdLgX5ecFh/vvPjqul1AiEA78IuXGTgrk4jAkZruA53JQ4aiHk+Pc//h2VDDTGJt8w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57803},"main":"./dist/index.js","type":"module","_from":"file:ai-emart-mindr-1.1.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"private":false,"scripts":{"dev":"tsup --watch","lint":"eslint \"src/**/*.ts\" \"tests/**/*.ts\"","test":"vitest run","build":"tsup","clean":"rm -rf dist"},"_npmUser":{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"},"_resolved":"/tmp/1e8d2114f004ddac77e4c58a37f66704/ai-emart-mindr-1.1.0.tgz","_integrity":"sha512-EuXXO8gQXwcsGNsszalgOa/Pc+bRl4tZYSu+Np7vzWq+rahqTbP14CTSsLxoB26HOPdtadCzAyAZXmgKlbgZmw==","repository":{"url":"git+https://github.com/ai-emart/mindr.git","type":"git"},"_npmVersion":"10.9.7","description":"TypeScript SDK for Mindr — persistent codebase memory for AI coding agents","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@remembr/sdk":"^0.2.0","@ai-emart/mindr-core":"1.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mindr_1.1.0_1778153251952_0.2252810687282567","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @emartai/mindr — install @emartai/mindr instead."}},"time":{"created":"2026-05-06T23:54:46.634Z","modified":"2026-07-12T11:51:55.379Z","1.0.0":"2026-05-06T23:54:46.842Z","1.0.1":"2026-05-07T07:08:52.027Z","1.0.3":"2026-05-07T09:10:41.542Z","1.1.0":"2026-05-07T11:27:32.096Z"},"bugs":{"url":"https://github.com/ai-emart/mindr/issues"},"author":{"name":"ai-emart"},"license":"MIT","homepage":"https://github.com/ai-emart/mindr","keywords":["ai","memory","agents","mcp","codebase","typescript"],"repository":{"url":"git+https://github.com/ai-emart/mindr.git","type":"git"},"description":"TypeScript SDK for Mindr — persistent codebase memory for AI coding agents","maintainers":[{"name":"emart29","email":"NWANGUMAEMMANUEL29@GMAIL.COM"}],"readme":"# @ai-emart/mindr\n\nThe developer SDK for [Mindr](https://github.com/ai-emart/mindr) — memory-augmented dev tooling.\nStore architectural decisions, coding conventions, and tech debt in a local or cloud backend,\nthen surface them to any AI agent as a structured session context.\n\n## Install\n\n```\nnpm i @ai-emart/mindr\n```\n\n## Quickstart\n\n```ts\nimport { Mindr } from '@ai-emart/mindr';\n\nconst mindr = await Mindr.open({ project: './my-project' });\n\nawait mindr.remember('We use tRPC for all internal APIs', { type: 'decision', module: 'api' });\nconst ctx = await mindr.getSessionContext({ module: 'auth' });\nconst decisions = await mindr.query({ type: 'decision', module: 'auth' });\nconst debt = await mindr.getDebt({ severity: 'high' });\nconst conventions = await mindr.getConventions();\n```\n\n## API\n\n### `Mindr.open(opts)`\n\nOpens a client for the given project path. Loads `.mindr/config.toml` (or accepts an injected\nconfig/backend for testing) and returns a connected `Mindr` instance.\n\n```ts\nconst mindr = await Mindr.open({ project: './my-project' });\n// Use an in-memory SQLite database for tests:\nconst mindr = await Mindr.open({ project: '.', config: { storage: { backend: 'sqlite', sqlite_path: ':memory:' }, ... } });\n```\n\nCall `mindr.close()` when done to release file handles.\n\n### Write\n\n| Method | Description |\n|--------|-------------|\n| `remember(content, opts?)` | Store a memory. `opts`: `type`, `module`, `tags`, `metadata`. |\n| `forget(id)` | Soft-delete a memory by ID. |\n\n### Read\n\n| Method | Description |\n|--------|-------------|\n| `query(opts?)` | Raw `MindrMemory[]` with optional `type`, `module`, `since`, `limit` filters. |\n| `getDecisions(opts?)` | Structured `Decision[]`, newest-first, `\"Decision: \"` prefix stripped. |\n| `getDebt(opts?)` | Structured `DebtItem[]` with `location`, `keyword`, `file`, `line`. |\n| `getConventions(opts?)` | `ConventionProfile[]` stored by the post-commit hook. |\n| `getSessionContext(opts?)` | Token-budgeted `SessionContext` for AI system prompts. |\n| `getStatus()` | `MindrStatus` — backend type, project path, per-type counts. |\n\n### Generate\n\n| Method | Description |\n|--------|-------------|\n| `regenerateAgentsMd(opts?)` | Generate `AGENTS.md` / `CLAUDE.md` from stored patterns. |\n\n### Migrate\n\n| Method | Description |\n|--------|-------------|\n| `migrateSqliteToRemembr()` | Copy all SQLite memories to Remembr cloud. |\n\n## Memory types\n\n```\ndecision   — architectural choices and why\nconvention — code style patterns (auto-detected via tree-sitter)\nbug_pattern — recurring bugs\ndebt       — TODO / FIXME items\nnote       — free-form notes\ncontext    — commit context (written by the post-commit hook)\n```\n\n## Config\n\nCreate `.mindr/config.toml` in your project root, or run `mindragent init`:\n\n```toml\n[storage]\nbackend    = \"sqlite\"          # or \"remembr\"\nsqlite_path = \".mindr/mindr.sqlite\"\n\n[remembr]\nbase_url = \"https://your-remembr-instance.com\"\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}