오픈소스 브라우저 문법 검사기 grammai: 로컬 오프라인 검사와 개인 AI CLI 연동
영어·독일어·루마니아어 오프라인 맞춤법 및 문법 검사와 로컬 Claude Code·Codex CLI 연동을 지원하는 GNU GPLv3 오픈소스 크롬 확장 프로그램 grammai의 주요 기능과 설치 경로를 정리합니다.
온라인 에디터에서 글을 쓸 때 상용 맞춤법 검사기나 클라우드 기반 AI 교정 도구에 문장을 그대로 전송하는 방식은 데이터 프라이버시 측면에서 늘 부담이 따릅니다. 오픈소스 크롬 확장 프로그램인 grammai(개발자 Silvestro, GitHub zilvestro/grammai)는 외부 서버와의 상시 통신 없이 브라우저 안에서 직접 구동하는 문법 검사 환경과 로컬 CLI 기반 AI 연동을 대안으로 제시합니다.

이미지 출처: zilvestro (GitHub repository zilvestro/grammai)
grammai는 GNU GPLv3(GPL-3.0-only) 라이선스로 배포되는 크롬 및 크로미엄 기반 브라우저(Helium 등)용 글쓰기 보조 확장 프로그램입니다. 2026년 10월 중순 공개된 이후 크롬 웹스토어 배포와 소스 코드 빌드를 모두 지원하고 있습니다.
브라우저 내부 오프라인 검사와 프라이버시 구조
grammai의 핵심은 별도의 계정 가입이나 API 키 발급, 외부 백엔드 연동 없이 브라우저 독립 실행 환경에서 기본 문법을 검사한다는 점입니다.
- 번들 엔진 기반 오프라인 검사: 영어, 독일어, 루마니아어 사전과 교정 규칙 엔진이 확장 프로그램 패키지 안에 내장되어 있습니다. 자바(Java), 홈브루(Homebrew), 랭귀지툴(LanguageTool) 같은 로컬 종속 소프트웨어를 추가로 설치할 필요가 없습니다.
- 인라인 문맥 교정: 단순 철자 오류뿐만 아니라 독일어 "Ist das wirklich war?"와 "Ist das wirklich wahr?" 구분 같은 단어 혼동 패턴을 로컬 규칙으로 잡아냅니다. 오류 단어에 마우스를 올리면 수정 제안이 표시되고, 클릭 한 번으로 본문에 반영하거나 건너뛸 수 있습니다.
- 원격 전송 없는 검사 데이터: 일반 맞춤법 검사 과정에서는 텔레메트리, 분석 도구, 자동 크래시 보고가 일절 동작하지 않습니다. 사용자 설정, 개인 단어장, 저장된 프롬프트, 사이트별 비활성화 목록은 모두 브라우저 로컬 저장소에만 보관됩니다.
독일어와 루마니아어 엔진은 첫 검사 실행 시 몇 초간 초기화 과정을 거치며, 이후에는 지연 없이 즉각 동작합니다.
로컬 Claude Code 및 Codex CLI를 활용한 AI 기능 연동
grammai는 자체 호스팅 구독형 AI 모델을 판매하는 대신, 사용자가 이미 인증을 마친 로컬 AI 도구를 직접 호출하는 방식을 취합니다. 문장 재작성, 사용자 정의 프롬프트 실행, 문맥 심층 분석, 영어-독일어-루마니아어 상호 번역 기능이 여기에 해당합니다.
AI 기능 연결에는 단 1회의 로컬 헬퍼 설치가 필요하며, 현재 헬퍼 인스톨러는 macOS 환경을 지원합니다. 브라우저가 직접 외부 상용 API 토큰을 상시 보관하는 구조가 아니라, 시스템에 설치된 공식 Claude Code 또는 Codex CLI를 헬퍼 데몬을 거쳐 로컬에서 브리지합니다.
따라서 AI 재작성을 실행할 때만 선택한 텍스트 또는 활성 입력 필드 내용이 사용자의 CLI를 거쳐 각 모델 제공자로 전송됩니다. 해당 공급자의 사용 약관과 계정 사용량 한도가 그대로 적용되므로, 불필요한 서드파티 중개 수수료나 플랫폼 종속 없이 기존 개발 환경의 LLM 권한을 그대로 활용할 수 있습니다.
지원 입력 환경, 단축키 및 설치 방법
grammai는 키보드 중심 작업 흐름을 염두에 두고 설계되었습니다. 마우스 조작 없이 텍스트 영역에서 단축키로 보조 패널을 호출하고 교정 사항을 적용할 수 있습니다.
- 어시스턴트 열기/닫기: Windows/Linux
Ctrl + Shift + Y, macOSCmd + Shift + Y - 재작성(Rewrite) 패널 호출: Windows/Linux
Ctrl + Shift + K, macOSCmd + Shift + K - 선택 영역 번역: Windows/Linux
Ctrl + Shift + L, macOSCmd + Shift + L - 교정 승인 및 취소:
Alt + Enter(적용),Alt + Backspace(무시),Alt + Z(마지막 교정 되돌리기)
설치는 크롬 웹스토어(coafchipjppaininmkchbiodpcdkkakc)에서 바로 내려받거나 소스 코드를 통해 직접 빌드할 수 있습니다. 수동 빌드는 Node.js 22 이상 환경에서 저장소를 복제한 뒤 아래 명령을 실행합니다.
npm ci
npm run build
빌드가 끝나면 크롬 주소창에 chrome://extensions를 입력하고, 우측 상단 개발자 모드를 켠 뒤 '압축해제된 확장 프로그램을 로드합니다'를 눌러 생성된 dist 디렉터리를 지정하면 됩니다.
현재 베타 단계 지원 범위는 일반 <textarea>, 텍스트 <input>, 표준 contenteditable 속성 필드, X(구 트위터) 등에서 쓰이는 Draft.js 기반 에디터입니다. 구글 닥스(Google Docs) 캔버스나 Shadow DOM, Slate, ProseMirror 기반 복합 에디터 전용 어댑터는 아직 미완성 상태입니다. 클라우드 전송 없이 로컬에서 가볍게 영문·독문 문서를 작성하고 개인 LLM CLI를 글쓰기에 연결하려는 개발자에게 유용한 도구입니다.
출처
- GitHub 저장소: zilvestro/grammai