[!TIP] 처음 오셨나요? 빠른 시작을 통해
npm install부터 첫 번째 지속적 에이전트 세션까지 약 60초 만에 완료할 수 있습니다.
Waypath는 코딩 에이전트와 1인 개발자를 위한 로컬 우선 지식 엔진입니다. 프로젝트 결정 사항, 엔티티 관계 및 세션 아티팩트를 단일 SQLite 파일에 저장하고, 가벼운 CLI를 통해 Claude Code, Codex 또는 MCP 클라이언트와 같은 모든 에이전트 호스트에 그래프 인식형, 진실 우선 컨텍스트를 제공합니다.
클라우드 메모리 서비스와 달리 Waypath는 다음과 같은 특징이 있습니다:
완전히 로컬 환경에서 실행됩니다.
벡터 블롭 대신 **표준 진실 스키마(canonical truth schema)**를 소유합니다.
명시적 승격 + 검토 게이트를 통해 모든 메모리를 일급 객체로 취급합니다.
필수 런타임 서비스 없이 77kB의 npm 패키지로 제공됩니다.
Related MCP server: ClaudeX
문제 | Waypath의 해결책 |
에이전트가 세션 간 기억을 잊음 | 지속적인 SQLite 진실 커널 |
RAG가 관련 없는 청크를 반환함 | 그래프 확장을 포함한 FTS5 + RRF 하이브리드 랭킹 |
메모리 서비스가 조용히 환각을 일으킴 | 명시적 |
클라우드 종속성, 데이터 유출 | 모든 것이 사용자가 소유한 하나의 로컬 |
호스트별 도구 (Claude, Codex, Cursor) | 단일 파사드, 가벼운 호스트 심(shim), 네이티브 MCP 서버 |
[!IMPORTANT] Node.js ≥ 22가 필요합니다. Node 22.5+는 네이티브
node:sqlite드라이버를 활성화하며, 이전 22.x 버전은 자동으로better-sqlite3로 대체됩니다.
npm install -g waypath확인:
waypath --help
waypath source-status --json1. 세션 부트스트랩 (Codex 예시):
waypath codex --json \
--project my-project \
--objective "ship v2 of the retrieval pipeline" \
--task "refactor hybrid ranker" \
--store-path ~/.waypath/my-project.db2. 관련 컨텍스트 회상:
waypath recall --query "hybrid ranker decisions" --json3. 추출된 통찰력을 캡처하고 검토를 통해 승격:
waypath page --subject "hybrid ranker v2 design"
waypath promote --subject "hybrid ranker v2 design"
waypath review-queue --json4. MCP 서버로 실행 (Claude Code, Cursor, 모든 MCP 클라이언트용):
waypath mcp-server --store-path ~/.waypath/my-project.db$ waypath codex --json --project auth-service \
--objective "migrate to passkeys" --task "design flow"
{
"host": "codex",
"session_id": "auth-service:passkey-flow",
"context_pack": {
"truth_highlights": {
"decisions": [
"Use WebAuthn level 2 with user verification required",
"Argon2id for password fallback hashing"
],
"entities": ["UserSession", "AuthGateway", "RefreshToken"],
"contradictions": []
},
"recent_pages": [
"Session storage design — promoted 2026-04-12"
]
}
}영역 | 명령어 |
세션 부트스트랩 |
|
회상 |
|
페이지 (추출된 지식) |
|
검토 거버넌스 |
|
가져오기 / 스캔 |
|
상태 |
|
유지보수 |
|
전체 도움말: waypath --help.
Waypath는 가벼운 파사드 뒤에 4개의 독립적인 커널로 구축되었습니다:
flowchart TD
subgraph HOST[" Host Shims "]
direction LR
CX["codex"]
CC["claude-code"]
MC["mcp-server"]
end
Facade["<b>Facade</b><br/><code>createFacade()</code>"]
TK["<b>Truth Kernel</b><br/>decisions · entities · preferences<br/>temporal validity · supersede"]
AK["<b>Archive Kernel</b><br/>evidence · content-hash dedup<br/>FTS5 index"]
ON["<b>Ontology</b><br/>graph traversal<br/>pattern expansion"]
PR["<b>Promotion Engine</b><br/>candidate review<br/>contradiction detection"]
HOST --> Facade
Facade --> TK
Facade --> AK
Facade --> ON
Facade --> PR
classDef kernel fill:#21262d,color:#c9d1d9,stroke:#30363d,stroke-width:1px
classDef facade fill:#1f6feb,color:#ffffff,stroke:#58a6ff,stroke-width:2px
classDef host fill:#161b22,color:#c9d1d9,stroke:#30363d,stroke-width:1px
class TK,AK,ON,PR kernel
class Facade facade
class CX,CC,MC host진실 커널(Truth kernel) — 표준 결정, 엔티티, 선호도, 시간적 유효성 (supersede + history를 포함한 스키마 v3).
아카이브 커널(Archive kernel) — 콘텐츠 해시 중복 제거 및 FTS5 전문 검색 인덱스를 갖춘 원시 증거 저장소.
온톨로지 계층(Ontology layer) — 엔티티/결정 컨텍스트 확장을 위한 그래프 탐색 (패턴: project_context, person_context, system_reasoning, contradiction_lookup).
승격 엔진(Promotion engine) — 후보 검토, 모순 탐지, 대체 흐름.
단일 createFacade()가 14개의 동사를 노출합니다. 호스트 심(shim)은 이를 각 에이전트의 부트스트랩 프로토콜에 맞게 조정합니다.
Waypath는 기본적으로 설정이 필요 없습니다. 검색 가중치, 어댑터 토글 또는 검토 임계값을 조정하려면 작업 디렉토리에 config.toml을 배치하거나 WAYPATH_CONFIG_PATH를 해당 파일로 지정하세요:
[source_adapters]
jarvis-memory-db = true
jarvis-brain-db = false
[retrieval.source_system_weights]
truth-kernel = 1.2
[retrieval.source_kind_weights]
decision = 0.9
memory = 0.5
[review_queue]
limit = 12환경 변수를 통해 무엇이든 재정의할 수 있습니다:
export WAYPATH_RECALL_WEIGHT_SOURCE_SYSTEM_TRUTH_KERNEL=1.8
export WAYPATH_REVIEW_QUEUE_LIMIT=8우선순위: 환경 변수 재정의 > config.toml > 내장 기본값.
Waypath는 두 번째 바이너리로 네이티브 MCP(Model Context Protocol) 서버를 제공합니다:
waypath-mcp-server또는 메인 CLI를 통해 실행:
waypath mcp-server --store-path ~/.waypath/project.dbMCP를 통해 노출되는 도구: recall, page, promote, review, graph-query, source-status.
Node.js ≥ 22.0 (필수)
Node.js ≥ 22.5 권장 — 네이티브 node:sqlite 활성화
better-sqlite3는 22.0–22.4 버전 또는 네이티브 sqlite를 사용할 수 없는 경우 자동으로 사용되는 선택적 대체 라이브러리입니다.
버전: 0.1.0 — 첫 번째 공개 릴리스
테스트: 131개 통과 (단위 + 통합 + 벤치마크)
안정적인 인터페이스: CLI (26개 명령어), MCP 서버, 파사드 API
보류 중: 호스팅 배포, 다중 사용자 동기화, 적응형 랭킹 피드백
Waypath | 클라우드 메모리 (mem0, zep) | 벡터 전용 RAG | |
로컬 우선 | ✓ | ✗ | 상황에 따라 다름 |
표준 진실 스키마 | ✓ | ✗ | ✗ |
그래프 인식 회상 | ✓ | 부분적 | ✗ |
명시적 검토 게이트 | ✓ | ✗ | ✗ |
MCP 서버 내장 | ✓ | ✗ | ✗ |
원파일 설치 | ✓ | 서비스 필요 | 다양함 |
Waypath는 호스트 심(shim), 소스 어댑터 및 버그 수정을 환영합니다. 좋은 첫 번째 이슈는 해당 라벨이 지정되어 있습니다.
개발 환경 설정, 코드 스타일 및 PR 흐름은 **CONTRIBUTING.md**를 읽어보세요.
PR을 제출하기 전:
npm run build
npm testMIT © TheStack.ai — LICENSE를 참조하세요.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
Hosted MCP memory: save sessions/decisions once, search from Claude, Cursor, ChatGPT. EU-hosted FTS.
The project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/TheStack-ai/waypath'
If you have feedback or need assistance with the MCP directory API, please join our Discord server