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 new thoughts, and approve useful desktop actions when you need them.
$ choose vault in onboarding
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
Capture inbox notes, mood logs, and chat summaries without leaving the companion.
Approve useful actions
Let it hand off Spotify, browser, reminders, or desktop tasks only after you approve that capability.
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
Onboarding points Twin at your Obsidian or Markdown folder. That becomes its home base.
02
Ask in normal language
It can scan, retrieve, and summarize your notes instead of answering from vibes.
03
Let it help on desktop
Approve a capability once, then future matching requests can move faster.
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, saving to your inbox, 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 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 →