지식 베이스
명령줄
메일함과 모든 API 작업을 터미널이나 스크립트에서.
세부 사항
openemail명령은 npm에서@openemail/cli로 설치합니다. 의존성 없는 단일 파일이며 Node.js 20.12 이상이 필요합니다.npm i -g @openemail/cli로 설치하고,npx @openemail/cli <command>로 설치 없이 실행합니다.- 로그인 방법은 두 가지입니다.
openemail login은 브라우저를 열고, 거기서 워크스페이스, 권한, 접근 기간을 고릅니다. 브라우저 로그인은 각각 연결된 앱이 되며 계정 → 연결된 앱에서 제거할 수 있습니다.openemail login --with-token으로 저장하거나OPENEMAIL_API_KEY로 설정한 API 키는 브라우저를 열지도, 코드를 묻지도 않으므로 스크립트와 CI에 알맞습니다. - 브라우저 로그인은 사용자 본인으로 동작하므로, 웹훅 추가나 도메인 제거 같은 민감한 변경에는 웹 앱과 같은 인증 코드를 요구합니다. 코드 하나로 그 로그인은 60분 동안 유효하며,
openemail verify로 스크립트 실행 전에 미리 입력할 수 있습니다. inbox,search,read,reply,send는 앱과 같은 방식으로 메일함을 다루며, 같은 검색 문법, 첨부 파일, 예약 발송, 실행 취소, 번역을 지원합니다.archive,star,snooze등 스레드 작업은 여러 스레드 ID를 한 번에 받습니다.- SDK의 모든 메서드가
openemail <resource> <verb>형태의 명령이므로, REST API가 할 수 있는 일은 명령줄도 할 수 있습니다.openemail api는 같은 로그인으로 어떤 경로든 직접 호출합니다. ai translate,ai compose,ai summarize로 AI 기능을 터미널에서 씁니다.openemail mcp config는 Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex용 설정을 출력하고,openemail mcp serve는 그런 클라이언트가 명령줄의 로그인을 재사용하게 합니다.- 스크립트를 위해 만들어졌습니다. 데이터는 stdout으로, 나머지는 모두 stderr로 가고,
--json은 JSON만 출력하며,--all은 목록의 모든 페이지를 훑고, 실패 종류마다 고유한 종료 코드가 있으며, CI나 터미널이 없는 환경에서는 아무것도 묻지 않습니다.openemail temp는 계정도 키도 없이 일회용 받은편지함을 만들고,temp watch --first는 첫 메시지를 기다립니다. - 아직 없는 것: 결제, 워크스페이스 만들기와 전환, 계정 보안, 데이터 내보내기, 캘린더 일정 쓰기, 전달, DNS 제공자 연결은 브라우저 세션이 필요해서 명령줄에서는 아직 할 수 없고, 대신
openemail open이 웹 앱의 알맞은 페이지를 엽니다. SDK처럼 릴리스 워크플로가 없으므로, 새 버전은 누군가 게시할 때 npm에 올라갑니다.
