KG
KGentool Docs

KGentool 아키텍처

브라우저 제어와 런타임 정책을 분리한 구조를 기준으로, 확장과 호환을 동시에 유지합니다.

전체 흐름도

KGentool 아키텍처 흐름도

Control Center + JS Shell

  • 제어 센터 UI와 Electron 앱 수명주기 관리
  • MCP stdio 서버 구동 및 HTTP API 노출
  • 탭/창/팝업/브라우저 액션 어댑터 담당

Browser Backend

  • electron: 임베디드 창
  • chrome-cdp: 실제 Chrome 계열 브라우저 제어
  • 벤더 UI 변화는 profile/selector 레이어에서 흡수

C++ Core

  • 세션/거버너/워크플로/상태 관리 축 담당
  • Shell-Core는 NDJSON RPC 규약으로 통신
  • 환경에 따라 JS in-process fallback 경로 제공
현 시점에는 C++ 코어가 skeleton 단계이며, 기능 일부는 JS 호스트가 대체합니다.

워크플로 정의 재사용

  • .kgentool/workflows.toml로 실행 체인 정의
  • .codex/agents/*.toml의 에이전트 설명을 재사용
  • project-local 정의로 커스터마이즈 가능

인터페이스 전략

레이어 기본 네임스페이스 호환 전략
MCP 도구 kgentool_* agentify_* alias 유지
상태 루트 ~/.kgentool/ legacy 경량 메타 마이그레이션
프로파일 vendor-profiles/* 기존 selector override 파일 호환