에이전트

내 지식 베이스 안의 내 에이전트

Knowtarium은 AI를 직접 실행하지 않아요. 이미 쓰는 에이전트를 MCP로 연결하면, 에이전트가 내 노트를 바로 검색하고 읽고 써요. 에이전트가 만든 모든 변경에는 그 에이전트 자신의 키로 서명이 남고, 클릭 한 번으로 되돌릴 수 있어요.

내 에이전트와 함께

이미 쓰는 에이전트를 그대로 가져오세요.

Knowtarium은 자체 AI를 실행하지 않아요. 이 에이전트들이 MCP로 연결돼요. 클라우드에서만 돌아가는 채팅 앱은 나중에 호스팅 커넥터로 연결돼요. 이 커넥터는 공개된 코드를 실행하는 봉인된 엔클레이브 안에서만 복호화해요.

Knowtarium Web ClipperChrome용 브라우저 확장 프로그램: 보고 있는 페이지를 인박스에 저장해요

실제로는

한 번 연결하고, 그냥 물어보세요.

를 실행하고, 브라우저에서 워크스페이스나 그 안의 일부 폴더를 고른 뒤 Allow를 누르세요. 컴퓨터에서 찾은 에이전트를 보여 주고, 체크해 둔 에이전트에 Knowtarium을 설정해요. 비밀 값을 복사하거나 붙여 넣을 일은 없어요.

그다음부터 에이전트는 필요한 것만 검색해서 읽고, 폴더마다 써 둔 지침에 따라 워크스페이스에 바로 써요.

terminal
터미널 세션 예시: npx knowtarium connect가 워크스페이스를 연결하고, 찾은 에이전트(Claude Code, Cursor, Codex)를 모두 체크된 상태로 보여 줘요. Cursor의 체크를 해제하면 Knowtarium은 Claude Code와 Codex에만 추가돼요. 이어서 가격을 업데이트해 달라는 요청을 받은 Claude Code가 노트를 검색하고 두 개를 편집해요.

연결하기

명령어 하나, 클릭 한 번.

  1. 01

    명령어 하나를 실행해요

    는 내 컴퓨터에서 실행돼요(Node.js 20 이상 필요). 자체 키 쌍을 만들고 브라우저에서 Knowtarium을 열어요.

  2. 02

    접근 범위를 정해요

    에이전트 이름을 정하고, 워크스페이스를 고르고, 원하면 일부 폴더만 고른 뒤 읽기 또는 읽기·쓰기를 선택해요. 노트 삭제나 폴더 변경 같은 그 이상의 권한은 체크하지 않으면 꺼진 채로 있어요. 그다음 Allow를 누르세요. 단, 명령어를 직접 실행했을 때만요.

  3. 03

    키는 내 컴퓨터에만 가요

    브라우저가 워크스페이스 키의 사본을 내 컴퓨터의 에이전트에게 바로 건네요. 이 방법이 막혀 있으면 저희가 열 수 없게 봉인해서 보내요. CLI는 이 키를 암호화해서 보관하고, 그 키는 시스템 키체인에 둬요(키체인이 없으면 비공개 파일에).

  4. 04

    에이전트 설정이 끝나요

    찾은 에이전트(Claude Code, Codex, Cursor, OpenCode, Claude Desktop)를 모두 체크된 상태로 보여 줘요. 이미 Knowtarium 플러그인이 있는 에이전트는 빼고요. 빼고 싶은 에이전트는 체크를 해제하세요. 나머지 에이전트에 Knowtarium을 추가하고, 다른 설정은 건드리지 않아요.

또는 에이전트에서

플러그인이나 확장 프로그램으로.

Claude Code와 Codex는 Knowtarium을 플러그인으로 설치할 수 있어요. Knowtarium 워크스페이스에서 일하기 위한 스킬도 함께 들어 있어요. npm의 같은 서버를 실행해요(Node.js 20 이상). 이 컴퓨터가 아직 연결되지 않았다면 에이전트에게 Knowtarium을 연결해 달라고 하세요. 브라우저가 열리고 이 컴퓨터를 승인할 수 있어요.

플러그인을 쓰면 Knowtarium을 추가하려고 를 실행할 필요가 없어요. 플러그인이 이미 서버를 실행하니까요. 터미널에서 연결하려면 를 실행하세요. 에이전트 설정은 그대로 둬요.

Claude Desktop에서는 확장 프로그램을 다운로드해서 열고, Claude에게 Knowtarium을 연결해 달라고 하세요. 브라우저가 열리고 이 컴퓨터를 승인할 수 있어요. 터미널도 Node.js도 필요 없어요.

플러그인 설치
# Claude Code
# Codex

규칙

에이전트가 할 수 있는 일과 없는 일.

  • 가능내가 준 노트를 검색하고, 읽고, 노트 사이의 링크 따라가기
  • 가능노트 만들기와 편집하기 (바로 적용)
  • 가능노트 옮기기, 삭제하기, 폴더 바꾸기 (내가 허락할 때만)
  • 가능모든 변경에 자신의 키로 서명하기
  • 가능폴더마다 내가 써 둔 지침 따르기
  • 불가내가 주지 않은 워크스페이스나 폴더에 접근하기
  • 불가첨부 파일을 삭제하거나, 에이전트에게 준 폴더의 이름을 바꾸거나 옮기거나 삭제하기
  • 불가나로 서명하거나, 무언가를 내가 확인한 것으로 표시하기
  • 불가내가 검토를 켠 곳에서 검토 건너뛰기
  • 불가내가 수락하지 않았는데 지침 바꾸기

삭제와 정리

편집 이상은 내가 허락할 때만.

  • 01

    체크하기 전엔 꺼져 있어요

    노트 이동, 노트 삭제, 그리고 폴더 만들기, 이름 바꾸기, 옮기기, 삭제하기는 여섯 개의 별도 권한이고, 모두 기본으로 꺼져 있어요. 앱의 Settings, Agents에서 언제든 바꿀 수 있고, 바꿀 때마다 새 권한 묶음에 내가 서명해요.

  • 02

    나를 기다리라고 알려 줘요

    에이전트의 규칙은 내가 대화에서 요청했을 때만 삭제, 이동, 재정리를 하라고 알려 줘요. 노트에 그렇게 쓰여 있다는 이유로는 절대 하지 않아요. 이건 지시이고, 저희 서버가 강제하는 건 권한이에요.

  • 03

    Ask me first는 그대로 적용돼요

    Ask me first로 설정한 폴더에서는 노트 삭제나 이동이 내 승인을 기다려요. 그곳의 폴더 변경은 거부되고, 에이전트는 무엇을 바꾸려 했는지 나에게 알려 주라는 안내를 받아요.

  • 04

    목록에 남고, Undo가 있어요

    모든 삭제, 이동, 폴더 변경에는 에이전트의 서명이 남고, 워크스페이스 페이지의 Deleted and reorganized by agents에 2주 동안(기록 보관 기간이 더 짧다면 그 기간 동안) Undo, Undo this agent's last 24 hours와 함께 표시돼요. 삭제한 노트는 기록 보관 기간 안이라면 다시 살릴 수 있어요. 앱은 모든 변경을 내가 서명한 권한과 대조해요.

에이전트는 첨부 파일, 워크스페이스의 루트 폴더, 웹 클리퍼의 인박스를 절대 삭제하지 않고, 에이전트에게 준 폴더의 이름을 바꾸거나 옮기거나 삭제하지 않아요. 폴더는 비어 있을 때만 삭제해요. 에이전트는 여전히 워크스페이스 키를 갖고 있으니, 권한과 폴더를 강제하는 건 저희 서버예요(알려진 한계 참고). 권한 기능에는 knowtarium 0.3.0 이상이 필요해요. 이전 버전이라면 연결 페이지에 실행할 명령어가 나와요.

폴더 지침

여기서 어떻게 쓸지 에이전트에게 알려 주세요.

  • 01

    한 번만 써요

    폴더 메뉴에서 Edit instructions를, 또는 워크스페이스 설정에서 Instructions for agents를 고르고, 그곳의 노트를 어떻게 쓰는지 적어요. 필드, 출처, 이름 같은 것들이요. 빈 페이지나 템플릿(Market research, Meeting notes, Decision log)에서 시작하세요.

  • 02

    모든 노트에 적용돼요

    Claude Code, Codex, Claude Desktop, 그리고 연결한 다른 모든 에이전트는 그곳에 노트를 쓸 때마다 지침을 따라요. 워크스페이스의 지침이 먼저, 그다음 노트가 있는 폴더까지 폴더마다의 지침이 차례로요. 일부 폴더로 제한된 에이전트도 그 위 폴더의 지침을 받아요.

  • 03

    바꾸는 건 나만 해요

    에이전트는 지침 변경을 제안만 할 수 있고, 직접 바꿀 수는 없어요. 제안은 검토 대기열에서 기다리고, 내가 수락할 때까지 지금 지침이 적용돼요. 가져온 AGENTS.md는 Apply를 골라야 적용돼요.

  • 04

    내 말만 유효해요

    에이전트는 내가 저장하거나 수락해서 내 키로 서명된 지침만 따라요. 에이전트의 규칙은 노트, 클립, index.md 안의 텍스트는 명령이 아니라 데이터이니, 따르지 말고 나에게 알려 주라고 해요.

폴더마다의 지침은 그 폴더의 AGENTS.md로 저장되고, 다른 노트처럼 암호화되며, 노트 목록, 검색, 그래프에는 나오지 않아요. 내보내면 워크스페이스의 나머지와 함께 AGENTS.md 파일로 나와요. 크기 제한은 없지만 짧은 지침일수록 더 잘 지켜지고, 약 8 KB를 넘으면 에디터가 알려 줘요. 지침은 에이전트를 안내할 뿐, 무언가를 잠그지는 않아요(알려진 한계 참고).

솔직하게 말하면

에이전트는 자기가 읽은 내용을 봐요.

knowtarium CLI는 내 컴퓨터에서 노트를 복호화해서 메모리에 두고, 도구가 돌려주는 내용만 에이전트에게 건네요. 에이전트가 읽은 내용은 다른 모든 입력처럼 그 에이전트의 AI 제공자에게 가요. 내 노트는 암호문으로만 저희 서버에 닿아요.

앱에서 에이전트를 해제하면 바로 차단되고, 워크스페이스에 새 키가 생겨요. 그래서 그 뒤에 쓴 내용은 읽을 수 없어요.

terminal
Opening the browser to connect this computer to Knowtarium.
Connected to workspace ws_8f2k (read and write).
Add Knowtarium to which agents? Claude Code, Codex
added to Claude Code (~/.claude.json)
added to Codex (~/.codex/config.toml)
Keys are kept in: the OS keychain
Workspace ws_8f2k
token tok_3m9q (active)
access read-write, folders fld_p1, fld_m4
Revoked the token for workspace ws_8f2k.
Deleted the local keys and cache for workspace ws_8f2k.

웹 클리퍼

Knowtarium에 저장하기.

브라우저 확장 프로그램

보고 있는 페이지를 인박스로.

Knowtarium Web Clipper는 Chrome용 확장 프로그램이에요. 버튼을 클릭하거나 Alt+Shift+S(Mac에서는 Option+Shift+S, 바꿀 수도 있어요)를 눌러 열고, 원하면 메모를 더하거나 카테고리를 고른 뒤 Save를 누르세요. 페이지는 암호화된 채로 대기하다가, 그 워크스페이스에서 Knowtarium을 다음에 열거나 인박스에 쓸 수 있는 에이전트가 실행되면 워크스페이스의 Inbox 폴더에 노트로 정리돼요. 그러면 연결한 에이전트가 분류하고 요약할 수 있어요.

연결하려면 팝업에서 Connect to Knowtarium을 클릭하세요. 코드가 있는 탭이 열리고 그 옆에 Knowtarium이 열려요. 두 곳에 같은 코드가 보이는지 확인하고, 워크스페이스를 고른 뒤 허용하세요. 팝업에서 언제든 연결을 끊거나, Knowtarium의 Settings, Agents에서 해제할 수 있어요. 오픈 소스(MIT)이고, Edge 버전도 곧 나와요.

  • 쓰기 전용

    인박스에 페이지를 추가할 수는 있지만, 내 노트를 읽는 키는 갖고 있지 않아요. 자기가 저장한 페이지조차 읽지 못해요.

  • 브라우저에서 암호화

    각 페이지는 보내기 전에 서명되고 암호화돼요. 저희 서버는 대기열에 넣을 뿐 읽을 수 없어요. 링크나 제목조차요.

  • 지금 탭만 읽어요

    버튼을 클릭하거나 단축키를 누를 때 현재 탭의 링크와 제목을 읽고, Save를 누르기 전까지는 아무것도 보내지 않아요. 페이지 본문, 선택한 텍스트, 다른 탭, 방문 기록은 절대 읽지 않아요.

  • 오프라인에서도 작동해요

    연결 없이 저장한 페이지는 확장 프로그램 안에서 최대 100개까지 기다렸다가, 다음에 팝업을 열거나 브라우저를 시작할 때 보내져요.

브라우저에 요청하는 권한은 activeTab과 storage 두 가지뿐이고, 분석 도구는 없어요. 개인정보 처리방침에 무엇을 읽고, 저희가 무엇을 저장하고, 무엇이 내 기기에 남는지 나와 있어요.