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.

0
Agents
0
Graph Nodes
0
LOC
0
Tests
0
Cost Reduction
ear
brain
eye
photo
|
sleep
|
voice
Get Started 사용법 가이드 →
Comad World Demo — v0.3.0 promo · 5-beat narrative

🎬 Full-quality 1080p MP4 · 60fps · 30s · Origin story · Why it’s defensible (moat)

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

6 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

60,827
Total Nodes
150,988
Total Relations
153
arXiv Papers
23,084
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

REM-style automatic memory scan, dedup, and consolidation

MCP server, 122 LOC. info + history 2 tools.
Auto-triggers on "dream" or when memory exceeds 150 lines

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

All numbers from real deployments

1,388
Tests
brain 200 + eye 1,188 (2026-04-14)
92.2
Photo Score
15 portraits, blind test
153
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,388 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,388-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

하나의 시스템, 세 레포

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

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 + 5 skills (자가진화 / QA 증거 / 메모리 / 병렬 외주)

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종 통합 게이트.
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 의 디렉터리 구조를 가정).