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.

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.mdfallback - 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.