If You Disable Codex’s SQLite Logs, What Keeps Your Project Memory Alive?

개요

Codex의 SQLite 로그로 인한 과도한 디스크 쓰기 문제를 해결하기 위해 로그를 비활성화할 때, 프로젝트 연속성을 유지하기 위해 필요한 정보를 어떻게 보존할 수 있는지에 대한 논의와 QiJu라는 솔루션이 소개됩니다.

주요 내용

* Codex SQLite 로그 문제: Codex가 ~/.codex/logs_2.sqlite에 진단 데이터를 지속적으로 기록하여 과도한 SSD 쓰기, WAL 파일 급증, 응답 속도 저하, 잠금 경합, 시작 또는 세션 안정성 문제 등을 야기합니다.
* 비공식 해결책 및 근본적인 질문: SQLite 트리거를 사용하여 로그 테이블에 대한 새로운 삽입을 무시하는 비공식 해결책이 존재하지만, 이는 에이전트의 내부 로그를 비활성화했을 때 프로젝트 재개를 위해 필요한 메모리를 무엇이 보존하는지에 대한 근본적인 질문을 제기합니다.
* 진단 로그와 프로젝트 메모리의 차이: 에이전트의 내부 로그는 주로 에이전트 애플리케이션 자체를 위한 것으로, 네트워크 이벤트, 추적 출력, 런타임 상태 전환, 디버깅 정보 등을 포함합니다. 반면 프로젝트 메모리는 다음 코딩 에이전트가 프로젝트를 이어받을 때 필요한 더 작고 의미 있는 정보(예: 현재의 기준 파일, 결정, 실패한 접근 방식, 완료되지 않은 작업 등)입니다.
* 로그 차단 시 발생하는 현상: 로그를 차단하는 해결책은 디스크 쓰기 감소, WAL 성장 둔화, SSD 압력 감소 등의 의도된 효과를 가지지만, 진단 가시성을 줄이고 향후 스키마 마이그레이션 후 다르게 동작하거나 디버깅을 방해할 수 있습니다. 또한, 이는 프로젝트 메모리 전략으로 간주되어서는 안 됩니다.
* 연속성 성능의 중요성: 모델 품질, 응답 속도, 토큰 사용량 등 일반적인 에이전트 성능 외에도, 새로운 세션이 올바른 컨텍스트를 얼마나 빨리 복구하고 작업을 계속할 수 있는지에 대한 '연속성 성능'이 중요합니다.
* QiJu 솔루션: QiJu는 AI 코딩 에이전트를 위한 로컬 우선, 무손실 기록 레이어로, 작업이 지속될 수 있도록 하는 핵심 사실(기준 파일, 결정, 증거, 결과, 미해결 위험, 다음 행동)을 기록합니다. 이는 모델이 더 많은 것을 기억하게 하는 것이 아니라, 명시적인 기록 레이어를 생성하여 작업의 감사 가능성과 인계 가능성을 높입니다.
* QiJu의 작동 방식: QiJu는 모든 대화 라인이나 도구 이벤트를 보존하려 하지 않고, 다음 에이전트가 올바른 상태에서 계속할 수 있도록 필요한 핵심 사실을 기록합니다. 이는 Codex 로그가 Codex 내부에서 무슨 일이 일어났는지 알려주는 것과 달리, QiJu는 다음 에이전트가 작업을 계속하는 데 무엇이 중요한지 알려줍니다.
* QiJu 업데이트 및 프로젝트 등록: QiJu CLI 업데이트 시 설치된 SKILL.md 파일이 스태일하게 남아있을 수 있는 문제를 해결하기 위해 qiju update 명령어를 제공하여 설치된 QiJu 스킬을 등록된 프로젝트에 걸쳐 새로 고칩니다. 프로젝트 초기화 시 qiju init을 통해 프로젝트 위치를 등록하며, .qiju/config.json은 해당 프로젝트에서 활성화된 호스트에 대한 정보의 원천이 됩니다.
* QiJu의 한계: QiJu는 Codex의 SQLite 로깅 동작을 수정하거나, SSD 쓰기를 직접 중지하거나, Codex 진단을 대체하지 않습니다. 또한, 비공식 데이터베이스 트리거의 안전성을 보장하거나, Codex 대화 인터페이스를 복제하거나, 모든 내부 이벤트를 재현하거나, 모든 트랜스크립트 또는 프롬프트를 자동으로 수집하지 않으며, 임베딩이나 벡터 메모리를 사용하지 않습니다.
* 디자인 교훈: 개발자는 진단, 대화 기록, 저장소 상태, 결정 기록, 지속 컨텍스트 등 다양한 종류의 메모리를 혼합하는 경향이 있습니다. Git, 대화 기록, 진단 로그 등 단일 저장소만으로는 이 다섯 가지를 모두 나타낼 수 없으며, 지속 가능한 에이전트 워크플로우는 명시적인 프로젝트 기록 레이어를 필요로 합니다.

시사점

Codex 로그 문제를 해결하기 위한 해결책으로 로그 비활성화가 가능하지만, 프로젝트 연속성 확보를 위해 진단 로그와 프로젝트 메모리를 명확히 구분하고 QiJu와 같은 별도의 기록 레이어를 활용하여 에이전트의 내부 상태 변화에 관계없이 프로젝트를 안정적으로 이어받을 수 있도록 해야 합니다.