aios memo GUI: 에이전트의 기억을 살아있는 그래프로 시각화¶
당신의 코딩 에이전트가 몇 주간 작업해왔습니다. 코드를 작성하고, 버그를 수정하고, 결정을 내렸죠. 하지만 그 이력은 실제로 어떻게 보일까요?
이제 직접 볼 수 있습니다.
aios memo GUI는 ContextDB의 비주얼 인터페이스입니다 — 에이전트의 세션 이력을 인터랙티브 노드 그래프로 변환하여, 무슨 일이 언제 일어났고 어떻게 연결되어 있는지 탐색할 수 있습니다.
무엇을 보고 있는 건가요¶
위 스크린샷은 aios memo GUI의 ContextDB 뷰를 보여줍니다. 각 부분의 의미:
그래프 (좌측): - 각 노드는 프로젝트 기억의 조각 — 세션, 체크포인트, 파일 참조 - 노드 사이의 선은 관계를 보여줍니다: "이 체크포인트는 저 세션에서 나왔다", "이 파일은 저 이벤트에서 참조되었다" - 보라색 노드는 프로젝트 내 실제 파일에 대한 참조
상세 패널 (우측): - 아무 노드나 클릭하면 전체 상세 정보 표시 - 신뢰 점수와 위험 수준 등 메트릭 표시 - 부모 세션 및 증거 참조 목록 - 소스 파일 경로 표시
상단 바: - 빠른 통계: 노드, 세션, 체크포인트, 위험 수 - 필터 탭: 전체, 세션, 체크포인트, 이벤트, 위험 - 검색: 이름으로 특정 노드 찾기
왜 이것이 중요한가¶
GUI가 있기 전에는, 에이전트의 이력을 이해하려면 다음과 같은 작업이 필요했습니다:
memory/context-db/sessions/의 파일을 뒤지기- CLI 명령을 실행하고 JSON 출력 읽기
- 세션, 체크포인트, 이벤트를 머릿속으로 연결하기
이제 그냥 보면 됩니다.
지난 화요일에 에이전트가 무엇을 하고 있었는지 알고 싶나요? 세션 노드를 클릭하세요. 특정 체크포인트 동안 어떤 파일이 건드려졌는지 보고 싶나요? 엣지를 따라가 보세요. 플래그된 위험을 찾고 싶나요? 위험 탭으로 필터하세요.
시작하기¶
aios memo GUI는 기존 ContextDB 데이터를 읽어옵니다. 이미 Harness CLI가 설정되어 있고 프로젝트에 .contextdb-enable이 있다면, 데이터가 준비되어 있습니다.
- GUI를 열고 프로젝트를 지정
- Load를 클릭하여 ContextDB 데이터 가져오기
- 그래프 탐색 — 노드 클릭, 연결 따라가기, 검색 활용
그래프는 프로젝트의 전체 기억을 로드합니다: 세션, 체크포인트, 이벤트, 파일 참조, 위험 플래그, 핸드오프 기록. ContextDB가 기록한 모든 것을 한눈에 볼 수 있습니다.
할 수 있는 것들¶
세션 간 버그 추적¶
위험 노드를 클릭하고, 엣지를 따라 해당 위험이 처음 감지된 세션과 체크포인트로 돌아가기. 문제가 나타났을 때 에이전트가 정확히 무엇을 하고 있었는지 확인할 수 있습니다.
기억의 계통 이해¶
세션이 어떻게 연결되어 있는지 보기: 어떤 체크포인트가 다음 세션을 생성했는지, 어떤 파일이 여러 세션에서 참조되었는지, 컨텍스트가 에이전트 간에 어떻게 전달되었는지.
에이전트 행동 감사¶
각 노드의 신뢰 점수와 위험 수준으로 빠른 상태 확인. "위험"으로 필터하여 플래그된 항목만 보고, 하나씩 조사.
특정 이벤트 검색¶
검색 바로 파일 이름, 세션 ID 또는 임의의 텍스트 콘텐츠로 노드 찾기. 더 이상 JSONL 파일을 grep할 필요가 없습니다.
더 큰 그림¶
aios memo GUI는 ContextDB 생태계의 일부입니다 — 코딩 에이전트가 세션 간에 기억할 수 있게 하는 기억 시스템. ContextDB는 백그라운드에서 자동으로 작동하고(이벤트 기록, 체크포인트 생성, 컨텍스트 팩 구축), GUI는 그 과정을 인간이 읽을 수 있는 형태로 보여줍니다.
단순히 예쁜 것이 아닙니다 — 실용적입니다. 궤도를 벗어난 에이전트를 디버깅할 때, 결정의 이유를 이해하려 할 때, 또는 야간 하네스 실행 중 무슨 일이 있었는지 감사할 때, 비주얼 그래프는 어떤 로그 파일보다 빠르게 스토리를 전달합니다.
사용해 보기¶
이미 Harness CLI에서 ContextDB를 사용하고 있다면, 데이터가 준비되어 있습니다. aios memo GUI를 열고 탐색을 시작하세요.
Harness CLI가 처음이신가요? 퀵스타트 가이드로 시작하여 프로젝트에서 ContextDB를 실행하고, 돌아와서 에이전트의 기억을 시각화하세요.
aios memo GUI는 Harness CLI 생태계의 일부입니다.시작하기 또는 ContextDB 문서를 읽고 에이전트 기억에 대해 자세히 알아보세요.