Skip to main content
문서가 지식의 원시 단위 — 파일, 페이지, 추출. 인제스트 (Foundry 파이프라인이나 웹 업로드로) 되면 Agent 가 리트리벌하는 라이브러리에 삶. documents CLI 가 라이브러리 일상 관리 표면: 나열, 태그, supersede.

명령

documents list

문서당 로우 하나 인쇄: ID, 제목, 콘텐츠 타입, 크기, 태그, 마지막 업데이트. 스크립트 가능 출력에 --json 추가.

documents get

전체 메타데이터 인쇄 — 제목, 소스 URL, 콘텐츠 해시, 태그, 생성한 인제스트 파이프라인, 청크 카운트, supersede 상태.

documents supersede

문서를 superseded 로 표시 — 모든 리트리벌에서 숨김이지만 감사용으로 여전히 쿼리 가능. Superseded 청크가 몇 초 안에 쿼리 매치 중단. --restore 가 supersede 되돌림. 문서가 리트리벌 인덱스에 재합류. 삭제보다 supersede 선호: 되돌리기 가능하고 감사 트레일 보존. 삭제는 진짜 테이크다운 (PII, 법적 제거) 에만 적절 — 그것도 CLI 아닌 라이브러리 UI 사용, 삭제가 확인 필요하므로.

documents tag

태그가 큰 라이브러리 슬라이스하는 주요 방법. 태그 위생은 태그·정리 참고. Comma 로 구분된 목록 수용. --add--remove 둘 다 옵션 (하지만 최소 하나 필수).

레시피

문서 세트를 한 폴더에서 다른 폴더로 이동

날짜보다 오래된 모든 것 supersede

태그 커버리지 감사

태그 없는 문서 인쇄 — Foundry 강화기로 자동 태깅 후보.

문서 메타데이터를 git 에 스냅샷

콘텐츠 익스포트 없이 시간에 걸친 라이브러리 변경 추적에 유용.

CLI 가 하지 않는 것

  • 업로드 — 일회성 업로드는 앱 사용 (문서 업로드 참고) 또는 자동 인제스트는 Foundry 파이프라인 (nora pipelines 참고).
  • 삭제 — CLI 는 supersede 만 가능. 하드 삭제는 앱 UI 사용 (이중 확인 있음).
  • 콘텐츠 편집 — 문서가 인제스트되면 불변; 소스 편집하고 재인제스트.
이 제약이 의도적 — CLI 가 시각 리뷰 필요한 편집이 아닌 스크립트 작업에 최적화.

문서 ID 가 오는 곳

  • — 라이브러리의 모든 문서가 세부 패널에 ID 표시.
  • Foundry 로그pipelines logs get 이 실행이 생성한 문서 ID 표시.
  • documents list — 스크립팅용.