반복되는 내용을 줄이세요. AI 도구를 위한 공유 메모리입니다.
저희는 AI를 활용한 일상 업무를 위한 최고의 개인 메모리를 만들겠다는 야심을 가지고 있습니다—개방적이고, 투명하며, 사용자의 통제하에 있는 것입니다.
선호 사항, 결정 사항, 그리고 어렵게 얻은 수정 내용을 단일 채팅 세션 이상에서도 유지할 수 있습니다. Bastra Recall은 이러한 정보들을 컴퓨터의 읽기 쉬운 Markdown 파일로 저장하고 연결된 AI 비서들이 사용할 수 있도록 합니다.
Recall을 활용할 수 있는 것들은 대화, 규칙, 작업, 문서 및 공유 업무에 대한 실질적인 예시를 제공합니다.
지원되는 통합 기능들은 비서들이 작업을 시작하기 전에 유용한 교훈들을 저장하고 관련 메모리들을 검색하는 데 도움을 줍니다. 사용자는 Obsidian이나 모든 텍스트 편집기를 사용하여 직접 파일들을 검사하고 수정할 수 있습니다. 자동 리콜(Automatic recall)은 클라이언트 통합 및 비서에 따라 달라지며, 모든 지침이 따르리라는 것을 보장하지는 않습니다.
CLAUDE.md나 AGENTS.md 파일은 작을 때는 잘 작동합니다. 하지만 프로젝트 작업이 매달 진행되면서 파일 길이가 길어지고, 필요한 것과 불필요한 것이 모두 세션마다 비서에게 전달됩니다. 결국 아무도 이를 유지보수하지 않게 되고, 규칙들이 다시 흐트러지기 시작합니다.
Bastra Recall은 여기서 해결책을 제시합니다:
선택적 저장, 모든 것을 아님: 각 결정과 교훈은 자체 파일로 저장됩니다. 지원되는 통합 기능들은 매번 모든 내용을 보내는 대신 작업 전에 관련 항목들만 노출시킵니다.작업하면서 성장: 비서는 작업하는 동안 새로운 결정이나 해결된 문제들을 기록할 수 있습니다. 사용자는 필요에 따라 이를 검토하고 수정하며, 모든 것을 수동으로 추가할 필요가 없습니다.여러 도구를 위한 하나의 메모리: Claude Code, Codex 및 기타 MCP(Multi-Capability Platform) 지원 도구들은 동일한 저장소(vault)를 공유하므로, 별도의 규칙 파일들을 동기화하여 유지할 필요가 없습니다.
CLAUDE.md 파일을 유지하세요. Recall은 모든 세션에 속하지 않는 지식을 추가합니다.
버전 1.0.1이 이용 가능합니다. 최신 릴리스에서 게시된 다운로드 정보를 확인하고, 변경 사항은 체인지로그(changelog)에서, 테스트된 통합 기능들은 지원 매트릭스(support matrix)에서 찾아보세요.
두 가지 질문에 답을 얻었는데, 이는 어시스턴트가 검색하도록 지시받지 않은 금고에서 나온 것입니다. 하단의 바는 Claude Code의 상태 표시줄입니다.
macOS — 안내 설정:
curl -fsSL https://bastra.io/install | bash
이 스크립트는 필요에 따라 Homebrew를 설치하고, Bastra Recall을 설치한 다음 설정을 시작합니다. 메모리를 저장할 폴더와 연결하려는 AI 클라이언트를 선택하세요. 선호한다면 실행하기 전에 설치 프로그램을 읽어보세요.
macOS 또는 Linux — Node 22+ 사용:
npx bastra-recall install
사전 전역 npm 설치가 필요하지 않습니다. 대안으로: npm install -g bastra-recall를 실행한 다음, bastra install을 실행하세요.
설정 후 AI 클라이언트를 다시 시작해야 합니다. Claude Desktop은 일회성 메모리 설정이 필요하며, Codex 사용자는 Codex 가이드에 설명된 대로 설치된 훅(hooks)을 검토하고 신뢰해야 합니다.
설정을 확인하려면 bastra doctor를 실행하고, 등록 오류는 bastra doctor --fix로 수정할 수 있습니다. 기능(features) 섹션에는 사용자에게 활성화되거나 비활성화된 Recall 기능 목록이 나열되어 있습니다 — 메모리 언어, 온보딩, 의미론적 검색(semantic recall), 훅 및 클라이언트별 스킬, 그리고 선택적 추가 기능들입니다. 각 비활성 항목 옆에는 해당 기능을 켜는 명령어가 제공됩니다. 다른 설치 방법으로는 macOS 다운로드, 소스 빌드 및 수동 구성이 있습니다.
- 어시스턴트에게 말하세요: “기억해: 이 프로젝트에 대해서는 변경 사항을 간략하게 설명하고 어떻게 확인했는지 포함해.”
- 저장된 메모리를 보여달라고 요청하여 문구를 확인할 수 있습니다.
- 새 세션을 시작하고 다음과 같이 질문하세요: “이 프로젝트에서 변경 사항을 설명하는 나의 선호도는 무엇인가요?”
동일한 금고를 사용하여 다른 연결된 클라이언트에서도 조회를 반복할 수 있습니다. 이는 도구들이 메모리를 공유한다는 것을 확인하는 간단한 방법이며, 지원되는 훅 또한 일반적인 작업 중에 관련 컨텍스트를 표면화하는 데 도움을 줍니다.
| AI 클라이언트 | 상태 | 설정 및 동작 |
|---|
| Claude Code | 테스트 완료 — 일상 사용 중 | MCP, Skill, 7개의 조용한 후크(hooks) 및 상태 표시줄 (statusline) |
| Claude Desktop | 테스트 완료 | MCP 및 메모리 안내; 첫 번째 도구 호출 시 세션 컨텍스트. macOS의 .mcpb 확장자를 포함한 설정 |
| Codex CLI | v1.0 통합 검증됨 | MCP, Skill 및 네이티브 후크(hooks). 설정 |
| Codex IDE + ChatGPT Desktop | 구현 완료; 아직 현장 테스트되지 않음 | 로컬 Codex 구성 공유. 설정 및 제한 사항 |
| Cursor | 구현 완료; 아직 현장 테스트되지 않음 | MCP 등록; bastra rules cursor로 프로젝트 규칙 추가 |
| ChatGPT Custom GPT Actions | 계획 중 | REST API와 시작 스키마가 존재함; 패키징된 통합은 아직 준비되지 않았습니다. 진행 상황 추적 |
다른 MCP 클라이언트는 포워더(forwarder)를 통해 연결할 수 있지만, 테스트되지 않았습니다. 스크립트 및 기타 통합은 REST API를 사용할 수 있습니다. MCP는 AI 비서가 이러한 메모리 서비스와 같은 외부 도구를 사용하도록 하는 프로토콜입니다.
| 플랫폼 | 상태 | 가용성 |
|---|
| macOS (Apple Silicon 및 Intel) | 지원됨 | Homebrew 및 npm 설치, bastra autostart, Claude Desktop .mcpb 확장자 (릴리스 빌드는 npm과 같이 검증된 컴파일된 후크 클라이언트 매니페스트를 포함함; 클라이언트 자체는 옵트인한 후에만 다운로드됨), open_document 및 컴파일된 후크 클라이언트 |
| Linux (x86_64 및 arm64) | 데몬, CLI, MCP 및 후크(hooks) | npm으로 설치; 컴파일된 후크 클라이언트 사용 가능. Homebrew 설치 경로는 없으며, macOS LaunchAgent (bastra autostart), .mcpb 확장자 설치 또는 open_document가 없음. 포워더는 온디맨드(on demand)로 데몬을 시작합니다. |
| Windows | 지원 안 함 | 컴파일된 후크 클라이언트 없음; 테스트되지 않음 |
월요일에 결정된 프로젝트도 AI 도구를 전환하더라도 목요일에는 여전히 사용 가능해야 합니다. Bastra Recall은 이러한 도구들이 참고할 공유 장소를 제공합니다.
유용한 컨텍스트 유지: 선호도, 결정 사항, 프로젝트 사실 및 해결된 문제의 교훈을 기억합니다.작업 전 회상(Recall): 지원되는 훅은 세션 시작 시점과 작업 전에 컨텍스트를 노출하며, 공유 Skill이 어시스턴트 자체 검색을 안내하고 저장합니다.파일 소유: 메모리는 구조화된 메타데이터가 포함된 일반 Markdown 파일이며, Bastra 외부에서도 읽고 편집할 수 있습니다.기억된 것 확인: bastra map은 로컬 볼트 맵을 열어 탐색, 검색 및 메모리 관리를 할 수 있게 합니다.한 주간의 작업 예시는 이들이 어떻게 함께 작동하는지 보여줍니다.실험적이며 선택 사항이며, bastra code enable로 리포지토리별로 활성화해야 합니다.Recall은 파일을 편집하기 전에 어시스턴트에게 어떤 다른 파일이 해당 파일을 가져오거나 호출하는지 알려주고, 심볼을 grep으로 찾는 대신 이름으로 찾을 수 있는 find_code 조회를 추가합니다. 코드 맵은 Graphify에 의해 로컬로 구축되며, 코드를만 읽고, 절대 커밋되지 않으며, 어떤 언어 모델도 소스 코드를 볼 수 없습니다. 이는 에이전트가 생소하거나 큰 리포지토리에서 길을 찾는 데 도움을 줄 수 있습니다.
어떤 모델을 사용하는지 명시합니다. OpenAI 임베딩을 선택하면 쿼리와 인덱싱된 메모리 텍스트가 OpenAI로 전송됩니다. 개인 정보 보호 및 네트워크 사용은 이러한 경로, 파일 동기화 및 선택적 네트워크 기능을 설명합니다.
iCloud, Google Drive 또는 Dropbox에 있는 볼트는 해당 서비스의 동기화를 사용합니다. 여러 컴퓨터에서 동시에 편집할 경우, Bastra의 자동 메타데이터 업데이트와 마찬가지로 충돌이 발생할 수 있습니다. Bastra는 관리되는 다중 장치 동기화를 제공하지 않습니다. 백업을 유지하고 파일을 덮어쓰기 전에 충돌하는 사본을 확인하십시오.
만약 ~/.bastra/vault-roots.json에 기록된 볼트 루트가 나중에 사라지거나(예: 드라이브가 마운트되지 않은 경우), /health 및 리콜 보고서에 vault_missing이 표시되고, 작성기가 이를 빈 폴더로 다시 생성하기를 거부하는 경우. 완전히 새로운 경로는 첫 번째 저장 시 여전히 생성되지만, 깊이는 한 단계만 가능합니다: 부모 폴더가 이미 존재해야 합니다. 만약 부모 폴더마저 누락된 경우(일반적으로 마운트되지 않은 드라이브의 경우), 해당 부모를 명명하는 오류와 함께 저장이 중단됩니다. 먼저 드라이브를 마운트하거나 부모 폴더를 생성하십시오. bastra install --vault <path> 및 설정 마법사는 예외입니다: 그곳에서 경로를 지정하므로 누락된 부모 폴더를 자체적으로 생성합니다. Bastra가 한 번도 본 적 없는 장치에서는 새로운 볼트를 부모 폴더가 존재하는 마운트되지 않은 드라이브와 완전히 구별할 수 없으므로, 첫 번째 저장 전에 마운트를 확인하십시오. 만약 ~/.bastra/vault-roots.json이 비어 있거나 손상되었거나, 또는 ~/.bastra가 쓰기 가능하지 않다면, 모든 볼트 쓰기는 파일을 명명하는 오류와 함께 중단됩니다: 볼트가 마운트된 경우, 해당 파일을 삭제하십시오(다음 저장 시 다시 작성됨); 그렇지 않은 경우 ~/.bastra의 권한을 수정하십시오. 만약 의도적으로 볼트를 이동하거나 삭제했다면, 폴더를 다시 생성하거나 Bastra에 새 경로를 지정하십시오.
- 기존 메모 임포트 — 목록(lists), 채팅 내보내기(chat exports), 규칙(rules) 및 메모 폴더를 가져옵니다. 폴더 임포트는 별도의 수집 영역으로 직접 이동하며, 다른 경로는 검토를 위한 후보들을 준비합니다.
- 볼트 맵(Vault map) — 메모를 탐색하고, 검색하고, 관리 대상으로 표시하세요.
- 업데이트 —
bastra update로 업데이트하거나 자동 업데이트에 참여할 수 있습니다. - 제품 문서(Product docs) — 어시스턴트가 프로젝트의 사용자 가이드를 유지하도록 하세요.
- Bastra Commons — 검증 기록이 포함된 선택적 커뮤니티 레시피입니다.
- 사용법 및 문제 해결 · 메모 형식 · 아키텍처 · 훅(Hooks) · 아카이빙(
rm) 및 git 스냅샷 · 저장 및 호출 트리거 · 분류학(Taxonomy) · 가치(Valence) 및 반사(reflex)
Version 1.0은 측정된 회상 품질(measured recall quality), 관련 세션 컨텍스트(relevant session context) 및 메모 사용에 대한 명확한 제어에 중점을 둡니다. 누적 세션 컨텍스트 예산은 섀도우 모드(shadow mode)로 측정되고 있으며, 아직 실시간 세션 전체 제한을 강제하지는 않습니다. 로드맵과 출시 경계.
네이티브 Bastra Mac 앱이 개발 중입니다. 오픈 소스 패키지는 이미 로컬 브라우저 기반 볼트 맵을 포함하고 있으며 해당 앱과는 독립적으로 작동합니다.
MIT — LICENSE를 참조하세요. 상태 표시줄에는 유지된 MIT 라이선스가 적용된 owloops/claude-powerline이 포함되어 있습니다. 선택적 코드 인식 기능은 Recall이 번들링하지 않는 별도의 프로젝트인 Graphify(Apache-2.0)를 사용합니다. 이 기능은 PyPI에서 활성화할 때만 설치됩니다.
질문하기 · 버그 신고 · 기여하기 · 프로젝트 지원. 취약점은 SECURITY.md를 통해 비공개로 보고하세요.
Daniel / @n0mad-ai가 구축했습니다.
반복을 줄이다. 당신의 AI 도구를 위한 공동 메모리.
우리는 개방적이고, 추적 가능하며, 사용자의 통제 하에 일상적인 AI 작업에 가장 좋은 개인 메모리를 만드는 것을 목표로 합니다.
여러 채팅에 걸쳐 선호도, 결정 및 개발된 솔루션을 보존하세요. Bastra Recall은 이를 읽을 수 있는 Markdown 파일 형태로 사용자 컴퓨터에 저장하고 연결된 AI 어시스턴트가 접근할 수 있도록 만듭니다.
Recall을 활용할 수 있는 용도를 대화, 규칙, 작업, 문서 및 공동 작업을 위한 예시로 보여줍니다.
지원되는 통합 기능은 어시스턴트가 중요한 통찰력을 저장하고 새로운 작업 전에 관련 기억을 검색하도록 돕습니다. Obsidian이나 모든 텍스트 편집기로 직접 파일을 확인하고 편집할 수 있습니다. 자동 검색은 통합 기능과 어시스턴트에 따라 다르므로, 모든 지침이 따를 것이라고 보장하지는 않습니다.
CLAUDE.md나 AGENTS.md 파일은 작을 때는 잘 작동하지만, 프로젝트 작업이 매달 진행되면서 점점 길어지고, 어시스턴트는 필요하든 아니든 매 세션마다 모든 것을 받게 됩니다. 어느 순간 아무도 이를 관리하지 않게 되고, 규칙들이 다시 분산됩니다.
Bastra Recall은 바로 이 지점에서 시작합니다:
선택적 접근 대신 전체: 모든 결정과 배움이 개별 파일로 존재합니다. 지원되는 통합 기능은 작업 전에 적절한 항목만 표시하여 매번 모든 것을 전송할 필요가 없습니다.성장하며 함께함: 어시스턴트는 작업하는 동안 새로운 결정이나 해결된 문제를 스스로 기록할 수 있습니다. 필요한 경우 직접 확인하고 수정할 수 있어, 모든 것을 수동으로 추가할 필요가 없습니다.여러 도구를 위한 기억력: Claude Code, Codex 및 기타 MCP(Multi-Capability Platform) 지원 도구는 별도의 규칙 파일을 비교할 필요 없이 동일한 Vault에 접근합니다.
당신의 CLAUDE.md는 그대로 유지될 수 있습니다. Recall은 모든 세션에 속해야 하는 지식을 제외한 나머지 지식을 보완해 줍니다.
버전 1.0.1이 사용 가능합니다. 공개된 다운로드는 현재 릴리스에서, 변경 사항은 Changelog에서, 테스트된 통합 기능은 Support-Matrix에서 확인할 수 있습니다.