🚀 Truenex Memory v0.1.0‑alpha.1 – Your local, searchable knowledge vault 🧠📦
If you’ve ever lost track of where a config was saved, a file lived in two projects, or you just want a single source of truth for everything you’re building, Truenex Memory is the open‑source solution.
Truenex Memory stores project‑local metadata (think “I added a new API key”, “This repo is obsolete”) and makes that data searchable, importable, and exportable with a single command. It’s the missing glue between your repo’s internal knowledge and your CI/CD pipeline.
📦 Why it matters
- No more “where is that file?” – The CLI finds it instantly.
- Immutable audit trail – Every change is recorded and can be restored.
- CI‑friendly – Global health checks keep your pipelines green.
- Open‑source – You own the data, you own the code.
🔑 What’s new in v0.1.0‑alpha.1?
| Feature | What it does | 🎉 |
|---|---|---|
| Local project memory | Add, search, list & track lifecycle status (active / obsolete / superseded / conflicting / unverified). | 📚 |
truenex-mem CLI |
Full --help tree, type‑checked with Typer. |
🖥️ |
| MCP stdio server | Expose memory_search, memory_add, global_status, global_project_context. |
🌐 |
| JSON export/import | Human‑readable snapshots you can share. | 📤 |
| SQLite store | Schema migrated from v1 → v4, safe migration backup/restore. | 💾 |
| Manifest‑driven ingestion | Dry‑run validation before ingestion. | ✅ |
| Global refresh pipeline | Health checks + stale catalog cleanup. | 🛡️ |
Code snippet – run the CLI
# Add a new entry truenex-mem add --project my‑app --key api-key --value "sk‑12345" # Search everything truenex-mem search --query "api-key"
🛠️ How to get started
- Clone the repo
git clone https://github.com/marcomnit/truenex-memory.git
cd truenex-memory
- Install dependencies
pip install -e .
- Initialize a project
truenex-mem init my-app # creates a SQLite store
- Add entries
truenex-mem add --project my-app --key "database-url" --value "postgres://..."
- Search
truenex-mem search --query "database-url"
- Export a snapshot
truenex-mem export -f my-app.json
📣 Call to action
We’re just in the alpha phase, so your feedback is gold. 👀
- 👍 Use the “💬” button on the GitHub repo.
- 🚨 Report bugs or feature ideas via the
ISSUEtemplate. - 🌍 Fork, extend, or star if you love the idea.
Truenex Memory is a community‑driven tool: the more you use it, the better it gets. Let’s make knowledge searchable, portable, and forever.
Stay curious. Stay organized. 🌟
## Instructions
1. Go to https://dev.to/new
2. Paste the article (without