Personal AI Knowledge OS · v0.3.0

COMAD
WORLD

Drowning in articles? Let AI agents crawl, organize & analyze for you.

Personal knowledge system that builds a searchable graph from RSS, papers & GitHub — updated daily, driven by one YAML config.

knowledge graph70,412 nodes
0
Agents
0
Graph Nodes
0
LOC
0
Tests
0
Cost Reduction

Sound familiar?

Without Comad World

  • Read an article, forget it, find it again a month later
  • Bookmarks pile up with no connections between them
  • Context lost every time you close a browser tab
  • Manual research across 20+ sites, every day

With Comad World

  • Articles auto-collected from 22+ RSS feeds, arXiv, GitHub
  • Entities linked in a knowledge graph — searchable via natural language
  • Every insight preserved and connected, forever
  • Daily digest delivered; $0.60/day operating cost

9 modules — 6 pipeline agents, one config-driven pipeline

Collect → Structure → Analyze → Act. Each agent deploys independently, but data flows seamlessly between them. Swap one YAML config to retarget the entire system to a new domain.

Collectear— RSS/Discord feed monitoring, 3-tier relevance classification, archive
Structurebrain— Entity extraction → Neo4j graph → Community detection → GraphRAG
Analyzeeye— Propagation simulation → 10 analysis lenses → Full report
Executephoto— Image analysis → Correction plan → Photoshop MCP automation
···
Maintainsleep— REM-style memory scan → Deduplication → Consolidation
Controlvoice— Natural-language triggers for workflow automation
Renderbrowse— Headless browser with anti-bot stealth — auto-fallback for JS pages

comad-brain

Knowledge Graph & GraphRAG

Extracts entities from articles, papers, and repos. Manages a Neo4j ontology and provides GraphRAG-powered Q&A.

TypeScriptBunNeo4j 5Claude APIMCP

6-Layer Architecture

[Collect] HN API + Configurable RSS + arXiv + GitHub + ear
  ↓
[Extract] Claude Haiku for entity/relation/claim extraction
  ↓
[Graph] Neo4j: 13 node types, 30 relation types, 22 communities
  ↓
[Infer] MetaEdge 10 rules
  ↓
[Search] Dual-Retriever: Local + Global + Temporal
  ↓
[MCP] 21 tools

Monorepo (5 packages)

coreEntity extraction, dedup detection, claim tracking, MetaEdge
crawlerHN/arXiv/GitHub crawlers, ingest pipeline
graphragDual-Retriever, subgraph exploration, answer synthesis
ingesterear archive → graph importer
mcp-serverMCP protocol server (21 tools)

Knowledge Graph Visualization

Knowledge Graph — Anthropic, OpenAI, Google, MCP, and 10,000+ connected entities

Graph Scale

69,618
Total Nodes
109,081
Total Relations
38
arXiv Papers
18,780
Claim Nodes

Key papers indexed: Attention Is All You Need, GPT-3/4, BERT, LLaMA 1~4, DeepSeek-R1/V3, Gemini, Chain-of-Thought, LoRA/QLoRA, FlashAttention, Mamba, DPO, GraphRAG, LightRAG, SAM, CLIP, ReAct, MemGPT, and more.
34 sources (default AI/ML preset): 31 RSS feeds (OpenAI/Anthropic/Google/Meta/xAI/DeepSeek blogs + researcher feeds) + HN API + arXiv API + GitHub API

GraphRAG Quality Benchmark (50 questions, 2026-04-13)

93%
Entity Recall
93%
Grounding Rate
13.8s
Avg Latency
72%
Hard Good Rate

Recall 83% → 93%, Latency 20.7s → 13.8s. Grounding Rate is a hallucination-resistant metric: the fraction of entities cited in the answer that actually exist in the graph.

Built On

LightRAG
Dual retrieval (Local + Global)
→ Added Temporal axis, Claim scoring, ear integration
GraphRAG (MS)
Community-based summarization
→ Leiden 3-level hierarchy (22 communities)
Karpathy (simplicity)
"Prompt tokens dominate LLM latency"
→ 3KB context cap: one-line fix, 33% latency reduction
Vannevar Bush (Memex)
Association belongs in the graph
→ Static concept map + Neo4j co-occurrence dynamic expansion

Live Demo

"What is MCP and which companies are using it in production?"

  • Definition: JSON-RPC 2.0 open standard with OAuth 2.0 integration
  • 9 companies identified: Anthropic, OpenAI, Google, Microsoft, Block, Bloomberg, AWS, Cloudflare
  • 8 MCP-adopting products + source citations + explicit "not in graph" markers

comad-eye

Prediction Simulation Engine

Extracts entities from text, runs propagation simulations, generates comprehensive reports through 10 analysis frameworks.

Python 3.13FastAPINext.js 16Neo4j 5OllamaBGE-M3

Pipeline

Text input (news, reports, papers)
   Ingestion (3-tier) → Graph loading → Community detection
   Simulation (N rounds) → 6-space analysis
   Lens deep-analysis (10 frameworks) → Report + quality gate

10 Analysis Lenses

Sun Tzu
Strategy
Competitive advantage
Machiavelli
Power
Stakeholder dynamics
Clausewitz
Conflict
Friction, center of gravity
Adam Smith
Economy
Markets, division of labor
Taleb
Risk
Black swan events
Kahneman
Cognition
System 1/2
Hegel
Dialectics
Thesis-antithesis-synthesis
Darwin
Evolution
Adaptation, selection
Meadows
Systems
Feedback loops
Descartes
Analysis
Decomposition, doubt

Live Demo

Input: 2 sentences → Output: 810-line, 15-section report

Key finding: "MCP serves as bridge node across 3 communities (confidence 70%)"

AI-crawler-readable (v1.1)

/analysis and /report are server components that inline the full analysis and report markdown into the initial HTML (hidden for sighted users, read by AI crawlers). Per-page generateMetadata generates title/description from actual findings. OpenGraph, Twitter Card, and JSON-LD (SoftwareApplication) emitted from the root layout. robots.txt explicitly allows GPTBot, ChatGPT-User, ClaudeBot, Claude-Web, PerplexityBot, Google-Extended.

E2E measurement: /report?job=… initial HTML body 18 B → 32,297 B (×1,794) — paste a URL into any AI and it reads the full report.

Supporting agents

Each focused on its role, all connected to the whole system.

comad-ear

Monitors feeds and auto-archives relevant content

3-tier relevance classification (must-read 13% / recommended 65% / reference 22%)
YAML frontmatter, automatic brain ingester integration
Daily HTML digest + must-read articles auto-fed into /search
Self-evolution loop closed: ear must-read → /search → adoption

comad-photo

Image analysis → correction plan → Photoshop MCP non-destructive editing

3 stages: PIL → Camera Raw → Advanced
MAE > 20 guardrail. Portrait avg score: 92.2.
v0.1
82 LOC
v0.2
65 LOC
v0.4
33 LOC

comad-sleep + Memory Bank

Self-learning memory graph: kb_facts + embeddings + auto-consolidation loop

kb_facts SQLite knowledge graph (94+ facts, INFLUENCES/SUPPORTS/REFINES edges) · Ollama embeddings for semantic search · 5 MCP tools (search/trace/explore/cross_scope/stats) shared by Claude & Codex.
Always-on loop: kb-sleep tick every 2h + auto-dream nightly · live changelog at /memory-log/

comad-voice

Natural-language workflow automation for Claude Code

Keyword triggers. CLAUDE.md-based. Zero external dependencies.
Review Army (5 specialist reviewers) + Browser QA included.
One sentence controls the entire process

comad-browse

Token-efficient headless browser for AI agents

Playwright Chromium + anti-bot stealth. @ref-based interaction, semantic find, batch multi-step flows in one round-trip.
Session persistence (cookies, localStorage) via --session flag. Multi-tab, advanced waits.
5-step login flow → 1 round-trip, no full snapshot needed

loopy-era always-on

Self-evolution harness — 8 LaunchAgents close the harvest→learn→decide→apply loop

supervisor 6-phase tick (30m, R6-slimmed) + kb-sleep memory sync (2h) + auto-dream (03:15) + nightly-audit → decision queue (04:00) + weekly learn & decision digest + monthly evolve + quarterly entropy audit. Outcome metrics (fix_ratio · ci_first_pass) in results.tsv. Zero new deps (Python stdlib + local Ollama). Guide →
Live changelog: /memory-log/ · single SoT for Claude & Codex

All numbers from real deployments

1,422
Tests
brain + eye suites · as of 2026-04-14
92.2
Photo Score
15 portraits, blind test
38
arXiv Papers
Full AI field coverage
810 lines
Eye Output
2 sentences → 15 sections
$0.60
Daily Cost
87% down from $4.50

One config file, any domain

Comad World ships with ready-made presets. Swap one file to retarget the entire knowledge pipeline to your field.

AI / Machine Learning

presets/ai-ml.yaml
Track LLM releases, paper trends, and framework updates. 31 RSS feeds + 10 arXiv categories.
"Which companies adopted MCP in production?" → 9 orgs identified

Web Development

presets/web-dev.yaml
Monitor framework releases, browser APIs, and CSS specs. 15 RSS feeds from V8, web.dev, MDN, and more.
"What's the current state of Web Components vs React?" → graph-backed answer

Finance / Fintech

presets/finance.yaml
Track regulatory changes, DeFi protocols, and market analysis. 10 RSS feeds + 6 arXiv categories.
"How does Basel III affect stablecoin regulations?" → cross-source analysis

Biotech / Life Sciences

presets/biotech.yaml
Follow CRISPR advances, drug trials, and genomics papers. 8 RSS feeds + 5 arXiv categories.
"What gene therapy approaches target sickle cell disease?" → literature-backed
# Switch domain in one command
cp presets/finance.yaml comad.config.yaml

# Or create your own — just define RSS feeds and arXiv categories
sources:
  rss:
    - url: https://your-field-blog.com/feed
      name: "Your Field Blog"
  arxiv:
    categories: [your.category]

Up and running in 4 commands

# 1. Clone the repo
git clone https://github.com/kinkos1234/comad-world.git

# 2. Enter the directory
cd comad-world

# 3. Pick a preset (or create your own)
cp presets/ai-ml.yaml comad.config.yaml

# 4. Install & start
./install.sh

Requires: Node.js 20+, Python 3.13+, Neo4j 5, Bun. The install script handles dependency setup and Neo4j schema init. For scheduled jobs, run brain/scripts/schedule-install.sh — it auto-detects macOS (LaunchAgents), Linux/WSL (cron), or Windows (Task Scheduler). See the README.

Already installed? One command.

# Any directory — installed as ~/.local/bin/comad by install.sh
comad status # VERSION + module SHAs
comad upgrade --dry-run # preview changes
comad upgrade # pull + deps + agents + auto-backup
comad rollback <ts> # restore a snapshot

make test # brain + eye suites
make clean # dry-run: preview runtime artifacts
make clean-apply # actually delete caches & logs

Under the hood: scripts/upgrade.sh aborts on dirty trees, snapshots comad.config.yaml / .env / ~/.claude/agents/ to .comad/backups/<ts>/, fast-forwards main + 6 module repos, reinstalls deps, and prints a per-module timed summary. VERSION + comad.lock pin every module SHA like package-lock.json.

📂 Clone anywhere — the repo is path-agnostic. scripts/comad follows its symlink to derive the repo root, scripts/render-templates.sh rewrites {{COMAD_ROOT}} in *.example files at install time, so any folder/any name just works (~/Desktop/foo, /opt/comad, …). No /Users/<author> hardcodes.

Major milestones

2026-03-21
comad-eye first commit
Python 3.13 + FastAPI + Neo4j · Simulation engine · ~8,000 LOC
2026-03-23
comad-brain started
TypeScript + Bun · 5-package monorepo · ~12,000 LOC · Neo4j knowledge graph
2026-03-30
Ecosystem complete
voice + sleep + photo · All 6 agents operational
2026-04-03
Full review sprint
E2E 60 tests · 1,422 total tests (2026-04-14) · Cost 87% reduction
2026-04-05
Open source launch
comad-world public repo · Config presets · MIT License
2026-04-08
Show HN launch
15 launch issues fixed · Content Guard against prompt injection · 4 MCP servers auto-connect on session start
2026-04-13
GraphRAG quality leap
Brain GraphRAG recall 83% → 93% · latency 20.7s → 13.8s · Phase A complete
2026-04-13
AI-readable Eye + comad CLI + path-agnostic install (v0.2.0)
Server-side rendered /analysis & /report (initial HTML 18 B → 32 KB) · comad upgrade/status/rollback global command · VERSION + comad.lock · clone the repo to any folder, any name
2026-04-13
Design system unified
Landing & guide site share comad-shared.css · black background, blue + warm orange palette · glassmorphic top bar across both
2026-04-14
ADR 0002–0006 · Eye package layout · scheduled-job safety
Per-module typed loaders (zod/pydantic) · hybrid synth routing · Search → Brain feedback loop · 50 eye modules migrated to comad_eye/ · fetchWithTimeout + 45m job deadline unblock a 4h ear-ingest hang · CI now runs the full 1,422-test suite
2026-04-14
v0.3.0 · 27-angle luminary review · mono-repo reversal
12 gap-pack artifacts (~1,813 LOC) across narrative, observability (3 SLIs + chaos drill), epistemic hygiene (Popper/O’Neil/Gebru/Pearl), and ecosystem feedback loops · ADR 0011 reverses ADR 0001 — 6 nested .git archived, single mono-repo restored · ADR 0007–0010 promote each gap pack
2026-04-17
Ear Mode B · Discord quota-safe polling
REST polling LaunchAgent (com.comad.ear-poll, 15 min) replaces the crash-looping ccd KeepAlive wrapper that was burning Discord’s 1,000/day IDENTIFY quota in ~8h · per-run claude -p --strict-mcp-config ensures zero MCP spawn
2026-04-19
Launchd boot-time catch-up · 11-job cron catalog
com.comad.cron-catchup replays any LaunchAgent that would have fired while the laptop was asleep, so Monday analysis still runs even if you opened the lid at noon · docs/cron-catalog.md documents all 11 agents with dependencies and missing-run recovery
2026-04-25
v0.3.0 promo video · 5-beat narrative
30-second hero refresh: 720×405 GIF (4 MB) + 1080p MP4 + 60fps derivative · Hook → Setup → Build → Climax → Rest · HTML + Playwright + ffmpeg pipeline (comad-motion skill) · BGM: “Loneliness” by Frozen Silence (CC-BY-NC-SA)
2026-04-25
comad-world-extensions · 5th skill (parallel) + 5 comad integrations
gptaku-plugins/pumasi v1.7.2 ported into comad-world-extensions as comad-parallel with five comad-native gates: handoff (auto session doc), qa-gate (.qa-evidence.json verdict), second-opinion-gate (.second-opinion.md verdict), destroy-check (13 destructive patterns post-scan), ear-notify (Discord webhook). T6 self-evolve coupling — parallel worker fix:/feat: commits auto-captured by existing Stop hook
2026-04-25
comad-studio · sister repo for visual/media generation
New comad-studio repo bundles 5 generation skills: comad-image (7-mode Codex /imagen), comad-motion (HTML→Playwright→ffmpeg, BGM/SFX bundled CC-BY 4.0), comad-pptx (LAYOUT_WIDE deck), comad-infographic (4 patterns), comad-app-prototype (iOS/Android/macOS/Browser frames) · one ./install.sh + ./doctor.sh · 47 MB w/ assets
2026-05-04
loopy-era · 9th module, always-on self-evolution
Self-evolution harness integrated as the 9th module — 3 LaunchAgents (supervisor 30m tick, kb-sleep 2h memory sync, auto-dream daily) · brain + ear memory-bank internalization with a single Codex SoT · zero new deps (Python stdlib + local Ollama)
2026-05-30
loopy-era R3 · autonomous nightly audit → decision queue
R3 closes the autonomy loop: a self-verifying nightly audit (04:00 KST) inspects repo health, cron logs, backlog and doc-drift, then escalates only items needing human judgment to a dedup'd decision queue — work → self-verify → escalate decisions only; silent when nothing needs a call
2026-06-04
always-on agents · CI self-heal + 4-axis PR review
Two session-external launchd agents internalized from a vibe-coding course · comad-ci-healer (GH Actions failure → classify → headless claude -p fix → auto PR → Discord notify, dry_run+allowlist guards) and comad-pr-review (4-axis correctness/security/performance/convention scoring → inline+summary comments, codex+claude, headSha dedup) · both live E2E-verified · comad-world-extensions skills 5→8
2026-06-11
R6 · measure & subtract — closed self-evolution loop
Self-evolution loop closed end-to-end: weekly learn (T6 analysis) · monthly evolve apply · weekly decision digest to Discord · quarterly entropy audit demanding 90-day contribution evidence · memory attribution + hook-ROI instrumentation · supervisor slimmed 15→6 phases · outcome metrics (fix_ratio · ci_first_pass) added to results.tsv · benchmarked against AlphaEvolve/ACE/Devin-class systems

하나의 시스템, 세 레포

코마드월드는 자가진화 가드와 산출물 스튜디오까지 합쳐 한 시스템을 이룹니다. 어느 레포만 깔아도 동작하고, 셋 다 깔면 전체 워크플로우가 닫힙니다.

comad-world

8개 핵심 모듈 — brain · ear · eye · photo · sleep · voice · search · browse

크롤링→그래프→시뮬레이션→예측 보고서까지의 지식 파이프라인. recall 93%, latency 13.8s. 1,422 tests. 87% cost reduction. v0.3.0.
GitHub → 사용 가이드 →

comad-world-extensions

조용한 가드 — 9 hooks + 12 skills (자가진화 / QA 증거 / 메모리 / 병렬 외주 / CI 자가복구 / PR 리뷰 / 측정 / brain 활용)

T6 자가진화 루프 (fix:/feat: 커밋 자동 포착 → /comad-learn 승격) · Approval-Gated Destruction (rm -rf, git push --force sha256 승인) · Proof-Driven QA (.qa-evidence.json + .second-opinion.md) · Codex 병렬 외주 (Claude=PM, Codex×N=구현) + 5종 통합 게이트 · CI 자가복구 상시 에이전트 (GH Actions 실패 → headless 수정 → 자동 PR) · 4축 Autonomous PR Reviewer · comad-sdd (Spec-Driven Development 닫힌 루프 — 완료기준→구현→대조) · harness-report (5축 하네스 점수 + 비용/efficiency 측정, 품질 composite와 분리) · comad-recall·comad-foresight (⚠️ comad-brain 필요 — 출처인덱스 +3.12 / 10렌즈 전략 foresight +1.375, 측정).
GitHub → 사용 가이드 →

comad-studio

산출물 스튜디오 — 5 visual/media 생성 스킬 (image · motion · pptx · infographic · app-prototype)

Codex /imagen 7-mode 이미지 · HTML→Playwright→ffmpeg 영상 (BGM 6곡 + SFX 16곡 CC-BY 4.0 번들) · pptxgenjs LAYOUT_WIDE 슬라이드 · 4-패턴 인포그래픽 · iOS/Android/macOS/Browser 프레임 목업. ./doctor.sh 의존성 매트릭스 진단.
GitHub → 사용 가이드 →

세 레포 모두 독립 설치 — 각자 ./install.sh. 의존성 공유 없이 기능별로 골라 설치 가능. 설치 순서는 world → extensions → studio 권장 (extensions 가 world 의 디렉터리 구조를 가정).