theJayTea/WritingTools

The world's smartest system-wide grammar assistant; a better version of the Apple Intelligence Writing Tools. Works on Windows, Linux, & macOS, with the free Gemini API, local LLMs, & more.

Writing Tools – 시스템 전체에서 사용 가능한 AI 기반 글쓰기 보조 도구

무엇인가요 – Windows, Linux, macOS의 어떤 창에서도 대규모 언어 모델(LLM)을 호출할 수 있는 오픈소스 데스크톱 앱입니다. 단일 핫키를 통해 문법 검토, 재작성, 톤 변경, 번역, 웹 페이지 또는 유튜브 자막 요약, 모델과의 대화가 가능합니다.

왜 중요한가요 – Apple이 macOS에 제공하는 AI 기반 글쓰기 기능을 다른 플랫폼에도 제공하며, 클라우드 API(Gemini, OpenAI, Anthropic, Mistral 등) 또는 Ollama, llama.cpp, MLX 등을 통해 로컬에서 실행하는 모델 중 선택할 수 있습니다. 결과적으로 Grammarly Premium과 같은 상용 제품의 무료이고 개인정보 중심의 대안이 가능합니다.

핵심 기능 (README에 설명됨)

시스템 전체 핫키 (Ctrl+Space 기본값) – 선택한 텍스트를 읽거나 대체할 수 있는 모든 앱에서 작동합니다.
문법 검토 / 재작성 / 톤 변경 – 내장 명령어(친근한, 전문적인, 간결한) 중 선택하거나 사용자 정의 지시어 입력 (예: "이 코드에 주석 추가", "프랑스어로 번역")
요약 세트 – 선택한 텍스트, 웹 페이지, 유튜브 동영상 자막에서 일반 요약, 핵심 포인트 목록, Markdown 테이블 생성 가능. 출력은 Markdown 렌더링이 지원되는 팝업 창에 표시됩니다.
임시 채팅 – 선택 없이 핫키를 누르면 채팅 창이 열리며, 창이 닫힐 때 기록은 삭제됩니다.
사용자 정의 버튼 – 사용자가 자신의 프롬프트 버튼을 정의하고 단축키를 할당할 수 있어, 개인용 AI 명령 센터로 활용 가능합니다.
테마 및 UI – 두 가지 시각적 테마(그라데이션 블러 또는 Windows-V 스타일), 다크모드 지원, 핫키 변경이 가능한 설정 패널 제공.
다국어 지원 – 어떤 언어든 작동 가능. 번역은 LLM이 처리합니다.
코드 인식 – 코드 스니펫의 개선, 번역, 주석 추가가 가능합니다.

플랫폼 지원

플랫폼	구현 방식	주요 참고 사항
Windows	포터블 실행 파일 (`Writing Tools.exe`). 설치 프로그램 없음. 압축 해제 후 실행만 하면 됨. 최초 실행 시 설정 파일 쓰기 위해 관리자 권한 필요.
Linux	소스에서 실행. X11에서는 즉시 작동. Wayland는 XWayland 또는 Flatseal로 앱별 비활성화로 대응 가능.
macOS	네이티브 Swift/SwiftUI 앱 (`writing-tools.app`). macOS 14 이상 필요 (접근성 및 화면 녹화 권한 필요). Apple Silicon용 MLX를 통해 로컬 모델을 실행하여 디바이스 내 추론 가능.

모델 및 제공자 유연성

클라우드 – 무료 API 키로 사용 가능한 Gemini 2.0 Flash (~30B 파라미터)를 포함한 OpenAI, Anthropic, Mistral, OpenRouter 등. 앱은 OpenAI 호환 인터페이스를 사용하므로, 이 프로토콜을 지원하는 모든 제공자가 작동합니다.
로컬 – Ollama(모든 Ollama가 제공하는 모델), llama.cpp, KoboldCPP, TabbyAPI, vLLM, macOS에서는 Apple Silicon 최적화 모델용 MLX 프레임워크. README는 Llama 3.1 8B (약 8GB VRAM/RAM)를 추천합니다.
제공자 전환은 설정 패널에서 가능하며, 명령어별로 다른 제공자를 할당할 수도 있습니다.

설치 (빠른 시작)

Windows – Releases 페이지에서 최신 Writing.Tools.zip 다운로드, 압축 해제 후 Writing Tools.exe 실행. 옵션: 트레이 아이콘에서 "부팅 시 시작" 활성화.
Linux – 링크된 소스 코드에서 실행하기 가이드 따르기. X11에서는 즉시 작동. Wayland는 대안 방법 있음.
macOS – Releases에서 .dmg 다운로드, writing-tools.app를 Applications 폴더로 드래그. 프롬프트 시 접근성(옵션: 화면 녹화) 권한 부여.

개인정보 및 보안

앱 자체는 텔레메트리, 로깅, 데이터 수집을 수행하지 않습니다.
API 키와 설정 파일은 사용자 기기의 로컬에 저장됩니다.
사용자가 명시적으로 명령을 트리거할 때만 텍스트가 원격 제공자에 전송됩니다. 그렇지 않으면 로컬 모델이 모든 데이터를 기기 내부에 유지합니다.
채팅 창은 닫힐 때 기록을 삭제합니다.

라이선스 및 커뮤니티

라이선스: GNU GPL v3 – 자유롭게 사용, 수정, 재배포 가능.
기여자: 핵심 Windows/Linux 기여자: momokrono, CameronRedmore, Soszust40 등. macOS Swift 버전은 Arya Mirsepasi가 작성했으며, 여러 사람의 도움을 받았습니다.
지원: 메인 유지보수자(Jesai) 및 macOS 유지보수자의 Buy-me-a-coffee 링크.
미디어 보도: README에는 30개 이상의 출판물과 2024년 10월에 최고 트렌딩 AI 리포지토리로 등재된 기록이 포함되어 있습니다.

누가 이 도구를 활용할 수 있을까?

현재 애플리케이션을 떠나지 않고도 빠르게 문법 수정이나 톤 조정이 필요한 작가, 학생, 전문가.
즉시 코드 주석 추가나 번역이 필요한 개발자.
개인정보 중심 솔루션을 선호하고, 로컬에서 LLM을 실행할 수 있는 선택지를 원하는 누구나.

결론: Writing Tools는 클라우드와 로컬 LLM을 활용하며, 광범위한 사용자 맞춤 설정이 가능하고 오픈소스 라이선스로 제공되는 진정한 크로스플랫폼 AI 기반 글쓰기 도구입니다.