← all repositories
huytieu/COG-second-brain

Your markdown files just got a management layer

COG turns a flat Git-backed folder of markdown into a second brain staffed by specialist AI agents that read and write your notes.

COG-second-brain
Velocity · 7d
+20
★ / day
Trend
accelerating
star history

What it does

COG is a template vault that turns a Git-backed folder of markdown files into an agent-operated second brain. Open it in Claude Code, Cursor, or Gemini CLI and issue natural-language commands; the agents read and write .md files to capture braindumps, run daily briefs, process meetings, and manage a people CRM. Everything stays local—no database, just markdown and Git.

The interesting bit

The architecture borrows Garry Tan’s “specialist session” idea: six cheap worker agents (Sonnet) handle data extraction and file I/O, writing terse results to /tmp/ files, while the lead session (Opus) ingests the summaries and performs reasoning. This avoids burning expensive tokens on long tool outputs. A tiered People CRM also auto-enriches contact profiles from stubs to full dossiers based on how often you mention someone in your notes.

Key highlights

  • 17 skills covering personal knowledge, team intelligence, and PM workflows (PRDs, user stories, release notes)
  • Native agent surfaces for Claude Code, Cursor, Kiro, and Gemini CLI, plus a universal AGENTS.md fallback
  • No vendor lock-in: pure markdown storage, Git version history, optional iCloud sync, and Obsidian Tasks compatibility
  • Role-based packs (PM, Engineer, Founder, etc.) that surface relevant skills during onboarding
  • Framework updates are separated from your content, so pulling new skills won’t overwrite your braindumps

Caveats

  • Team intelligence skills expect a full stack of integrations (GitHub CLI, Linear, Slack, PostHog MCP) and are limited without them
  • The project is largely a convention layer—prompts, markdown schemas, and shell helpers—rather than a standalone executable
  • One accuracy claim (“95%+ source accuracy”) appears in the README without disclosed methodology

Verdict

Worth exploring if you already live in Claude Code or Cursor and want a structured, markdown-native system to run your personal knowledge management and light PM workflows. Skip it if you need a traditional app with a GUI or don’t want to wire up half a dozen SaaS integrations for team features.

Frequently asked

What is huytieu/COG-second-brain?
COG turns a flat Git-backed folder of markdown into a second brain staffed by specialist AI agents that read and write your notes.
Is COG-second-brain open source?
Yes — huytieu/COG-second-brain is open source, released under the MIT license.
What language is COG-second-brain written in?
huytieu/COG-second-brain is primarily written in Shell.
How popular is COG-second-brain?
huytieu/COG-second-brain has 705 stars on GitHub and is currently accelerating.
Where can I find COG-second-brain?
huytieu/COG-second-brain is on GitHub at https://github.com/huytieu/COG-second-brain.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.