PrivateNote CLI
스크립트, 파이프 및 CI에서 흔적을 남기지 않는 비밀 정보 관리 — 네트워크에 전달되기 전 로컬에서 암호화됩니다.
이 페이지에서
대상 사용자
비밀 정보가 이미 파일, 비밀번호 관리자 또는 파이프라인 출력에 있고, 채팅이나 이메일에 붙여넣지 않고 공유 가능한 링크가 필요한 경우 CLI를 사용하세요.
이 도구는 stdin 또는 파일 경로를 읽어 사용자의 기기에서 AES-256-GCM로 암호화한 후, 암호문만 업로드하고 프래그먼트에 복호화 키가 포함된 URL을 출력합니다.
이 방식으로 생성된 노트는 분석 데이터에 creationSource: cli로 기록됩니다.
설치
Node.js 18 이상이 필요합니다. macOS, Linux 및 Windows에서 작동합니다.
# Run once without installing npx privatenote-cli --expire 1h --output-url-only # Or install globally (adds the `privatenote` command) npm install -g privatenote-cli # Pipe a secret in scripts cat secret.txt | privatenote --expire 1h --output-url-only # Local self-host / wrangler dev (HTTP API — dev only) echo "secret" | privatenote --insecure --api-base-url http://localhost:8787 --output-url-only
직접 사용해 보기
브라우저에서 CLI와 같은 흐름을 실행합니다. 로컬 암호화 후 암호문을 업로드하고 프래그먼트에 키가 포함된 URL을 출력합니다.
실시간 데모로 privatenote.ai에 실제 노트를 만듭니다. 운영 자격 증명 대신 일회용 비밀을 사용하세요.
echo 'sk-live-demo-replace-me' | npx privatenote-cli --expire 1h --output-url-onlyhttps://privatenote.ai/note/…#…
보안 아키텍처
평문은 암호화되지 않은 상태로 기기를 절대 떠나지 않습니다. 공유 URL는 #fragment에 복호화 키를 포함하며, 브라우저와 HTTP 클라이언트는 이를 서버로 전송하지 않습니다.
stdout이 TTY가 아닌 경우(파이프 또는 캡처됨), --output-url-only 또는 --force-stdout을 전달하지 않으면 CLI가 링크 출력을 거부합니다. 이는 CI 로그로의 실수로 인한 유출을 방지합니다.
로컬 암호화
브라우저, 편집기, 터미널 또는 MCP 프로세스에서 기기의 AES-256-GCM을 사용합니다.
암호문 업로드
암호화된 바이트와 노트 메타데이터(만료, 읽은 후 삭제)만 서버에 전송됩니다.
키는 #fragment에 위치
복호화 키는 URL 해시에 유지됩니다. 브라우저는 HTTP 요청에 프래그먼트를 보내지 않습니다.
privatenote.ai/note/…#key
원격 API 오리진에는 HTTPS가 필요합니다. 로컬 http:// 개발 환경(예: :8787의 wrangler dev)에서만 --insecure를 사용하세요.
PRIVATENOTE_ALLOWED_HOSTS는 커스텀 API base URL를 사용할 때 API 호스트네임을 고정합니다.
업로드 전 응답 형태 검증 및 예약된 노트 ID 확인.
URL을 출력하는 대신 출력을 chmod 600 파일로 리다이렉션하는 것을 권장합니다.
플래그 및 환경 변수
| 이름 | 설명 |
|---|---|
| --expire 15m|1h|24h|7d | 노트 수명 (기본값: 24h) |
| --burn / --no-burn | 첫 조회 후 파기 (기본값: burn) |
| --title <text> | 콘텐츠 앞에 추가할 선택적 제목 |
| --json | { secureUrl, expiresAt, burnAfterReading } 출력 |
| --output-url-only | URL 전용 출력; 스크립트의 파이프 stdout에 안전함 |
| --force-stdout | stdout이 터미널이 아닌 경우 출력 허용 (CI에서 --json과 함께 사용) |
| --api-base-url <url> | API 오리진 재정의 (HTTPS; 로컬 http://의 경우 --insecure와 함께 사용) |
| --insecure | http:// API 오리진 허용 — 로컬 개발 전용, 프로덕션에서는 절대 사용 금지 |
| PRIVATENOTE_API_BASE_URL | 기본 API base URL |
| PRIVATENOTE_WEB_ORIGIN | 공유 링크 오리진 (API 오리진이 기본값) |
| PRIVATENOTE_ALLOWED_HOSTS | 쉼표로 구분된 호스트네임 허용 목록 |
관련 통합
에디터 확장 프로그램
컨텍스트를 전환하지 않고 VS Code, Cursor 또는 Codex IDE에서 메모를 생성하세요. 사이드바, 선택 텍스트 명령 또는 타이틀 바 액션을 사용하세요.
문서 보기MCP 서버
로컬 파일을 미리 보고 승인한 후 암호화하는 확인 절차입니다.
문서 보기Codex 플러그인
MCP 전용 번들 플러그인과 스킬을 설치하거나, ~/.codex/config.toml에 privatenote-mcp를 추가하세요. 에이전트가 절대 볼 수 없는 비밀 정보에는 Codex IDE에서 동일한 VS Code 확장을 사용하세요.
문서 보기Chrome 확장 프로그램
사이트를 먼저 열 필요 없이, 컨텍스트 메뉴, 툴바 팝업 또는 키보드 단축키를 통해 모든 탭에서 선택한 텍스트를 암호화합니다.
문서 보기