smixs/agent-second-brain

An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.

What it solves

It eliminates the manual effort of maintaining a personal knowledge management (PKM) system. Instead of manually organizing notes, tagging files, or managing a vault, users can capture information via voice or text in Telegram, and an AI agent automatically files, links, and organizes that data into a structured Obsidian vault.

How it works

The system operates as a Telegram bot that interfaces with a persistent, interactive Claude Code session running in a tmux pane on a VPS. This setup allows the agent to function using a standard Claude subscription rather than metered API tokens.

Key components include:

  • Capture: Voice notes are transcribed via Deepgram, and text, photos, or documents are processed by the agent.
  • Memory Engine (autograph): A typed memory layer that organizes data into cards with wiki-links and implements an Ebbinghaus-based decay system (five tiers from Core to Archive) to keep the knowledge graph relevant.
  • Automation: The agent manages its own schedules (cron jobs) for reminders and performs nightly processing to classify entries and generate daily reports.
  • Storage: All data is stored as plain markdown files in an Obsidian vault on the user's own server, ensuring no vendor lock-in.

Who it’s for

Individuals who want a "second brain" for capturing ideas, managing CRM contacts, and tracking projects without the friction of manual organization, and those who prefer self-hosting their private data over using a SaaS product.

Highlights

  • Voice-First Capture: Fast entry via Telegram voice notes.
  • Subscription-Based Cost: Runs on a flat monthly fee (Claude Pro + cheap VPS) rather than per-token API billing.
  • Self-Healing: Includes a watchdog and "daily doctor" to ensure the agent stays online.
  • Knowledge Graph: Automatic MOC (Map of Content) generation, link repair, and deduplication.
  • Extensible: Supports MCP servers and custom skills added to the vault.

Related

  • Project
    eugeniughelbur/obsidian-second-brain

    An AI-powered second brain for Obsidian that allows LLMs to search, rewrite, and maintain a persistent knowledge vault across different AI sessions and platforms.

  • Project
    logancyang/obsidian-copilot

    An AI agent plugin for Obsidian that enables multi-step research and knowledge work by integrating LLMs directly into the user's vault.

  • Project
    breferrari/obsidian-mind

    An Obsidian vault template that provides AI coding agents with persistent, cross-session memory through automated hooks and semantic search.

  • Project
    jaredrhod/ai-memory-vault

    A system that turns an Obsidian vault into a persistent, external memory for AI agents, allowing them to remember information across sessions without context limits.

  • Project
    green-dalii/obsidian-llm-wiki

    An Obsidian plugin that transforms notes into a connected, queryable knowledge base using graph-based retrieval instead of embeddings, enabling AI chat over personal notes.