오늘 한 일을 기억하는 앱,
Side를 이해하고 쓰기

Side의 로컬 기록·검색, 선택적 요약, 별도 MCP 에이전트 연결을 쉬운 말로 설명합니다. 설치와 실제 질문 예시도 함께 담았습니다.

0먼저, Side가 무엇인가요?

"어제 그걸 어디서 봤더라?"를 다시 찾는 개인용 기록 도구입니다.

예를 들어 어제 브라우저에서 문서를 읽고, 메모 앱에 문장을 적고, 다른 앱에서 관련 화면을 살펴봤다고 해 봅시다. 며칠 뒤 정확한 제목이나 주소가 떠오르지 않아도 Side에 연결된 에이전트에게 그 일을 찾아 달라고 할 수 있습니다. Side는 현재 Mac에서 허용된 화면의 텍스트와 활동을 기록해 출처와 함께 찾게 해줍니다. 요약 제공자를 설정하고 전송에 동의하면 날짜별 요약도 만들 수 있습니다.

브라우저 안의 탭만이 아니라 Mac 앱의 활성 창도 대상입니다. 다만 "Mac의 모든 것을 빠짐없이 기억한다"는 뜻은 아닙니다. 권한이 있어야 읽을 수 있고, 제외한 앱·웹사이트와 비밀번호 필드는 관찰하지 않습니다. 접근성 텍스트가 없는 화면에는 선택적으로 화면 글자 인식이 쓰입니다.

1한 줄로 이해하기

개인 메모와 도서관 검색대를 함께 떠올리면 쉽습니다.

2활동이 기억이 되는 과정

기록과 검색은 로컬에서 동작합니다. 요약과 에이전트 연결은 따로 선택합니다.

Side가 보는 첫 지점은 현재 활성 창입니다. Accessibility(손쉬운 사용) 권한으로 읽을 수 있는 글과 창 정보를 가져오고, Input Monitoring(입력 모니터링)은 상호작용과 입력 문장 완성 신호를 돕습니다. 읽을 글이 없는 화면에 한해, 사용자가 허용했다면 OCR(Optical Character Recognition, 화면 글자 인식)으로 화면의 글자만 추출합니다. 이미지를 기록으로 남기지는 않습니다.

원본 기록은 Mac 안의 암호화된 ledger(원장, 시간순 장부)에 들어갑니다. Side는 알려진 비밀번호·토큰·카드 번호 패턴을 먼저 가리지만, 규칙으로 모든 민감한 값을 알아낼 수는 없습니다. 하루 요약 페이지와 검색 색인은 별도 파일로 만듭니다. 원본의 기본 보관 기간은 14일이고, 요약은 직접 지울 때까지 별도로 남습니다.

3Side는 어떻게 찾아주나요?

기억나는 단서가 적어도 시간이나 주제로 찾아볼 수 있습니다.

언제 보았는지와 기억나는 단어를 함께 알려주면 Side가 관련 기록이나 브라우저 방문 기록을 찾습니다. 예를 들어 “어제 본 식당 예약 페이지”처럼 말할 수 있습니다. 방문 기록만 남아 있다면 방문 시간·제목·주소만 확인할 수 있고, 그 페이지의 본문까지 읽을 수 있는 것은 아닙니다.

정확한 표현이 기억나지 않아도 “지난주에 살펴본 환불 규정”처럼 주제를 말해볼 수 있습니다. 이 방법은 날짜별 요약이 실제로 만들어졌을 때 도움이 됩니다. 설정이나 권한 때문에 남지 않은 화면은 찾을 수 없으며, 중요한 내용은 찾은 출처에서 다시 확인하세요.

더 알아보기 · 검색 도구와 출처 번호

정확한 단서가 있을 때

history_search — 단어와 시간으로 찾기

앱 이름, 페이지 제목, 주소의 단어, 입력 문장처럼 실제 기록에 있는 표현을 찾습니다. 최근 활동에 가산점도 줍니다. 시기와 단어가 기억날 때 좋습니다. Side 캡처 e:, 요약 s:, 브라우저 방문 기록 h:를 찾으며 임베딩 벡터는 쓰지 않습니다. h:에는 방문 시각·제목·주소가 있고 화면 본문은 없습니다.

표현이 가물가물할 때

memory_search — 단어와 의미를 함께 찾기

날짜별 요약 페이지를 단어 검색과 embedding(임베딩, 문장의 뜻을 숫자로 옮긴 것)으로 함께 찾습니다. 예를 들어 기록에는 "화면 글자 인식"이라고 적혔는데 질문은 "OCR 문제"라고 해도 관련 내용을 찾을 가능성이 있습니다. 임베딩 계산은 Mac에 동봉된 MiniLM 모델이 로컬에서 합니다.

출처를 확인할 때

history_read — 번호를 열어 보기

검색 결과의 e: 또는 s: 번호를 그대로 넣어 원본 기록이나 요약을 읽습니다. h: 번호는 이 도구로 열 수 없고 검색 결과의 제목·주소만 볼 수 있습니다. 원본 보관 기간이 끝나면 그 원본은 열리지 않을 수 있지만 관련 요약을 찾을 수 있습니다.

벡터란?

vector search(벡터 검색, 뜻이 비슷한 글 찾기)

문장을 숫자 좌표로 바꾼 뒤 가까운 것을 찾습니다. 도서관에서 제목이 정확히 같지 않아도 주제가 비슷한 책을 추천받는 느낌입니다. Side에서는 요약된 하루 페이지에 이 방법을 쓰며, 모든 원본 이벤트를 벡터로 찾는 것은 아닙니다.

4에이전트에게 어떻게 물어보나요?

Side를 켜고 연결한 에이전트에게 평소 말하듯 물어보세요.

Side는 에이전트가 로컬 기록을 검색할 수 있게 하는 MCP(AI와 도구를 연결하는 방식) 도구를 제공합니다. Claude Code, Codex, Cursor, Grok Build, Aside 등에서 Side 도구를 각각 등록해야 사용할 수 있습니다. 앱 설치나 요약 제공자 설정만으로 자동 연결되지는 않으며, 질문할 때 Side.app이 실행 중이어야 합니다.

Aside도 Side MCP 도구와 호환되는 클라이언트입니다. Aside의 설정 → MCP에 Side 도구를 등록하면 같은 Mac에서 기록을 찾아달라고 할 수 있습니다. 기록을 다른 기기로 자동 동기화하지 않습니다.

법률 문서의 출처를 찾거나 프로젝트별 작업 시간을 되짚을 때도 사용할 수 있습니다. 판결문 인용, 날짜·금액, OCR로 읽은 숫자와 최종 청구 시간은 원문과 실제 업무 기록에서 확인하세요.

5설치하고 설정하기

소스코드를 내 Mac에서 빌드해 Applications 폴더에 넣습니다.

Side는 현재 소스코드 배포용이며 내려받아 바로 여는 사전 빌드 앱은 제공하지 않습니다. GitHub에서 소스코드를 받은 뒤 저장소 폴더의 터미널에서 아래 순서로 실행합니다. macOS 14 이상, Bun, Xcode Command Line Tools, FTS5와 확장 로딩을 지원하는 SQLite dylib가 필요합니다. 빌드 스크립트는 Homebrew의 SQLite를 찾고, 다른 위치의 파일은 SIDE_SQLITE_LIBRARY로 지정할 수 있습니다. 빌드할 때 MiniLM 모델도 앱에 넣으므로 처음에는 인터넷이 필요할 수 있습니다.

처음 시작하면 손쉬운 사용과 입력 모니터링 권한을 안내합니다. 화면 기록은 읽을 수 없는 화면에 OCR을 쓸 때 필요한 선택 권한입니다. 브라우저 자동화 (Browser Automation)는 지원 브라우저의 현재 탭 URL을 읽는 macOS 권한입니다. 이미 허용됨 (Already allowed)이면 새 승인 창은 뜨지 않습니다.

기록과 검색에는 요약 모델이 필요하지 않습니다. 요약을 원하면 API 키 제공자를 설정하거나 공식 Codex CLI에서 codex login으로 ChatGPT에 로그인한 뒤 OpenAI (Codex login)을 선택할 수 있습니다. Claude CLI는 claude auth login 뒤 Claude Code 로그인 옵션을 선택합니다. Codex 로그인이 Keychain에만 저장된 환경은 현재 지원하지 않습니다. 이는 요약 제공자 설정이며 MCP 에이전트 등록과 별개입니다. 실제 활동 요약은 해당 제공자의 “이 제공자에게 증거 전송”을 켠 뒤에만 만듭니다. CLI 로그인으로 Side 요약을 사용할 때는 각 서비스 약관과 사용량 제한을 확인하고 본인 책임으로 사용하세요.

요약 제공자는 각자 선택할 수 있습니다. 예를 들어 MiMo 2.6 Pro를 기본 제공자, MiniMax M3를 대체 제공자로 설정할 수 있습니다. 연결이 정상이더라도 개별 요약은 실패할 수 있습니다. 기록 화면이 비어 있다면 10분 구간이 끝났는지와 요약 상태를 확인해 보세요. 실패한 작업이 표시되면 연결을 확인한 뒤 실패한 요약 다시 시도와 요약 새로고침을 누르세요.

활동이 있는 10분 구간과 6시간 묶음에 요약 모델을 호출합니다. 하루 종일 켜 두면 입력 토큰이 수백만 개에 이를 수 있고, 현재 앱에는 일일 토큰 한도가 없습니다. 비용이 걱정되면 모델 제공자의 사용량을 확인하고, 사용하지 않을 때는 캡처를 일시정지하거나 이 제공자에게 증거 전송을 끄세요. 전송을 끄면 새 요약도 멈춥니다.

6보관·삭제·프라이버시

기억할 범위와 기간은 사용자가 조절합니다.

메뉴바에서 15분, 30분, 1시간 또는 직접 재개할 때까지 캡처를 일시정지할 수 있습니다. 설정의 제외 목록에는 관찰하지 않을 앱이나 웹사이트를 넣습니다. 원본 캡처의 보관 기간은 1·3·7·14·30일 중 고를 수 있고 기본값은 14일입니다. 설정에서 최근 10분, 지난 1시간, 오늘 또는 전체 기록을 삭제할 수 있습니다.

Side의 원본 데이터는 이 Mac의 ~/Library/Application Support/Side/에 있습니다. 알려진 민감 패턴을 저장 전에 가리고 원본 기록의 민감 컬럼은 암호화하지만, 규칙으로 모든 비밀을 찾아내지는 못합니다. 요약과 날짜별 페이지는 로컬 파일에 읽을 수 있는 글로 남습니다. 전체 삭제는 Side 원본·요약·색인을 지우고 암호화 키를 교체합니다. 브라우저 자체 방문 기록은 그대로이며 모델 API 키도 Mac의 Keychain에 별도로 남습니다.