문서로 건너뛰기
CLI

설치

npm, pnpm, Bun, Yarn, 또는 npx로 설치 없이.

설치

현재 릴리스는 0.0.1입니다. Node.js 20.12 이상이 필요합니다.

npm install -g @openemail/cli

패키지는 의존성이 없는 번들 파일 하나이며, PATH에 명령 하나를 추가합니다: openemail. API를 호출하는 SDK가 내장되어 있어서, CLI는 항상 테스트를 거친 SDK로 실행됩니다. openemail version은 둘의 버전과 런타임 버전을 출력합니다.

확인하기
openemail --versionopenemail --help

설치 없이 실행하기

npx는 패키지를 캐시로 가져와 실행합니다. 한 번 쓰는 명령, CI 작업, 로컬 브리지를 시작하는 MCP 클라이언트에 알맞습니다.

터미널
npx @openemail/cli --helpnpx -y @openemail/[email protected] whoaminpx -y @openemail/cli mcp serve

CI에서는 npx -y @openemail/[email protected]처럼 버전을 고정해서, 새 릴리스가 모르는 사이에 파이프라인을 바꾸지 않게 하세요.

업데이트

CLI는 절대 스스로 업데이트하지 않습니다. npm 레지스트리가 최신 릴리스에 대해 알려 준 내용을 하루 동안 기억합니다. 그보다 오래되었으면 명령이 실행되는 동안 백그라운드에서 다시 묻고, 명령이 끝난 뒤에는 응답을 최대 0.2초만 기다립니다. 더 새로운 릴리스가 있으면 명령이 끝난 뒤 stderr에 알림을 출력합니다:

업데이트 알림
Update available! 0.0.1 → 0.0.2Changelog: https://openemail.uk/docs/cli/changelogRun `npm i -g @openemail/cli@latest` to update. Disable this notice with OPENEMAIL_NO_UPDATE_CHECK=1
  • 알림의 설치 명령은 설치할 때 쓴 패키지 관리자에 맞춰집니다.
  • --help, --version, --json을 쓸 때, help, version, update, completion을 실행할 때, stdout이나 stderr가 터미널이 아닐 때, CI에서는 알림이 없습니다.
  • 모든 곳에서 끄려면 OPENEMAIL_NO_UPDATE_CHECK=1을 설정하세요. OPENEMAIL_DISABLE_UPDATE_NOTICE=1도 같습니다.
  • 요청은 npm 레지스트리로 가는 하나뿐이며, 그 응답은 ~/.openemail/update-check.json에 하루 동안 보관됩니다.

openemail update는 하루 캐시를 무시하고 바로 확인하며, 실행할 명령이나 최신 버전이라는 사실을 출력합니다.

npm i -g @openemail/cli@latest

셸 자동 완성

openemail completion <shell>은 설치된 버전의 모든 명령, 하위 명령, 플래그로 만든 bash, zsh, fish용 자동 완성 스크립트를 출력합니다. 업데이트 후에 다시 실행하세요.

echo 'eval "$(openemail completion bash)"' >> ~/.bashrc

제거

먼저 로그아웃해서 모든 브라우저 로그인을 서버에서 폐기한 뒤, 패키지와 CLI가 로그인을 보관하는 폴더를 지우세요.

터미널
openemail logout --allnpm uninstall -g @openemail/clirm -rf ~/.openemail

받은편지함을,
내 방식대로.

기업, AI, 에이전트, 개인 메일을 위한 이메일 인프라. 규모와 프라이버시, 통제권을 위해 만들었습니다. 이메일이 처음부터 갖췄어야 할 모든 것.

OpenEmail

기업, AI, 에이전트, 개인 메일을 위한 이메일 인프라. 규모와 프라이버시, 통제권을 위해 만들었습니다. 이메일이 처음부터 갖췄어야 할 모든 것.

© 2026 OpenEmail. 모든 권리 보유.