<div align="center">
⚡🧠 flashmind — Gemini 3.8 Flash 스마트 에이전트
Gemini 3.8 Flash가 기억하고, 계획하며, 검증하여 환각(hallucinations)을 제거하도록 만듭니다.
[Engram]을 통한 영구적인 크로스 툴 메모리 · 4가지 능동적 코딩 스킬 · 엄격한 반(反)환각 규칙.
단일 플러그인으로 Gemini CLI, Antigravity, Cursor, VS Code, Windsurf, 그리고 Claude Code를 지원합니다.
npm version
test
dependencies
node
license
</div>
💡 왜 Flashmind인가?
빠른 AI 모델은 다음과 같은 상황이 발생할 때까지는 놀라운 코딩 파트너입니다:
- 아키텍처 결정 사항을 잊어버리고, 새로운 세션마다 같은 질문을 반복합니다.
- 상상 속의 패키지, 사용 중단된 함수(deprecated functions), 가짜 CLI 플래그를 만듭니다.
- 테스트를 실행하거나 변경 사항을 검증하지 않고
옵션 3: 자동 전체 설치 프로그램 (Engram + 스킬 + 규칙)
Engram 바이너리, 모든 에이전트 스킬, 그리고 자동화된 클라이언트 구성을 포함합니다:
macOS / Linux:
git clone https://github.com/Hvftpie13/Flashmind_Gemini-3.8-Flash_Smart-agent flashmind
cd flashmind
./install.sh antigravity-cli
Windows (PowerShell):
git clone https://github.com/Hvftpie13/Flashmind_Gemini-3.8-Flash_Smart-agent flashmind
cd flashmind
.\
install.ps1 antigravity-cli
🧩 클라이언트 구성 (Client Configuration)
사전 구성된 파일은 configs/에서 사용할 수 있습니다:
| 클라이언트 / 에디터 | MCP 구성 파일 | 규칙 위치 |
|---|
| Antigravity | configs/antigravity/mcp_config.json → ~/.gemini/config/mcp_config.json | AGENTS.md → Rules / ~/.gemini/GEMINI.md |
| ... | | |
🎯 능동형 에이전트 스킬 (Proactive Agent Skills)
현재 프롬프트와 관련성이 있을 때 자동으로 로드됩니다:
| 스킬 | 트리거 | 목적 |
|---|
plan-first | 3개 이상의 단계 또는 다중 파일 편집이 필요한 작업 | 코드를 읽기 → 계획 초안 작성 → 한 번에 하나의 검증된 단계를 실행합니다. |
| ... | | |
⚡ 슬래시 명령어 (Gemini CLI)
| 명령어 | 동작 |
|---|
/memory:recall <query> | 메모리가 특정 주제에 대해 알고 있는 내용을 검색하고 요약합니다. |
| ... | |
🔄 업데이트 (Updating)
업데이트는 절대로 사용자의 메모리에 영향을 주지 않습니다. 메모리는 ~/.engram/와 ~/.flashmind/에 저장됩니다. 변경된 내용은 CHANGELOG.md를 참조하세요.
| 설치 방법 | 업데이트 방법 |
|---|
| Gemini CLI 확장 프로그램 | gemini extensions update flashmind (또는 gemini extensions update --all). 이 명령어는 제자리에 업데이트되므로, 다시 install을 실행하지 마세요. 만약 소스를 찾지 못하는 경우(예: 이전 레포 이름으로 설치한 경우), 먼저 gemini extensions uninstall flashmind를 실행한 다음 현재 URL에서 다시 설치하세요. |
| ... | 중복 방지 |
- 서버당 하나의 항목만 유지하세요. MCP 설정에서 단일한 "flashmind" 키와 단일한 "engram" 키를 유지해야 합니다. 기존 항목을 편집하고, 두 번째 사본을 붙여넣지 마세요.
- 규칙은 추가하지 말고 덮어쓰세요. Cursor, Windsurf 및 VS Code의 경우, 동일한 이름으로 파일을 덮어쓰세요.
~/.gemini/GEMINI.md 또는 CLAUDE.md와 같은 공유 파일의 경우, 처음 붙여넣을 때 규칙들을 마커로 감싸고, 업데이트할 때마다 마커 사이의 모든 내용을 덮어쓰세요:
<!-- flashmind:start -->
...contents of AGENTS.md...
<!-- flashmind:end -->
- 스킬은 복사본을 하나만 유지하세요. 만약
skills/를 여러 폴더(예: ~/.gemini/skills와 ~/.agents/skills)에 복사했다면, 하나만 남기고 나머지는 삭제하세요.
- 업데이트 후 새 세션을 시작하여 에이전트가 새로운 규칙과 스킬을 로드하도록 하세요.
🔒 개인 정보 보호 및 로컬 우선 방식 (Privacy & Local-First)
- 100% 로컬 저장: 모든 메모리는 사용자의 장치(
~/.engram/ 또는 ~/.flashmind/)에 저장됩니다. 텔레메트리(telemetry)나 외부 API 호출은 전혀 없습니다.
- 비밀 정보 마스킹 (Secret Redaction): 비밀번호, bearer 토큰, API 키 및 민감한 자격 증명(credentials)을 자동으로 거부합니다.
- 종속성 제로 (Zero Dependencies): 서드파티 런타임 npm 패키지 없이 가볍고 빠릅니다.
📄 라이선스 (License)
MIT © Flashmind Contributors.