AI 에이전트 IDE "Teaspoon IDE" v1.0.0 정식 버전 출시

- **편집 후 테스트의 표준화** — 테스트 스위트가 있는 프로젝트의 경우, 편집 후에 RUN_COMMAND로 테스트를 실행하고, 되돌린(rollback) 다음 완료 보고하는 흐름을 프롬프트에 포함했습니다.
- **긴 대화의 압축 (compaction)** — 최근 20 메시지를 초과하는 대화는 오래된 턴을 요약하여 보내는 로링 새마리(rolling summary) 방식으로 처리합니다. 작은 모델의 컨텍스트 제한을 의식하지 않고도 오랫동안 작업할 수 있습니다.
- **프로젝트가 없어도 작동** — 폴더를 열지 않아도 대화를 시작할 수 있으며, AI가 파일을 쓰고 싶을 때 '프로젝트 생성 다이얼로그'로 안내합니다.
- **CLOSE_PROJECT 명령어** — AI가 '프로젝트를 닫아라'라는 지시를 실행 가능하게 합니다.

### 보안 및 개인 정보 보호

- **파일 접근의 강제 스코프** — 파일 관련 명령어는 프로젝트 루트 내에서 해결되는 경우에만 수락됩니다. `..`을 이용한 탈출, 절대 경로를 사용한 임의 파일 읽기, 해결 실패 시의 폴백(fallback) 읽기를 모두 차단했습니다.
- **LLM에게 절대 경로 전송 안 함** — 컨텍스트와 명령어 결과는 모두 프로젝트 상대 경로로 변환됩니다. `C:\[사용자 이름]`과 같은 OS 사용자 이름이 클라우드 제공업체에 유출되지 않습니다.
- **API 키의 2단계화** — 오조작 방지를 위한 확인 버튼을 추가하고, 키 외의 설정(모델 선택, 프록시 URL 등)은 삭제하지 않도록 수정했습니다.

### 채팅 및 UI

- **어시스턴트 응답의 Markdown 렌더링** — 제목, 목록, 표, 코드 블록이 형식화되어 표시됩니다 (marked + DOMPurify를 통해 사니타이즈됨).
- **Ollama의 스트리밍 응답** — 로컬 모델의 답변이 토큰 단위로 흐르도록 합니다. 취소 버튼을 누르면 실제로 HTTP 요청이 중단됩니다.
- **응답 시간 및 모델명 표시** — 각 답변에 소요 시간과 사용된 모델이 붙어, 모델별 속도 비교가 한눈에 가능합니다.
- **채팅 포커스 모드** — Ctrl+Shift+B를 눌러 사이드바, 에디터, 터미널을 숨기고 채팅을 전면화할 수 있습니다. v0.9.0에서 추가되었습니다.
- **대화 목록** — 포커스 모드일 때 왼쪽 레일에서 과거 대화를 일람/전환/삭제/새로 생성할 수 있습니다.
- **대화 기록의 영속화** — localStorage에서 `userData/chat-history`

JSON 파일로 마이그레이션되었습니다. 용량 제한과 손실 위험을 해소하고, 프로젝트를 열지 않은 대화도 저장 및 복원할 수 있습니다.
- **탐색기 자동 업데이트** — 외부 에디터나 git checkout으로 인한 변경 사항을 파일 감시(file watching)로 즉시 반영합니다. Git 패널 역시 동일한 신호로 업데이트됩니다.
- **오른쪽 클릭 메뉴** — Electron 표준에는 존재하지 않는 컨텍스트 메뉴(복사/붙여넣기 등)를 구현했습니다.
- **터미널 자동 스크롤** — 스크롤 업으로 추적을 일시 정지하고, 전송 시 재개합니다. 완료된 명령어 블록은 한 줄로 접힙니다.
- **설정 화면 패널화** — v1.0.0에서 외관(Appearance), AI 컨텍스트(AI Context), LLM 프로바이더(LLM Provider), 프록시(Proxy), 기록(History)을 접을 수 있도록 정리했습니다。

### Git 연동

- **GUI로 완성하는 Git** — 스테이징/커밋/Push・Pull 외에도, 리포지토리 클론, 원격 추가 및 업데이트, 첫 커밋, upstream 포함 Push, `user.name` / `user.email` 설정까지 다이얼로그에서 실행 가능해졌습니다.
- **프로젝트 폴더를 OS로 열기** — 탐색기 헤더에서 파일 관리자(file manager)를 한 번에 실행할 수 있습니다.

### 조직 모드 (중앙 관리)

v0.5.0에서 추가된, 회사/학교용 관리 모드입니다.

- **로그인 게이트** — '조직 로그인 필수'를 ON으로 설정하면, 조직 서버가 발행한 계정으로 로그인하기 전까지 앱을 사용할 수 없습니다.
- **가상 키 방식** — 로그인하면 서버에서 사용자 전용 가상 API 키가 발급되며, AI 요청은 조직의 LLM 프록시를 통해 이루어집니다. 실제 API 키는 단말기에 전달되지 않습니다.
- **예산 배지** — 채팅 헤더에 할당된 예산 잔량을 %로 표시합니다(금액은 비공개). 20% 미만일 때 경고색, 0%일 때 빨간색으로 변합니다.
- **모델 허용 목록** — 사용할 수 있는 모델은 서버가 제어합니다. 개인의 모델 설정은 조직 모드 중 잠깁니다.

### 테마 (총 14종)

설정 화면에서 선택할 수 있는 테마가 대폭 늘었습니다. 각각 에디터의 Monaco 테마도 전용으로 설계되었습니다.

- **Dark / Light / System / Organic Light** — 기본 4가지(구 Quiet Light는 따뜻한 계열의 독자적인 색상 조합으로 개명)
- **Muted Ocean** — 심야 바다를 연상시키는 차분한 블루
- **Ancient Console** — 녹색 인광 CRT에 대한 오마주. 눈에 편안한 탁한 녹색
- **Walnut** — 깊은 나뭇결에 금속성 문자 색상의 우디 다크
- **Heritage** — 베이지색 케이스의 레트로 PC 스타일 라이트
- **Rich Wine** — 바의 와인 저장고 같은 붉은 기가 도는 다크
- **Violet Fizz** — 바이올렛 피즈 칵테일 색상. 깊은 보라색에 달빛이 비치는 노란색
- **Otegami** — 생성리(楮紙) 한지 위에 먹의 농담과 낙관의 주홍. 일본 서신을 모티브로 한 라이트 테마
- **Soda Float** — 하늘색 소다와 하얀 거품의 팬시한 색상 조합
- **Modern Syntax eXtensible** — 레트로 PC의 파란 화면에. 줄여서...
- **Chaya** — 깊은 찻밭의 녹색을 배경 세계로 한 유기적인 다크
- **Coquette** — 리본과 레이스의 페일 핑크 라이트

일본어 UI에서는 이들 역시 일본어 이름으로 번역됩니다(예: Otegami → お手紙, Modern Syntax eXtensible → 8bit의 청춘).

### 국제화

- **일본어화 완성** — v1.0.0에서 `lang/ja.json`을 대폭 확장했습니다. 애플리케이션 메뉴, 오른쪽 클릭 메뉴, 네이티브 다이얼로그(폴더 선택・내보내기 저장), IPC 에러, Gemini/Ollama/조직 로그인 에러 메시지까지 일본어로 통일되었습니다.
- **번역 파일 사용자 추가 가능** — `lang/<언어 코드>.json` 파일을 놓는 것만으로도 독자적인 언어를 추가할 수 있습니다.

### 품질 기반 시설

- **커맨드 파서 단위 테스트** — 실제로 발생한 모든 깨진 모델 출력을 `npm run test:parser`로 검증합니다.
- **E2E 테스트 스위트** — Playwright를 사용하여 실제 앱을 실행하고, Gemini 엔드포인트를 스텁(stub)하여 승인 흐름/파서/기록 저장을 자동으로 검증합니다(`npm run test:e2e`).

） - 
**사이트 개편**— 제품 페이지, 설정 가이드, 활용 사례, 테마 목록을 `cuculhart.com`에 정비했습니다.

## 기술 스택

Electron / React / TypeScript / Monaco Editor / Gemini API・Ollama / Vite / Playwright(E2E)

## 라이선스 안내

FSL-1.1-MIT (소스 공개형)입니다. MIT와는 약간 다르지만, 일반적인 사용은 무료로 자유롭습니다.

- **할 수 있는 것**: 다운로드 및 이용 (개인/업무 무관), 개조 및 커스터마이징, 사내 도구로서의 도입, 라이선스 조항과 저작권 표기를 남긴 상태에서의 포크(fork) 및 재배포 - 
**할 수 없는 것**: Teaspoon IDE와 경쟁하는 상용 제품/서비스로서의 이용 (예: 이름을 바꾼 클론 판매) - 
**각 릴리스는 공개 후 2년 뒤에 자동으로 MIT 라이선스로 전환됩니다**

## 사용법 및 링크

다운로드 (Windows 포터블 exe / Squirrel 인스톨러 / Linux deb):

설정 가이드 (Gemini API 키, Ollama, OpenAI 호환 API, 조직 모드):

활용 사례 (AI에게 오셀로를 만들게 하는 일련의 과정, 실제 비용 기록 포함):

테마 목록 (총 14종 스크린샷):

피드백 및 버그 보고는 GitHub Issues에서 부탁드립니다.

### 토론

![](https://static.zenn.studio/images/drawing/discussion.png)