"docs/report.md에 보고서를 저장했습니다."
declared by model
LOCAL-FIRST CONTINUITY FOR AI AGENTS
세션을 넘어
작업이 이어집니다
Kontexus는 에이전트의 태스크, 결정, 대화, 체크포인트와 판단의 마지막 경계를 프로젝트 안에 남깁니다. 다음 세션은 기억을 추측하지 않고, 기록된 상태에서 다시 시작합니다.
MCP / 29 TOOLS
CLI + WEB
RUST / 5 CRATES
FILE-FIRST
SESSION 01
Context exhausted
conversation closed
SESSION 02
State recovered
T30.1 · active
PROJECT STATE
.workgraph/
Tasks · Notes · Chat · FTM
The session resets. The work does not.
ACTIVE TASK
T30.1
bound to main
LAST VERDICT
CONFIRMED
server observed
01 - THE GAP
채팅에 남아있는 대화 기록이 사라져도
힘들게 다시 시작할 필요가 없습니다
컨텍스트 창은 닫히고, 세션은 중단되며, 에이전트는 다시 시작됩니다. 그때 사라지는 것은 대화만이 아닙니다.
무엇을 왜 결정했는지, 현재 작업의 경계가 어디인지, 어떤 Effect가 이미 실행되었는지, 다음 세션이 어디서 이어야 하는지가 함께 사라집니다.
Kontexus는 그 상태를 세션 밖, 프로젝트 안에 둡니다.
WITHOUT KONTEXUS
Session
lost
Session
lost
Session
WITH KONTEXUS
Session
state
Session
state
Session
02 - CLAIM / OBSERVATION
AGENT의 거짓말은
드러납니다
에이전트가 제시한 evidence는 에이전트의 진술로
남습니다. serverEvidence는 서버가 직접 만들며,
에이전트가 제공하거나 덮어쓸 수 없습니다.
KONTEXUS / TURN CLOSURE
SERVER-OWNED OBSERVATION
target exists: docs/report.md
file · 4,210 bytes · modified 04:41:12
03 - DURABLE RECORDS
유용한 기록방식,
네 가지 형식을 지원합니다
대화를 무작정 쌓는 대신, 서로 다른 역할을 가진 상태를 분리해 보존합니다. 안정적인 식별자로 직접 지목하고 검색은 보조로 사용합니다.
TASK / TURN
무엇을 하기로 했고, 의미 경계마다 어디까지 왔는지.
tasks/T27/task.md
CHECKPOINT / TRACK
사람이 확정한 작업의 이력과 병렬 작업의 계보.
checkpoints/C16/
NOTE
태스크 밖에서도 살아남아야 할 결정, 규칙, 예외와 주의.
notes/2,mym,1.md
CHAT
결정에 이른 대화를 수집하고 태스크의 시간축과 연결.
session_chat
FTM SEAM
세션이 끊긴 순간의 다음 상태와 아직 실행하지 않은 Effect.
nextInputState
NOT A TRANSCRIPT ARCHIVE. A WORKING MODEL OF THE PROJECT.
04 - ONE PROJECT TRUTH
기록은 항상 재구성 가능합니다
프로젝트 기록은 사람이 읽고 편집할 수 있는 파일에 남습니다. SQLite는 파일에서 다시 만들 수 있는 검색 색인이며, 판단 seam과 알림 큐만 별도로 유지합니다.
AI AGENTS
Codex
Claude Code
Gemini
OpenCode
MCP · 29 tools
CANONICAL PROJECT STATE
.workgraph/
tasks/
notes/
checkpoints/
chats/
human-readable files + derived index
HUMAN OPERATORS
CLI / TUI
Web Dashboard
$EDITOR
Git
inspect · edit · confirm
HUMAN-READABLE
GIT-FRIENDLY
REBUILDABLE INDEX
NO VECTOR DB REQUIRED
05 - OPERATOR SURFACE
AGENT가 사용하는 토큰 소비를 최대한 줄였습니다
MCP가 쓰는 값과 CLI·TUI·웹 대시보드가 보여주는 값은 분리된 사본이 아닙니다. 같은 저장소, 같은 응답 형식 위에서 움직입니다.
TASK GRAPH
작업의 현재 위치
루트 Task와 Turn, 활성·등록·확정 상태를 한 화면에서 읽습니다.
ACTUAL PRODUCT OUTPUT
1 / 3
06 - AGENT LOOP
Harness Loop 에서
기억을 담당합니다
루프는 다시 시작될 수 있습니다. 작업까지 초기화될 필요는 없습니다.
-
01
RECOVER
활성 태스크, 최근 checkpoint, 알림과 미완 판단을 불러옵니다.
check_kontexus_updates -
02
BIND
식별자를 발급하고 기록을 만든 뒤 현재 작업에 결속합니다.
set_active_task -
03
WORK
판단, Effect, invariant와 미결 질문을 분리해 진행합니다.
structure_reasoning -
04
OBSERVE
실행 결과와 서버가 직접 관측한 사실을 대조합니다.
record_effect_outcome -
05
CONTINUE
다음 세션이 이어받을 마지막 상태 경계를 남깁니다.
get_ftm_continuation -
06
CONFIRM
사람이 stage된 작업을 확인하고 이력으로 확정합니다.
task checkpoint
08 - ENGINEERED FOUNDATION
프롬프트나 규약으로 제어하는 대신
AGENT가 듣지 않을 수 없게 만들었습니다
결정론적인 상태 변화와 IO 경계를 분리한 Rust 워크스페이스. 사람과 에이전트가 함께 쓰는 기록 계층을 배포 가능한 두 바이너리로 묶었습니다.
RUNTIMERust 1.96+edition 2021
ARCHITECTURE5 cratespure core / IO boundary
DISTRIBUTION2 binariesstatically linked sqlite
MCP SURFACE29 toolsstdio server
REASONINGState × Input → State'content-addressed
RIGOR3 levelsstandard / verified / strict
kontexus-core
+
kontexus-ftm
→
kontexus-store
→
mcp / cli
09 - START HERE
프로젝트 마다 쌓이는 귀중한 정보,
이제는 Kontexus로 관리하세요
사람이 읽고, 에이전트가 이어받으며, 관측된 사실이 주장을 반박할 수 있는 상태를 프로젝트 안에 두십시오.
kontexus-cli init
VERSION v1.0.0 SCHEMA workgraph-memory/v3.1.0 LOCAL-FIRST · MCP-NATIVE
LICENSE — 사용 조건
학원과 기업에서 무료로 쓰실 수 있습니다.
교육 과정에서, 사내 개발에서 인원 수와 무관하게 쓰십시오. 별도 허락을 받지 않아도 됩니다.
유료 제품·서비스에 포함하는 것은 허락하지 않습니다.
판매하는 제품이나 과금하는 서비스에 이 도구를 넣어 재배포·재판매할 수 없습니다. 이름을 바꾸어 넣는 것도 같습니다.
기능 수정·추가·맞춤 제작이 필요하시면 연락 주십시오.
Gmail — ID andrwj