Ask your vault
“What do I know about EVPI?” or “find my ML final notes” retrieves real Markdown from the Obsidian vault you chose.
local-first · made for Obsidian vaults
a desktop companion
that knows your notes
twin.md is a small pet and chat window for people who keep their life in Markdown. Point it at an Obsidian vault, ask what you know, save titled quick notes back into your chosen folder, and approve useful desktop actions when you need them.
$ choose vault + quick notes folder
macOS builds on GitHub Releases → what it is
like OpenClaw, but for your desktop and your vault
Twin is not trying to become a giant productivity suite. It is a calm local companion that sits near your work, remembers the vault you selected during onboarding, and helps you use that knowledge without digging through folders.
Save thoughts back
/inbox creates a titled Markdown note in the quick-notes folder you picked during onboarding.
Approve useful actions
Let it hand off Spotify, browser, reminders, or desktop tasks only after you approve that specific request.
Keep it local
Your vault, chat snapshots, sprite state, and permissions stay on your machine or in your own vault folder.
how it feels
one small window, three useful moves
01
Choose your vault and inbox
Onboarding points Twin at your Obsidian or Markdown folder and asks where quick notes should land.
02
Ask in normal language
It can scan, retrieve, and summarize your notes instead of answering from vibes.
03
Let it help on desktop
Every desktop handoff stays queued until you approve it, so actions do not silently repeat.
companion, not dashboard
a pet-shaped interface for a serious notes folder
Friendly enough to keep open
The sprite gives the app a presence without turning your notes into a corporate dashboard.
Useful enough to trust
Tool-use pills show when Twin is scanning the vault, retrieving notes, creating a quick note, or asking for desktop approval.
Custom enough to feel yours
Create a character from a prompt or uploaded photo, then evolve it intentionally instead of randomly replacing it.
for vault people
students, researchers, builders, and anyone with too many Markdown notes.
local by default
state and session snapshots live on your machine or in your chosen Obsidian vault.
small on purpose
it retrieves, remembers, saves, and hands off. It does not try to own your workflow.
Have an Obsidian vault? Give it a companion that can actually read it.
start here →