매 세션마다 AI에게 프로젝트를 다시 설명하는 것이 지겨워져서 EGC를 만들었습니다

일주일 동안 손대지 않았던 프로젝트에서 AI 코딩 도구를 엽니다. 그리고 "계속하자"라고 입력합니다. 그러면 다음과 같은 상황이 시작됩니다.

"우리가 무엇을 작업하고 있었는지 다시 알려줄래?"

당신은 기술 스택(stack)을 설명합니다. 또다시 말이죠. 당신이 내린 결정들. 또다시 말이죠. 지난번에 무엇이 실패했는지. 또다시 말이죠. 컨텍스트(context)를 다시 구축할 때쯤이면, 15분을 허비하고 집중력의 절반을 잃게 됩니다.

저는 이것에 지쳤습니다. 그래서 EGC를 만들었습니다.

EGC가 하는 일

EGC는 당신이 사용하는 모든 AI 코딩 도구에 세션 간 지속적인 메모리(persistent memory)를 제공하는 로컬 런타임(local runtime)입니다. 각 세션이 끝날 때, 당신의 AI는 학습한 내용—내린 결정, 실패한 것, 당신의 선호도, 다음에 이어갈 작업—을 저장합니다. 다음 세션이 시작될 때, AI는 당신이 요청하지 않아도 스스로 그 상태(state)를 다시 불러옵니다.

실제로는 다음과 같이 작동합니다:

State loaded from egc-memory via ~/.egc/state/Projects-MyApp.md

Context and preferences acknowledged (terse responses).
...

당신은 아무것도 입력하지 않았습니다. 그저 작업을 시작했을 뿐입니다.

작동 원리

EGC는 당신의 AI 도구와 함께 로컬에서 실행되는 두 개의 MCP 서버를 제공합니다.

**egc-memory**는 지속성(persistence)을 담당합니다. 이 서버는 세션 동안 AI가 자동으로 호출하는 14개의 도구(tools)를 노출합니다:

• get_state — 세션 시작 시 프로젝트 메모리를 로드합니다.
• update_state — 결정 사항, 선호도 및 다음 단계를 저장합니다.
• store_decision — 개별 결정을 SQLite에 영구 저장합니다.
• search_history — 모든 과거 세션에 대해 BM25 랭킹을 사용한 전문 검색(full-text search)을 수행합니다.
• lesson_save / lesson_recall — 신뢰도 감쇠(confidence decay)가 적용된 세션 간 지식 관리 기능을 제공합니다.
• detect_patterns — 훅 이벤트(hook events)로부터 반복되는 명령과 오류를 찾아냅니다.
• working_memory_set/get — TTL(Time To Live)이 적용된 일시적인 컨텍스트를 관리합니다.

상태 파일은 ~/.egc/state/<project-slug>.md에 저장됩니다. 프로젝트당 하나의 파일이며, 일반 Markdown 형식으로 사람이 읽을 수 있습니다. 클라우드도, 구독도, 블랙박스(black box)도 없습니다.

**egc-guardian**은 안전성(safety)과 컨텍스트 압축(context compression)을 담당합니다:

• validate_command — 실행 전 프로젝트 규칙에 따라 셸 명령어를 검사합니다.
• validate_write — 파일 쓰기 경로를 검증합니다.
• reduce_context — 토큰 예산(token budget)을 절약하기 위해 파일 페이로드(payload)를 압축합니다.
• auto_learn — 세션 실패 사례를 분석하여 실행 가능한 교훈을 모든 AI 도구 설정 파일에 기록합니다.

단 한 번의 설치로 모든 도구 사용

npm install -g @egchq/egc && egc install

끝입니다. EGC는 사용 중인 AI 도구를 감지하고 자동으로 설정을 구성합니다. 다음 도구들과 함께 작동합니다:

• Claude Code
• Cursor
• Gemini CLI
• Windsurf
• Kiro
• 모든 MCP 호환 도구

또한 OpenRouter를 통해 Claude, GPT-4o, Gemini, DeepSeek, Qwen3, Llama 4 등 어떤 모델과도 함께 사용할 수 있습니다.

동기화 데몬 (sync daemon)

egc watch는 모든 도구의 설정을 양방향으로 동기화합니다. Cursor에서 컨텍스트를 수정하면 Gemini CLI, Copilot, Windsurf로 자동 전파됩니다. 어떤 도구에서든 수정하면 ~/.egc/state/로 다시 동기화됩니다.

egc watch        # 현재 프로젝트 감시
egc watch --quiet

로컬 우선(local-first) 방식이 중요한 이유

모든 세션 상태는 사용자의 기기에 있는 일반 Markdown 파일입니다. 이를 읽고, 편집하고, 버전 관리(version-control)하고, 삭제할 수 있습니다. 계정도 없고, EGC를 위한 API 키도 없으며, 서버가 다운되어 사용자의 기억(memory)을 함께 가져가 버릴 일도 없습니다.

MCP 서버는 로컬 Node.js 프로세스로 실행됩니다. AI 제공업체가 직접 수행하지 않는 한(이는 AI 제공업체가 무엇을 하든 상관없이 발생하는 일입니다), 어떤 데이터도 사용자의 기기를 떠나지 않습니다.

보너스: 479개의 프롬프트 구성 요소

EGC는 실제 엔지니어링 세션에서 작성된 63개의 에이전트(agents), 229개의 기술(skills), 76개의 명령어(commands), 그리고 111개의 규칙(rules) 라이브러리를 제공합니다. 이를 설치하거나 완전히 무시할 수도 있지만, 어떤 경우든 EGC는 지속적인 메모리(persistent memory)를 제공합니다.

오픈 소스, 단 한 명의 개발자

EGC는 MIT 라이선스를 따르며 한 명의 개발자에 의해 구축되었습니다. GitHub 저장소는 github.com/Fmarzochi/EGC에 있습니다.

EGC가 당신의 작업 방식을 바꾸어 놓았다면, 스타(star)를 눌러 다른 개발자들이 이를 찾을 수 있도록 도와주세요.

문제가 발생하거나 질문이 있다면, 이슈(issue)를 생성하거나 Discord에 참여하세요.