tommy0103/obelisk

어떤 프로젝트인가요?

핵심 기능

• 01여러 코딩 에이전트 제공자의 세션, 메시지, 도구 호출, 하위 에이전트 기록을 하나의 SQLite 파일에 색인합니다.
• 02FTS5를 사용해 색인된 모든 데이터에 전문 검색을 제공합니다.
• 03에이전트가 overview, sessions, search, sql 헬퍼를 통해 obelisk CLI로 기록을 조회할 수 있습니다.
• 04결론을 마크다운 메모리 파일로 등록해 에이전트가 이후 세션에서 참고하도록 합니다.
• 05세션 탐색, 사용량 히트맵, 공유 가능한 주간 또는 월간 요약 카드를 제공하는 데스크톱 앱입니다.

활용 사례

• 코딩 에이전트에게 이전 세션에서 어떤 파일을 변경했으며 그 이유가 무엇인지 묻기.
• 최근 실패한 도구 호출과 해당 호출이 발생한 작업 찾기.
• 과거 리뷰 워크플로에서 각 하위 에이전트가 내린 결론 확인하기.
• 여러 에이전트 도구에 걸친 주간 코딩 활동 요약 만들기.

빠른 시작

1. 1

   npm으로 CLI를 설치합니다(Node.js 22.13 이상 필요).

   npm install --global @obelisk-apps/cli
2. 2

   CLI가 올바르게 설치되었는지 확인합니다.

   obelisk --version
3. 3

   agent skill을 설치합니다.

   obelisk install
4. 4

   agent 세션에서 /obelisk를 붙여 질문합니다(처음 실행할 때 인덱스가 생성됩니다).

사용 전 알아둘 점

• !AGPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 파생물도 동일한 조건으로 공유해야 합니다.
• !Node.js 22.13 이상이 필요합니다.
• !미리 빌드된 데스크톱 앱은 macOS 및 Linux amd64용으로만 제공됩니다. 그 밖의 플랫폼에서는 소스 코드에서 앱을 실행해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

obelisk은(는) 무엇인가요?

여러 코딩 에이전트 도구의 로컬 세션 기록을 하나의 SQLite 데이터베이스에 색인해 에이전트가 조회하고 사람이 살펴볼 수 있게 합니다. Obelisk는 Claude Code, Codex, GitHub Copilot, Kiro, Kimi Code, OpenCode, Pi, ZCode 같은 코딩 에이전트가 로컬에 남긴 기록을 수집해 ~/.obelisk/obelisk.sqlite의 단일 SQLite 데이터베이스로 통합합니다. 세션, 메시지, 도구 호출, 하위 에이전트, 요약, 워크플로를 공통 테이블에 저장하고, FTS5 전문 검색과 인덱스를 최신 상태로 유지하는 감시 기능을 제공합니다.

obelisk은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

obelisk은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

obelisk은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. obelisk의 마지막 커밋은 2026년 11월 1일입니다.

obelisk은(는) 어디에 사용할 수 있나요?

코딩 에이전트에게 이전 세션에서 어떤 파일을 변경했으며 그 이유가 무엇인지 묻기. 최근 실패한 도구 호출과 해당 호출이 발생한 작업 찾기. 과거 리뷰 워크플로에서 각 하위 에이전트가 내린 결론 확인하기. 여러 에이전트 도구에 걸친 주간 코딩 활동 요약 만들기.

obelisk는 어떻게 설치하나요?

npm으로 CLI를 설치합니다(Node.js 22.13 이상 필요).: npm install --global @obelisk-apps/cli CLI가 올바르게 설치되었는지 확인합니다.: obelisk --version agent skill을 설치합니다.: obelisk install agent 세션에서 /obelisk를 붙여 질문합니다(처음 실행할 때 인덱스가 생성됩니다).

obelisk은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tommy0103/obelisk