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
PythonMITCreated 2025-10-15
下载:v3.16.0: PM Release and Content Skillsv3.16.0 ↓3.16.02026-10-23
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 say

Top issues

Latest release

v3.16.0: PM Release and Content Skills v3.16.0 2026-10-23
Added

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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON