Repolode
Submit
smixs

smixs/agent-second-brain

A Telegram-driven personal agent that turns voice notes and messages into typed, linked markdown cards in your Obsidian vault, running on your own server.

View on GitHubWebsite
Stars
409
Forks
217
Open issues
2
Last commit
3 months ago

What is it?

Agent Second Brain is a self-hosted personal assistant you interact with through Telegram. You send voice notes, text, photos, documents or forwarded posts, and the agent classifies them, writes them as linked cards in an Obsidian vault, and keeps the vault organized without manual filing.

Under the hood it keeps one long-lived interactive Claude Code session running in tmux and sends prompts into it, rather than calling the headless claude CLI for each message. Scheduled reminders and routines run in a separate isolated session, a nightly job classifies the day's entries and updates goals and long-term memory, and a watchdog restarts stuck sessions. Voice audio is transcribed through Deepgram; everything else stays on the user's server as plain markdown.

The memory layer, autograph, adds typed cards, wiki-links, Ebbinghaus-style decay across five tiers, automatic index generation, link repair and deduplication. Users can extend the agent with MCP servers and custom skills.

Key features

  • 01Captures voice notes, text, photos, documents and forwarded posts from Telegram.
  • 02Writes entries as typed, interlinked markdown cards in an Obsidian vault.
  • 03Schedules its own reminders and recurring jobs from plain-language requests.
  • 04Runs a nightly process that classifies entries and rebuilds the knowledge graph.
  • 05Decays unused knowledge across five tiers and maintains indexes and link health.
  • 06Extensible through MCP servers and custom skills in the vault.

Use cases

  • Capturing ideas and tasks by voice while away from a computer.
  • Keeping a self-maintained Obsidian vault of client, project and personal notes.
  • Setting reminders and recurring checks through chat instead of a separate task app.
  • Running a private personal assistant on a cheap VPS without per-token API billing.

Topics

#personal-agent#obsidian#second-brain#telegram-bot#knowledge-graph#claude-code#voice-notes#self-hosted#ai-agents#ai-automation

FAQ

What is agent-second-brain?
A Telegram-driven personal agent that turns voice notes and messages into typed, linked markdown cards in your Obsidian vault, running on your own server. Agent Second Brain is a self-hosted personal assistant you interact with through Telegram. You send voice notes, text, photos, documents or forwarded posts, and the agent classifies them, writes them as linked cards in an Obsidian vault, and keeps the vault organized without manual filing.
Is agent-second-brain free to use? What license does it have?
agent-second-brain is open source under the MIT license. Check the license terms before using it in commercial products.
Is agent-second-brain still maintained?
Updated within 6 months. The last commit to agent-second-brain was on Aug 5, 2026.
What can I use agent-second-brain for?
Capturing ideas and tasks by voice while away from a computer. Keeping a self-maintained Obsidian vault of client, project and personal notes. Setting reminders and recurring checks through chat instead of a separate task app. Running a private personal assistant on a cheap VPS without per-token API billing.
Where can I get agent-second-brain?
The source code and installation instructions are on GitHub: https://github.com/smixs/agent-second-brain

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects