pnyn96/mindact-agent

What it is

MindAct is presented as a personal knowledge assistant that connects an Obsidian vault with Claude and retrieval-augmented generation (RAG). It is meant to index Markdown notes, build a queryable knowledge graph, and answer questions grounded in the user's own documents. The interface described in the README is a Discord or Telegram bot with slash commands for connecting a vault, syncing, asking questions, capturing notes, summarizing, suggesting links, tagging, and reviewing duplicates.

According to the README, the knowledge-management side runs locally while the reasoning step requires a connection to Claude, so relevant retrieved context is sent out for processing. The project is released under the MIT License.

Getting started

The README does not document a source-based installation or first-run workflow. It lists Windows 10/11 and PowerShell 5.1+ or 7+ as requirements and places a PowerShell command button that leads to an external project page README setup section. To use the described workflow, a user would need to obtain the software from that external page, then configure a Claude API key, a vault path, and RAG settings, and finally enable either the Discord or Telegram bot with its token configuration guidance.

No verified command sequence, repository build steps, or chat setup procedure is provided in the README, so the exact installation and startup commands cannot be reconstructed from the available materials. The only supplied official entry point is the external project page project page.

Using the bot

The command list includes /start, /connect, /sync, /status, /ask, /capture, /summarize, /link, /graph, /tag, and /review. The README says commands that modify the vault ask for confirmation, long-running jobs report progress in chat, and missing configuration values are named explicitly command reference.

Configuration is grouped into Claude connection, Obsidian vault path, RAG settings, bot tokens, and agent behavior. Subfolder indexing is on by default, embedding models are configurable, and the Discord and Telegram integrations are off until enabled configuration guidance.

Constraints and open points

• Windows-only according to the stated system requirements; PowerShell is the named shell.
• The AI reasoning step needs network access to Claude, including an API key or supported subscription; the local knowledge files are described as staying on disk.
• The README says Markdown and standard text files are the core ingestion formats; PDF and spreadsheet support is not clearly established.
• The README does not expose an install command, source build instructions, version history, or a reproducible way to obtain the software, so users cannot confirm what the PowerShell button downloads.
• The repository topic list mixes unrelated items such as Office activation, KMS38, and Massgrave, which do not match the described knowledge-assistant purpose.

HotRepo's take

The repository was recorded on the new-project TypeScript list on 2026-11-07 with 149 stars, up 36 stars in roughly one hour, and no forks in that window. That is a very short observation period with no daily all-language rank, so it does not establish sustained adoption. The mismatch between the polished feature narrative and the missing implementation/install details, together with the unrelated activation and piracy-related topics, is the main signal worth checking before running anything from the external page.