오픈소스 브라우저 글쓰기 도구 'grammai' 분석: 로컬 문법 검사와 로컬 CLI 연동
영어·독일어·루마니아어 오프라인 문법 검사와 사용자 로컬 Claude Code·Codex CLI 연동을 지원하는 GNU GPLv3 오픈소스 확장 프로그램 grammai의 구조와 설치 경로를 정리했습니다.
웹 브라우저에서 동작하는 글쓰기 보조 도구 grammai는 외부 서버 통신 없이 브라우저 안에서 문법을 검사하고, 사용자의 로컬 환경에 설치된 AI CLI를 활용해 텍스트를 다듬는 오픈소스 프로젝트입니다.

이미지 출처: zilvestro (GitHub repository zilvestro/grammai)
개발자 Silvestro(@zilvestro)가 2026년 10월 처음 공개한 grammai는 크롬(Chrome) 및 헬륨(Helium)을 비롯한 크로미움 기반 브라우저를 지원합니다. 코드는 GNU GPLv3(GPL-3.0-only) 라이선스로 배포됩니다. 상용 구독형 문법 검사 서비스와 달리 개인정보 추적 요소를 배제하고 자체 계정 체계 없이 동작하도록 설계되었습니다.
오프라인 문법 검사와 브라우저 내 데이터 처리
grammai의 핵심은 네트워크 연결이나 외부 계정 없이 작동하는 온디바이스(on-device) 검사 엔진입니다.
영어, 독일어, 루마니아어 사전과 검사 규칙 엔진이 확장 프로그램 패키지 안에 내장되어 있습니다. 자바(Java), 홈브루(Homebrew), 랭귀지툴(LanguageTool) 같은 외부 런타임을 따로 설치할 필요가 없으며 API 키 등록도 요구하지 않습니다.
- 데이터 수집 배제: 일반 문법 검사는 전적으로 브라우저 내부에서만 수행됩니다. 분석 도구나 텔레메트리, 자동 크래시 수집 코드가 포함되어 있지 않습니다.
- 로컬 저장소 활용: 사용자 정의 단어, 개인 프롬프트, 사이트별 검사 일시정지 설정은 브라우저의 로컬 확장 프로그램 스토리지에만 저장됩니다.
- 문맥 오류 탐지: 단순 철자 확인뿐 아니라 단어 혼용(예: 독일어 'war'와 'wahr') 같은 문맥 규칙 검사를 브라우저 단에서 자체 처리합니다. 독일어와 루마니아어 엔진은 첫 검사 실행 시 수 초간의 초기화 과정을 거칩니다.
사용자 소유 Claude Code·Codex CLI 연동 구조
grammai는 자체 호스팅 AI 서버나 별도 구독 모델을 제공하지 않습니다. 대신 사용자가 로컬 기기에 로그인해 둔 Anthropic Claude Code나 OpenAI Codex CLI를 연결해 생성 기능을 수행합니다.
이 기능을 활성화하려면 1회성 네이티브 로컬 헬퍼 프로그램을 설치해야 합니다. 현재 헬퍼 설치기는 macOS를 지원합니다.
- 지원 기능: 문맥을 반영한 텍스트 재작성, 사용자 정의 저장 프롬프트 실행, 확장 문맥 검사, 영어-독일어 및 영어-루마니아어 간 직접 번역을 제공합니다.
- 작업 흐름: 에디터 안에서 단축키나 액션 필을 통해 실행하면 선택 영역 또는 활성 필드의 텍스트가 로컬 헬퍼를 거쳐 사용자의 CLI 도구로 전송됩니다. 해당 인공지능 공급자의 이용 약관과 계정 사용 한도가 그대로 적용됩니다.
- 단축키 지원: Windows/Linux 환경 기준 어시스턴트 열기(
Ctrl+Shift+Y), 재작성 실행(Ctrl+Shift+K), 번역(Ctrl+Shift+L)을 제공하며Alt+Enter로 교정 적용,Alt+Backspace로 제안 기각,Alt+Z로 직전 수정을 취소할 수 있습니다. macOS에서는 Command 키 조합을 사용합니다.
설치 경로와 현재 지원 범위의 한계
grammai는 웹 스토어 설치와 소스 코드 빌드 두 가지 설치 경로를 제공합니다.
일반 사용자는 크롬 웹 스토어(확장 프로그램 ID: coafchipjppaininmkchbiodpcdkkakc)에서 직접 내려받아 추가 설정 없이 오프라인 검사를 사용할 수 있습니다. 개발이나 직접 빌드를 원할 경우 Node.js 22 이상 환경에서 다음 명령어를 실행합니다.
npm ci
npm run build
빌드 완료 후 생성된 dist 디렉터리를 브라우저 확장 프로그램 관리 페이지(chrome://extensions)의 '압축해제된 확장 프로그램을 로드합니다' 메뉴로 불러오면 설치가 완료됩니다.
현재 공개된 버전은 베타 수준의 에디터 호환성을 가집니다. 일반 텍스트 입력창(textarea, text input)과 기본 contenteditable 영역, X(구 트위터) 등에서 검증된 Draft.js 에디터는 지원하지만, 구글 닥스(Google Docs) 캔버스나 Shadow DOM, Slate, ProseMirror 기반의 복합 에디터 어댑터는 아직 완성되지 않았습니다. 아울러 단문이나 여러 언어가 섞인 문장에서는 자동 언어 감지 오차가 발생할 수 있습니다.
출처
- zilvestro/grammai 공식 깃허브 저장소: https://github.com/zilvestro/grammai
- 크롬 웹 스토어 grammai 페이지: https://chromewebstore.google.com/detail/grammai/coafchipjppaininmkchbiodpcdkkakc