Gentle-AI의 개요
Gentle-AI는 Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Pi처럼 이미 쓰고 있는 코딩 에이전트의 설정을 다시 쓰는 단일 Go 바이너리입니다. 터미널 설치 도구가 사용 할 에이전트, 구성 요소, 페르소나를 묻고, 프롬프트 파일, skills, MCP 서버 항목, 권한 규칙, 훅을 각 에이전트의 자체 설정에 기록합니다. 에이전트 자체를 설치하지는 않습니다.
구성 요소는 Engram(로컬 SQLite 저장소에서 MCP로 제공되는 영구 메모리), skills 라이브러리, 문서 서버 Context7, 권한 거부 목록, 페르소나, 공급자 전환 도구 GGA, 테마입니다. 그 위에 두 가지 워크플로가 있습니다. Organic Driven Development(ODD)는 작은 변경을 인라인으로 처리하고 여러 세션에 걸친 작업에만 기능 문서를 작성합니다. Receipt-Driven Development(RDD)는 완료된 변경을 고정한 뒤 위험도로 정한 깊이로 리뷰합니다. Alan Buscaglia(Gentleman Programming)가 관리하며, GitHub Sponsors와 컨설팅으로 자금을 마련합니다.
Gentle-AI, 쓸 만한 가치가 있습니까?
Gentle-AI는 skills 묶음이라기보다 설정 관리자입니다. 지원하는 각 에이전트 설정의 일부를 맡아 계속 동기화하며, 이것이 쓸모이자 가장 큰 위험입니다. GitHub 스타는 약 9,100개, 포크는 896개이고, 2026년 2월 28일부터 v4.4.0이 나온 11월 7일까지 297개의 릴리스를 냈습니다. 하루에 한 번이 넘는 속도입니다.
워크플로는 무거운 계획에 반대합니다. ODD는 작업 규모를 파일 수가 아니라 diff만으로 다시 이어갈 수 있는지로 판단하며, 오케스트레이터는 탐색, 병렬 작성자, 컨텍스트 예비, 독립 검증자라는 네 가지 이유 중 하나를 댈 수 있을 때만 서브에이전트를 띄웁니다. 프로젝트 자체 벤치마크(셀당 1회 실행)에 따르면 3줄짜리 버그는 라우팅이 인라인으로 처리하면서 335초, $0.339에서 77초, $0.105로 줄었습니다. 같은 자료는 큰 작업이 순수 Codex CLI의 6.1분에 비해 여전히 17.5~17.9분 걸렸다는 점 도 인정합니다. 이전의 명세 기반 워크플로(SDD)는 v4.0.0에서 폐기되어 예전 튜토리얼은 더 이상 맞지 않습니다.
컴퓨터에 무엇을 남기는지는 분명하게 짚어 둘 만합니다. 설치 스크립트는 PATH를 위해 셸 시작 파일에 한 줄을 추가합니다. Engram은 기억을 로컬 SQLite에 저장하고, git용 .engram/ 폴더로 내보내거나 지정한 Engram Cloud 서버로 복제할 수 있습니다. GGA는 두 번째 전역 바이너리를 설치하고, 선택 도구인 CodeGraph도 자체 CLI를 설치합니다. Claude Code에는 시작, 리뷰, 텔레메트리용 훅을 추가합니다. 설치, 동기화, 업그레이드 때마다 건드릴 설정을 먼저 스냅샷으로 남기고 최근 5개의 백업을 보관합니다.
권한 구성 요소는 허점을 밝혀 둔 실제 방어 장치입니다. Claude Code, OpenCode, Kilo Code에서 에이전트가 ~/.ssh, .env 파일, 클라우드 자격 증명, 키 파일을 읽거나 수정하지 못하게 하고, OpenCode에서는 force push와 홈 디렉터리에 대한 재귀 rm을 막습니다. 문서에 따르면 bash나 grep으로 비밀 정보를 읽는 것은 막지 않으며, env나 xargs 같은 래퍼는 와일드카드 규칙을 빠져나갑니다. 텔레메트리는 기본으로 켜져 있습니다. 무작위 설치 ID, 버전, OS, 설치된 에이전트, 리뷰 카운터를 하루 최대 한 번 보내고, 지원 에이전트의 훅에서 모델 이름과 토큰 수도 보냅니다. DO_NOT_TRACK, GENTLE_AI_TELEMETRY=0 또는 gentle-ai telemetry disable로 끌 수 있으며, 첫 실행에서는 아무것도 보내지 않습니다.
에이전트 하나에 넣는 고정된 skills 절차인 Superpowers와 비교하면, Gentle-AI는 도입이 더 무겁고 작은 작업에서는 더 가볍습니다. 팀이 여러 에이전트를 섞어 쓰면서 모두에게 하나의 메모리와 하나의 리뷰 기준을 원할 때 제값을 합니다. Claude Code만 쓰는 사람에게는 물려받기에 변동이 많은 설정이 너무 많습니다.
제 역할을 하는 곳
한 주 동안 Claude Code, Codex, Cursor를 번갈아 쓰는 프리랜서 개발자
세션을 다시 시작할 때마다 같은 프로젝트 결정을 다시 설명하지 않기
Engram을 세 에이전트 모두에 MCP 서버로 연결하므로 한 에이전트에서 저장한 결정을 다른 에이전트에서 검색할 수 있습니다. 기억은 로컬 SQLite에 남고, 저장소에 넣고 싶으면 engram sync가 .engram/에 기록합니다. 모델 사용료 외에는 비용이 없습니다.
개발자마다 프롬프트를 제각각 쓰는 5인 스타트업의 테크 리드
모든 개발자의 에이전트에 같은 안전장치와 같은 리뷰 깊이를 적용하기
개발자마다 같은 프리셋으로 설치 도구를 실행합니다. 권한 구성 요소가 ~/.ssh와 .env 파일 읽기를 막고, RDD는 변경마다 리뷰어 네 명을 돌리는 대신 위험도에 맞춰 리뷰를 조정합니다. 릴리스 속도를 고려하면 gentle-ai sync를 자주 다시 실행해야 합니다.
계획을 과하게 세우는 에이전트로 작은 버그를 고치는 백엔드 엔지니어
함수 하나짜리 수정을 계획 파이프라인 없이 끝내기
ODD는 이해된 저위험 작업을 먼저 실패하는 테스트 하나를 쓴 뒤 인라인으로 진행합니다. 메인테이너의 n=1 벤치마크에서 3줄짜리 버그가 56턴에서 10턴으로 줄었지만, 자신의 코드베이스 측정값이 아니라 참고치로 봐야 합니다.
도입 전 확인할 점
- 설정
- macOS와 Linux에서는 brew install 또는 curl을 bash로 넘기는 스크립트를, Windows에서는 Go 1.25.10 이상으로 go install을 씁니다. gentle-ai를 실행해 에이전트, 구성 요소, 페르소나를 고르고, 이어서 gentle-ai doctor로 읽기 전용 상태 점검을 합니다. 릴리스 서명은 검증할 수 있습니다.
- 연동
- README는 17개 연동을 꼽으며, Claude Code, Codex, Cursor, OpenCode, Kilo Code, Gemini CLI, VS Code Copilot, Windsurf, Antigravity, Kiro, Qwen Code, Hermes, Pi(Gentle Shell 경유) 등이 포함됩니다. 에이전트 문서에는 GitHub Copilot CLI도 있습니다. Conductor는 감지되지만 관리형 쓰기는 받지 않습니다. Context7과 CodeGraph는 MCP 서버로 추가됩니다.
- 데이터와 개인정보
- 호스팅 서비스가 필요 없습니다. 메모리는 로컬 SQLite이며, git이나 직접 설정한 Engram Cloud 서버로 내보내는 것은 선택입니다. 익명 텔레메트리는 기본으로 켜져 있고 항목별로 문서화되어 있습니다. 경로, 저장소 이름, 프롬프트, 코드는 빼 지만 공개 모델 ID와 토큰 수는 포함합니다. GitHub에 등록된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- MIT로 무료입니다. 실제 비용은 라우팅 규칙이 줄이려는 모델 사용료와, 릴리스가 나올 때마다 설정을 다시 동기화하는 시간입니다. 메인테이너는 팀 도입용 컨설팅을 판매하지만 가격은 공개하지 않습니다.
- 제한
- 열린 이슈는 366개입니다. 기능은 에이전트마다 다르며, 예를 들어 Cursor와 Antigravity는 관리형 리뷰 에이전트를 받지 않습니다. 문서는 main 브랜치를 따르고 마이그레이션 세부 사항이 많으며, 권한 규칙은 셸 래퍼나 중첩 셸을 해석하지 못합니다.
좋은 점
- 설치 도구 하나로 17개 에이전트에 같은 메모리, skills, 리뷰 규칙을 설정
- 작 은 작업은 서브에이전트나 계획 문서 없이 인라인으로 실행
- 쓰기 전마다 설정을 스냅샷으로 남기고, 복원과 읽기 전용 doctor 명령 제공
- 텔레메트리를 항목별로 문서화했고, 미리보기 명령과 여러 비활성화 방법 제공
아쉬운 점
- 약 8개월 동안 300개 가까운 릴리스가 나와 동작과 파일 구조가 계속 바뀜
- 텔레메트리와 RDD 리뷰가 모두 기본으로 켜져 있음
- 권한 거부 목록이 bash나 grep을 통한 비밀 정보 읽기를 막지 못함
- 기능이 에이전트마다 다르고, Pi에는 별도 패키지인 Gentle Shell이 필요
추천 대상
두 개 이상의 코딩 에이전트를 쓰면서 공유 프로젝트 메모리와 모두에게 같은 리뷰 기준을 원하는 개발자나 소규모 팀입니다.
Gentle-AI 대안
Gentle-AI: 자주 묻는 질문
- Gentle-AI, 쓸 만한 가치가 있습니까?
- 여러 코딩 에이전트를 쓰는 사람을 위 한 사려 깊고 방어가 잘된 설정 계층이지만, 잦은 릴리스와 끝까지 읽을 사람이 드문 문서가 발목을 잡습니다. 평점은 5점 만점에 4.0점입니다.
- Gentle-AI의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. 비용은 이 도구가 설정하는 에이전트의 모델 사용료입니다.
- Gentle-AI의 단점은 무엇입니까?
- 약 8개월 동안 300개 가까운 릴리스가 나와 동작과 파일 구조가 계속 바뀜; 텔레메트리와 RDD 리뷰가 모두 기본으로 켜져 있음; 권한 거부 목록이 bash나 grep을 통한 비밀 정보 읽기를 막지 못함; 기능이 에이전트마다 다르고, Pi에는 별도 패키지인 Gentle Shell이 필요.
- Gentle-AI에 적합한 사람은 누구입니까?
- 두 개 이상의 코딩 에이전트를 쓰면서 공유 프로젝트 메모리와 모두에게 같은 리뷰 기준을 원하는 개발자나 소규모 팀입니다.
- 팀이나 프로덕션 환경에서 Gentle-AI의 비용은 얼마입니까?
- MIT로 무료입니다. 실제 비용은 라우팅 규칙이 줄이려는 모델 사용료와, 릴리스가 나올 때마다 설정을 다시 동기화하는 시간입니다. 메인테이너는 팀 도입용 컨설팅을 판매하지만 가격은 공개하지 않습니다.
- Gentle-AI에 회사 데이터를 맡겨도 안전합니까?
- 호스팅 서비스가 필요 없습니다. 메모리는 로컬 SQLite이며, git이나 직접 설정한 Engram Cloud 서버로 내보내는 것은 선택입니다. 익명 텔레메트리는 기본으로 켜져 있고 항목별로 문서화되어 있습니다. 경로, 저장소 이름, 프롬프트, 코드는 빼지만 공개 모델 ID와 토큰 수는 포함합니다. GitHub에 등록된 보안 권고는 없습니다.
- Gentle-AI의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Superpowers, Everything Claude Code (ECC), BMAD Method, claude-mem 및 Spec Kit입니다.
답변 확인일: 2026년 11월 13일.