sodam-ai

SoDam O Brain Codex — Development skill for Claude Code

Development community

Codex 대화의 결정·제약·선호를 로컬 SQLite에 기억하고 검색·2D/3D 그래프·타임라인·백업으로 관리하는 로컬 우선 MCP 플러그인.

How to install SoDam O Brain Codex

This entry records only its repository, not the path inside it, so there is no exact command to give. Open sodam-ai/SoDam_O-Brain-Codex and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What SoDam O Brain Codex does

Codex 대화의 결정·제약·선호를 로컬 SQLite에 기억하고 검색·2D/3D 그래프·타임라인·백업으로 관리하는 로컬 우선 MCP 플러그인.

Alternatives in Development

Cyberboss — 一个接入微信的本地生活 Agent Bridge，让 Codex / Claude Code 拥有时间感、行踪感、随机唤醒和自主唤醒能力，用主动陪伴替代所有番茄钟和效率工具，自动记录日记、维护生活时间轴、发送文件和表情包 1.3k ★
Agenticros — ROS plugin for OpenClaw, Claude (Code,Desktop,Dispatch), Codex, Google Gemini, Hermes, MCP, etc 144 ★
Fireauto — Claude Code 자동화 플러그인 — SEO, 보안, 팀 에이전트, PRD, 레딧 리서치를 커맨드 하나로 132 ★

README

[English](./README.en.md) · [HTML](./README.html) · [Codex 저장소](https://github.com/sodam-ai/SoDam_O-Brain-Codex) · [포팅 전 원본](https://github.com/sodam-ai/SoDam_O-Brain)

소담 오브레인 Codex (SoDam O-Brain for Codex)

O-Brain은 Codex 대화에서 사용자가 확정한 결정·제약·선호·지식을 **내 컴퓨터의 SQLite DB에 저장**하고, 다음 작업에서 관련 기억을 다시 보여주는 1인용 로컬 메모리 플러그인입니다. 2D/3D 그래프, 목록, 타임라인, 검색, 백업 화면도 함께 제공합니다.

공식 소스 저장소: [github.com/sodam-ai/SoDam_O-Brain-Codex](https://github.com/sodam-ai/SoDam_O-Brain-Codex). 이 문서는 Codex 포팅판의 설치와 사용 방법을 설명합니다.

**“로컬에서 사용”한다는 말은 설치 파일도 개인 폴더에서만 받아야 한다는 뜻이 아닙니다.** 누구나 위 공식 GitHub 저장소에서 내려받아 설치하고, 실행과 기억 저장만 자신의 컴퓨터 안에서 합니다. 아래 명령에는 제작자의 개인 작업 경로가 들어가지 않습니다.

무엇을 할 수 있나요?
확인 범위와 지원 상태
사전 준비물과 필요 프로그램
다운로드와 설치
빠른 시작과 실행
사용 방법
명령과 테스트
파일과 데이터 위치
작동 흐름과 아키텍처
보안과 개인정보
백업·내보내기·복구
업데이트 내용
문제 해결
FAQ

무엇을 할 수 있나요?

기능	설명
자동 저장	Codex `Stop` 훅이 최근 대화에서 확정 문장을 찾아 저장합니다. 질문·잡담·AI 답변은 저장 대상에서 제외합니다.
자동 되읽기	`SessionStart` 훅이 현재 프로젝트와 관련된 기억을 소량 골라 Codex 문맥에 넣습니다.
MCP 7개 도구	검색, 저장, 단건 조회, 관련 기억, 타임라인, 관계 추가, 카테고리 목록을 제공합니다.
로컬 검색	FTS5 키워드 검색과 384차원 로컬 임베딩 검색을 함께 사용합니다.
시각화	개요, 목록/상세, 2D·3D 그래프, 타임라인, 설정 화면을 제공합니다.
데이터 안전	SQLite WAL, 온라인 백업, 입력 제한, 시크릿 가림, 삭제 전 백업을 사용합니다.
호환 파서	Codex `response_item` 로그와 원본 Claude Code 로그를 모두 읽습니다. Codex 포팅의 기본 도구 값은 `codex`입니다.

O-Brain은 사용자의 모든 말을 무조건 저장하지 않습니다. “하기로 정했다”, “반드시”, “선호한다”처럼 확정 신호가 있는 사용자 문장을 규칙으로 선별합니다. 중요한 내용은 `$o-brain-remember`로 직접 저장할 수 있습니다.

확인 범위와 지원 상태

항목	현재 상태
주 사용 환경	Windows 10/11 + Codex 앱/CLI
실제 검증 버전	Node.js `v26.7.0`, npm `11.6.2`, Codex CLI `0.155.1`
네트워크	설치·의존성·최초 모델 다운로드에 필요. 기억 저장과 검색은 로컬 처리
모바일	390px 너비 화면 표시를 확인했지만 서버가 같은 PC 전용이므로 휴대전화 원격 접속은 지