xgre1/troth
Switch AI models freely, keep the same memory on your own machine
troth is an open-source tool that stores an AI partner's memory, identity, goals and refusal rules in a single SQLite file on your own computer instead of inside a vendor's account. Whether you use a Claude, ChatGPT or Kimi subscription, your own API key, or a fully local model, that file stays put, so switching models doesn't mean re-explaining your context. The README demonstrates this by having a conversation with Claude on Monday get recalled correctly by Kimi on Thursday, from a fresh terminal.
What it does
- Decisions, goals and relationship context from your conversations are kept in one local file (~/.troth/state.db) that you own, not in any vendor's account
- Dangerous commands like rm -rf are refused by a state check before the model is even asked, rather than after the fact
- Web research runs through troth's own separate browser profile, and jobs needing a login get credentials attached by the system without the model ever seeing the actual secret value
- On a 20-question slice of LongMemEval, it scored 85% (17 of 20) under its own judge, though the authors note the confidence interval is roughly ±20 points at that sample size
- The substrate can sync across multiple devices, and a signed audit trail records what was remembered and what was forgotten
Why it matters
For anyone juggling multiple AI subscriptions or models, this removes the friction of re-explaining project context every time you switch. It's also notable for keeping personal data on your own disk rather than a company's servers, which matters for privacy and data ownership.
Terms in this repo
- SQLite · A lightweight database that runs as a single file with no separate server
- engine · The term the project uses for the underlying AI model doing the actual talking (Claude, ChatGPT, Kimi, etc.)
- MCP · A protocol that lets an AI connect to external tools or servers to take actions
- AGPL · An open-source license that requires sharing source code even when the software is run as a network service
Repository description (English)
An AI partner whose memory lives on your machine, not in a vendor account. Swap the model, keep the mind.
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install