Obsidian Headless
Agent access toolOfficial Obsidian project
Created by Obsidian
Published in obsidianmd/obsidian-headless. Publisher page
247 GitHub stars
AutoGineer note
Obsidian Headless is Obsidian's official command line client for Obsidian Sync (open beta) that lets agents work with a synced vault without access to your whole computer. It is not a pre-built brain.
Obsidian has not published a brain of its own; these are its official tools for agents, and the brains below are community vault templates for Obsidian.
What it is
Headless client for Obsidian services
Summary from the brain’s metadata
Headless client for Obsidian services
How it works
Memory model: SQL database
AutoGineer overview, from the brain’s own files
Memory model: SQL database.
| Folder | Role | Files |
|---|---|---|
| btime | folder | 5 |
Requirements
Runtimes: Node.js >=22.0.0
Databases: SQLite
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Google Antigravity, Kiro, OpenCode, Amp, Roo Code, Cline, JetBrains Junie, Devin (ex-Windsurf)
Set it up
- Install it from Obsidian’s own page, then allow your agent to use it: https://help.obsidian.md/headless
AutoGineer did not scan Obsidian’s software.
- Not scanned by AutoGineerIts dependencies are installed by npm when you run it and were not scanned by AutoGineer (2 declared). https://www.npmjs.com/package/obsidian-headless
Created by Obsidian. Published in obsidianmd/obsidian-headless. Licence: Unrecognised licence declaration: UNLICENSED.
Usage
AutoGineer’s guidance for this type of brain
Install the tool from the vendor’s own page and allow your agent to run it, so the agent can read and write the vault of any brain listed here.
Documentation by Obsidian
The licence does not allow AutoGineer to copy these files. Read the documentation at the source
11 files · 11 not served here
- .gitignore (not served here)
- CHANGELOG.md (not served here)
- README.md (not served here)
- btime/darwin-arm64/btime.node (not served here)
- btime/darwin-x64/btime.node (not served here)
- btime/win32-arm64/btime.node (not served here)
- btime/win32-ia32/btime.node (not served here)
- btime/win32-x64/btime.node (not served here)
- cli.js (not served here)
- package.json (not served here)
- pnpm-lock.yaml (not served here)
Advantages
- Local-first: the memory stays in files or a database on your own machine (a rule-derived fact from the brain’s files, evidence: README.md)
- Works with 14 MCP clients (a rule-derived fact from the brain’s files, evidence: README.md)
- No API key is named in its files (a rule-derived fact from the brain’s files, evidence: README.md)
Limitations
- Needs a database (SQLite) (a rule-derived fact from the brain’s files, evidence: README.md)
- Link-only: AutoGineer links to the files instead of serving them (a rule-derived fact from the brain’s files)
Security
Risk level: No risk found
This brain runs
Binaries (5)
btime/darwin-arm64/btime.node:ships native binariesbtime/darwin-x64/btime.node:ships native binariesbtime/win32-arm64/btime.node:ships native binariesbtime/win32-ia32/btime.node:ships native binariesbtime/win32-x64/btime.node:ships native binaries
Obsidian’s software was not scanned by AutoGineer.
Attribution and licence
- Created by
- Obsidian
- Declared authors
- Dynalist Inc. (declared in package.json)
- Publisher
- Obsidian (Official Obsidian project)
- Source
- obsidianmd/obsidian-headless · commit 0d0ec43
- Licence
- Unrecognised licence declaration: UNLICENSED (The licence does not allow AutoGineer to copy these files.)
- Synced
AutoGineer is not affiliated with or endorsed by Obsidian.
Install from source
The licence does not allow AutoGineer to copy these files. obsidianmd/obsidian-headless at 0d0ec43