huytieu /COG-second-brain
Self-evolving second brain with 35 AI skills, 10 agents, and people CRM. Closed-loop harness: a V-model verification lifecycle where the worker never grades its own homework. Plus paired anti-slop design skills for marketing and product UI. Works with Claude Code, Cursor, Kiro, Gemini CLI, Codex.
★ 1,485⑂ 183👁 19⑃ 27● 22▤ 8
1,485
stars
183
forks
19
watchers
27
prs
22
issues
8
releases
README
COG: The Agentic Second Brain That Actually Self-Evolves
Cognition + Obsidian + Git — A self-evolving second brain powered by AI agents, markdown files, and version control. No database, no vendor lock-in — just .md files that think.
Quick Start | Skills | Features | FAQ | SETUP.md
Works with Claude Code • Antigravity • Cursor • Kiro • Gemini CLI • OpenAI Codex • any AI that reads markdown
Inspired by Garry Tan's gstack and gbrain
mermaid
graph LR
A[You] -- natural language -- B[AI Agent]
B -- runs -- C[43 Skills]
C -- delegates to -- W[6 Workers]
C -- verified by -- V[4 Read-Only Verifiers]
C -- reads & writes -- D[.md Files]
W -- reads & writes -- D
V -- observes -- D
C -- syncs with -- G[GitHub / Linear / Slack / PostHog]
D -- E[Git]
D -- F[iCloud]
Quick Start
1. Clone & enter the repo:
bash
git clone https://github.com/huytieu/COG-second-brain.git
cd COG-second-brain
2. Run onboarding in your agent:
| Agent | Command | How it finds skills |
|---|---|---|
| Claude Code | code . → "Run onboarding" | .claude/skills/ |
| Antigravity | Open folder → "Run onboarding" | .agents/skills/ + .agents/rules/cog.md |
| Cursor | Open folder → "Run onboarding" | .cursor-plugin/ + .cursorrules |
| Kiro | Open folder → "setup COG" | .kiro/powers/ |
| Gemini CLI | gemini → /onboarding | GEMINI.md + .gemini/commands/ |
| OpenAI Codex | codex → "Run onboarding" | AGENTS.md |
| Other agents | Point at AGENTS.md → "Run onboarding" | AGENTS.md |
Or install via skills.sh:
bash
npx skills add huytieu/COG-second-brain
Done — COG is personalized and ready in ~2 minutes. See SETUP.md for optional config (Git sync, iCloud, Obsidian Tasks, etc.).
Agent Support Matrix
COG ships a full Claude Code surface, a full Antigravity surface, plus core native surfaces for Kiro and Gemini CLI, with AGENTS.md as the universal fallback for Codex and other markdown-reading agents.
| Surface | Current support | Notes |
|---|---|---|
| Claude Code | 33 native skills + 10 agents (6 workers + 4 verifiers) | Full first-class surface |
| Antigravity | 43 skills + 10 agents (pointer-stub format) | Full surface — thin stubs in .agents/ delegate to the .claude/ playbooks, which stay authoritative |
| Agent Plugins standard | Root plugin.json + skills/ (43 skills) | Spec 1.0.0 conformant; any standard-aware client loads COG as a plugin |
| Cursor | Plugin manifest + rules | .cursor-plugin/plugin.json + .cursorrules |
| Kiro | 7 native powers | Core workflows today |
| Gemini CLI | 7 native commands | Core workflows today |
| AGENTS.md | 33 documented commands | Universal fallback for Codex and other agents |
Before publishing or updating framework files, run ./scripts/validate-agent-surface.sh to catch drift between manifests, docs, and shipped files. See docs/AGENT-SUPPORT.md for the detailed support matrix and contributor rules.
Skills
Core Skills (Personal Knowledge)
| Skill | What it does | Try sayTop issues
#16[Feature Request / Contribution] Mobile Voice-to-Vault Pipeline: Local Whisper STT & "Inbox" Workflow3 comments · 2026-03-20#48Purpose and lifecycle of 00-inbox0 comments · 2026-10-05#42Feature: logical dependency and error-tracking as separate skill0 comments · 2026-08-23#41Feature: pre-packing support for document digestion and progressive summarization0 comments · 2026-08-23#40Feature: Native "borg" support0 comments · 2026-08-23#39Opening discussion page?0 comments · 2026-08-23#38Team-Brief Skill - Phase 2: Parallel Data Collection section subagent_types now general-purpose0 comments · 2026-08-18#37Team-Brief Skill - Parallel Agent Team Execution Strategy references /daily-brief0 comments · 2026-08-18
Latest release
v3.16.0: PM Release and Content Skills v3.16.0 2026-10-23Added PM release and content skills Seven skills that cover what happens after code ships: the release note, the docs article, the demo media, and the posts that announce it. Each one came from a real release cycle and was generalized; product names, channels, repos, and brand values now come from config. - release-comms turns a deployment runsheet and a GitHub milestone into a customer release note with real screenshots and videos from the issues and PRs, docs updates (including older articles the release makes stale), and a Slack announcement draft. Nothing posts without your approval. -