npm - deel-local-cli - Versions diffs - 1.6.3 → 1.8.0 - Mend

deel-local-cli 1.6.3 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

package/README.ko.md +1182 -0
package/README.md +850 -636
package/bin/deel.js +44 -3
package/package.json +3 -3
package/src/acp/map.js +1 -1
package/src/acp/serve.js +25 -2
package/src/agent/loop.js +41 -9
package/src/agent/session.js +15 -9
package/src/backend/adapter.js +277 -4
package/src/backend/ctxsize.js +16 -2
package/src/backend/detect.js +104 -6
package/src/backend/price.js +197 -0
package/src/backend/retry.js +3 -0
package/src/backend/scanui.js +2 -1
package/src/backend/vision.js +26 -4
package/src/commands.js +141 -38
package/src/completion.js +21 -2
package/src/i18n/en.js +160 -1
package/src/i18n/index.js +22 -0
package/src/i18n/ja.js +152 -1
package/src/i18n/ko.js +173 -1
package/src/i18n/zh.js +152 -1
package/src/oneshot.js +39 -6
package/src/pack/selfpack.js +1 -1
package/src/providers/anthropic.js +48 -0
package/src/providers/bedrock.js +102 -0
package/src/providers/custom.js +65 -0
package/src/providers/gemini.js +64 -0
package/src/providers/index.js +121 -0
package/src/providers/openai.js +68 -0
package/src/repl.js +198 -33
package/src/report.js +3 -2
package/src/reset.js +397 -0
package/src/safety/audit.js +5 -2
package/src/safety/authcmd.js +305 -0
package/src/safety/keystore.js +53 -0
package/src/safety/runmode.js +123 -0
package/src/safety/secrets.js +61 -0
package/src/safety/undo.js +3 -2
package/src/setup.js +215 -12
package/src/tools/desc.en.js +19 -14
package/src/tools/index.js +141 -43
package/src/tools/jobs.js +17 -13
package/src/tools/lsp.js +5 -4
package/src/tools/outline.js +7 -3
package/src/tools/task.js +10 -6
package/src/tools/todo.js +9 -2
package/src/tools/verify.js +9 -3
package/src/tools/webfetch.js +2 -1
package/src/ui/export.js +1 -1
package/src/ui/histline.js +67 -0
package/src/ui/status.js +88 -3
package/README.en.md +0 -1025

package/README.md CHANGED Viewed

@@ -1,13 +1,15 @@
 <div align="center">
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/hero-ko-dark.svg">
-  <img alt="deel — 이 컴퓨터 안에서만" src="docs/assets/hero-ko-light.svg" width="620">
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/hero-en-dark.svg">
+  <img alt="deel — stays on this machine" src="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/hero-en-light.svg" width="620">
 </picture>
-### 로컬 모델과 사내 게이트웨이만으로 도는 코딩 에이전트 CLI
+### A coding-agent CLI that runs on local models and private gateways
-의존성 0개 · Node 20+ · 소스가 나가는 자리는 딱 한 곳
+Zero dependencies · Node 20+ · Exactly one place your source can go
+Vendor APIs connect too — **only when you say so**
 <br>
@@ -18,221 +20,279 @@
 [![Node.js CI](https://img.shields.io/github/actions/workflow/status/jysvai/deel-local-cli/test.yml?branch=main&logo=github&logoColor=white&label=Node.js%20CI)](https://github.com/jysvai/deel-local-cli/actions/workflows/test.yml)
 [![CodeQL](https://img.shields.io/github/actions/workflow/status/jysvai/deel-local-cli/codeql.yml?branch=main&logo=github&logoColor=white&label=CodeQL)](https://github.com/jysvai/deel-local-cli/actions/workflows/codeql.yml)
-[![tests](https://img.shields.io/badge/tests-4%2C932%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/ko/develop.md)
+[![tests](https://img.shields.io/badge/tests-5%2C899%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/en/develop.md)
 [![dependencies](https://img.shields.io/badge/dependencies-0-1a7f37)](https://www.npmjs.com/package/deel-local-cli?activeTab=dependencies)
 [![ESM](https://img.shields.io/badge/ESM-Node%2020%2B-5FA04E?logo=javascript&logoColor=white)](package.json)
-[![network](https://img.shields.io/badge/network-127.0.0.1%20only-1a7f37?logo=wireguard&logoColor=white)](#데이터가-나가는-길)
-[![telemetry](https://img.shields.io/badge/telemetry-none-1a7f37?logo=ghostery&logoColor=white)](#데이터가-나가는-길)
+[![network](https://img.shields.io/badge/network-127.0.0.1%20only-1a7f37?logo=wireguard&logoColor=white)](#where-your-data-can-go)
+[![telemetry](https://img.shields.io/badge/telemetry-none-1a7f37?logo=ghostery&logoColor=white)](#where-your-data-can-go)
-**[English](README.en.md)** · [사내 반입 안내](#사내-반입) · [문제 해결](#문제-해결) · [자세한 문서](docs/ko/)
+**[한국어](README.ko.md)** · [Corporate review](#corporate-review-package) · [Troubleshooting](#troubleshooting) · [Full docs](docs/en/)
 </div>
 ---
-```
- ╭──────────────────────────────────────────────────────────────╮
- │ deel  OpenAI 호환 규격                                        │
- │                                                              │
- │ 모델    qwen2.5-coder:7b  (40k 토큰)                          │
- │ 보냄    이 컴퓨터 안 127.0.0.1:11434  ← 여기 말고는 어디로도 안 갑니다  │
- │ 연결    스트리밍 · 도구 · 추론 조절                              │
- │ 폴더    C:\work\myproject                                     │
- │ 승인    ⏵⏵ 자동 승인  — 안 묻고 고칩니다. 되돌리기(/undo)가 안전망입니다 │
- │         Shift+Tab 으로 바꿉니다  ·  Tab 은 치던 / 명령을 채웁니다   │
- │ 이 PC   스킬 337 · 명령 127 · 플러그인 42                       │
- ╰──────────────────────────────────────────────────────────────╯
- /help 명령 목록   /think 추론 강도   Ctrl+C 중단·끝내기
+### The first thing you see answers the only question that matters
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-head-en-dark.svg">
+  <img alt="deel startup panel: model, where it sends, link capabilities, folder, approval mode" src="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-head-en-light.svg" width="900">
+</picture>
+**`sends to  this machine 127.0.0.1 ← and nowhere else`.** Not in a policy document —
+on screen, every time you start. The `⌂` in front stays in the status bar for the whole
+session and turns into `↗` the moment traffic would leave. A real capture, not a mockup:
+`node tools/shot.mjs` regenerates every image on this page from a live run.
+<br>
- ▏myproject · qwen2.5-coder:7b ▏ ▰▰▱▱▱▱▱▱▱▱ 22% 28k/128k ▏ ◎ 종합 · ◇ medium·절약 · ⏵⏵ 자동
- ❯ 로그 형식 통일해줘
+Then you give it work, and it goes and does it:
-  ❊ Grep(console.log)
-    └ 1개 파일 · 1건
-  ◧ Read(src/runner.js)
-    └ 5줄
-  ◈ Edit(src/runner.js)
-    └ 1군데
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-chat-en-dark.svg">
+  <img alt="deel doing a task end to end: Grep, Read, Edit with an inline diff, and the file it wrote" src="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-chat-en-light.svg" width="900">
+</picture>
-  ▌ 로그 호출을 logger 형식으로 통일했습니다. runner.js 한 군데를 고쳤습니다.
+Every number in that image is real — the tools ran against real files. Only the model is a
+stub on `127.0.0.1`, so the capture is reproducible; the tool calls, the diff and the file
+summary are what deel actually printed.
-  ── 4.2초 · 도구 3회 · ↑3,900 ↓180
+---
+## 60 seconds
+```bash
+npm i -g deel-local-cli    # 0 dependencies, no install scripts
+deel setup                 # point it at Ollama, LM Studio, or your gateway
+deel                       # start working in the current folder
 ```
+No account, no sign-up, no telemetry. If you already run Ollama or LM Studio,
+`deel setup` finds it — `deel scan` lists every local runtime and model on the machine.
 ---
-## 목차
-- [왜 만들었나](#왜-만들었나)
-- [무엇이 다른가](#무엇이-다른가)
-- [빠른 시작](#빠른-시작)
-- [데이터가 나가는 길](#데이터가-나가는-길)
-- [로컬 모델 여러 개 쓰기](#로컬-모델-여러-개-쓰기)
-- [대화 중 명령](#대화-중-명령)
-- [작업 모드](#작업-모드)
-- [쉬움 · 개발자](#쉬움--개발자)
-- [도구](#도구)
-- [한글 문서와 엑셀](#한글-문서와-엑셀)
-- [만든 웹을 그 자리에서 띄웁니다](#만든-웹을-그-자리에서-띄웁니다)
-- [스킬·플러그인](#스킬플러그인)
-- [추론 강도](#추론-강도)
-- [자동 압축](#자동-압축)
-- [대화 이어하기](#대화-이어하기)
-- [밖에서 도구 붙이기 (MCP)](#밖에서-도구-붙이기-mcp)
-- [에디터 안에서 쓰기 (ACP)](#에디터-안에서-쓰기-acp)
-- [비밀이 새지 않게](#비밀이-새지-않게)
-- [안전망](#안전망)
-- [사내 반입](#사내-반입)
-- [설정](#설정)
-- [문제 해결](#문제-해결)
-- [개발](#개발)
-- [릴리스 노트](#릴리스-노트)
-여기는 **요약**입니다. 절마다 붙은 링크를 따라가면 그 안의 이야기가 나옵니다.
-| 자세한 문서 | 무엇이 있나 |
+<details>
+<summary><b>Contents</b> — every section on this page</summary>
+<br>
+- [Why this exists](#why-this-exists)
+- [What's different](#whats-different)
+- [Quick start](#quick-start)
+- [Where your data can go](#where-your-data-can-go)
+- [Connecting a vendor API](#connecting-a-vendor-api)
+- [Keys that expire (corporate gateways)](#keys-that-expire-corporate-gateways)
+- [Multiple local runtimes](#multiple-local-runtimes)
+- [Slash commands](#slash-commands)
+- [Work modes](#work-modes)
+- [Simple vs developer](#simple-vs-developer)
+- [Tools](#tools)
+- [Korean text and Excel](#korean-text-and-excel)
+- [Serving what you built](#serving-what-you-built)
+- [Skills and plugins](#skills-and-plugins)
+- [Reasoning effort](#reasoning-effort)
+- [Auto-compaction](#auto-compaction)
+- [Resuming a conversation](#resuming-a-conversation)
+- [Attaching tools from outside (MCP)](#attaching-tools-from-outside-mcp)
+- [Inside your editor (ACP)](#inside-your-editor-acp)
+- [Keeping secrets out of the conversation](#keeping-secrets-out-of-the-conversation)
+- [Safety](#safety)
+- [Corporate review package](#corporate-review-package)
+- [Configuration](#configuration)
+- [Troubleshooting](#troubleshooting)
+- [Development](#development)
+- [Release notes](#release-notes)
+</details>
+This page is the **summary**. Each section links to the detail behind it.
+| Full docs | What is in there |
 |---|---|
-| [모델 다루기](docs/ko/models.md) | 급과 창 크기 · 국산 모델 이름표 · 켤 때 프로젝트 읽기 |
-| [화면과 조작](docs/ko/interface.md) | 입력칸 · 작업 모드 · 쉬움과 개발자 · 무엇을 묻고 무엇을 그냥 하나 |
-| [도구 자세히](docs/ko/tools.md) | `Outline` · `Verify` · `Task` · `Jobs` · `Append` · `Def`/`Refs` · 편집 매칭 |
-| [한글 문서와 엑셀](docs/ko/documents.md) | hwpx·docx·pptx·**PDF** · 인코딩 · 엑셀 → CSV |
-| [늘려 쓰기](docs/ko/extend.md) | 스킬 · 플러그인 · MCP · ACP |
-| [속도와 씀씀이](docs/ko/tuning.md) | 단계별 추론 강도 · 프리픽스 캐시 · 컨텍스트 길이 |
-| [안전망과 사내 반입](docs/ko/safety.md) | 되돌리기 · 작업 범위 · 감사기록 · 심사 서류 |
-| [설정](docs/ko/config.md) · [개발](docs/ko/develop.md) | 환경변수 · 실행 옵션 · 검사 돌리기 · 폴더 구조 |
-| [릴리스 노트](docs/ko/releases.md) | [1.6.1](docs/ko/releases.md#161) · [1.6.0](docs/ko/releases.md#160) · [1.5.8](docs/ko/releases.md#158) · [1.5.7](docs/ko/releases.md#157) · [1.5.6](docs/ko/releases.md#156) · [1.5.5](docs/ko/releases.md#155) · [1.5.4](docs/ko/releases.md#154) · [1.5.3](docs/ko/releases.md#153) · [1.5.2](docs/ko/releases.md#152) · [1.5.1](docs/ko/releases.md#151) · [1.5.0](docs/ko/releases.md#150) · [1.4.3](docs/ko/releases.md#143) · [1.4.2](docs/ko/releases.md#142) · [1.4.1](docs/ko/releases.md#141) · [1.4.0](docs/ko/releases.md#140) · [1.3.0](docs/ko/releases.md#130) · [1.2.0](docs/ko/releases.md#120) |
+| [Models](docs/en/models.md) | Grade and window size · Korean-model presets · project detection |
+| [The screen](docs/en/interface.md) | The input box · work modes · simple vs developer · what it asks about |
+| [Tools in depth](docs/en/tools.md) | `Outline` · `Verify` · `Task` · `Jobs` · `Append` · `Def`/`Refs` · edit matching |
+| [Korean documents and Excel](docs/en/documents.md) | hwpx/docx/pptx/**PDF** · encoding · Excel → CSV |
+| [Extending](docs/en/extend.md) | Skills · plugins · MCP · ACP |
+| [Speed and spend](docs/en/tuning.md) | Per-stage effort · the prefix cache · context length |
+| [Safety and corporate review](docs/en/safety.md) | Undo · working scope · audit log · the review package |
+| [Configuration](docs/en/config.md) · [Development](docs/en/develop.md) | Env vars · run flags · running the tests · folder layout |
+| [Release notes](docs/en/releases.md) | [1.7.x](docs/en/releases/1.7.md) · [1.6.x](docs/en/releases/1.6.md) · [1.5.x](docs/en/releases/1.5.md) · [1.4.x](docs/en/releases/1.4.md) · [1.3.x](docs/en/releases/1.3.md) · [1.2.x](docs/en/releases/1.2.md) |
 ---
-## 왜 만들었나
+## Why this exists
-사내 보안 정책이 **미승인 소프트웨어 반입**을 막으면, 코딩 에이전트 도구는 대부분 쓸 수 없습니다.
-의존성 수백 개가 딸려 오고, 설치할 때 스크립트가 돌고, 어디로 통신하는지 한 줄로 답할 수 없기 때문입니다.
+When a corporate security policy blocks **unapproved software**, most coding-agent tools are
+unusable: hundreds of transitive dependencies, scripts that run at install time, and no
+one-line answer to "where does it send my code?"
-deel 은 그 심사를 통과하는 것을 목표로 만들었습니다.
+deel is built to pass that review.
 | | deel |
 |---|---|
-| 외부 의존성 | **0개** — Node 내장 기능만 |
-| 설치 스크립트 | **없음** — 압축 풀고 바로 실행 |
-| 소스가 나가는 자리 | **딱 한 곳** — 직접 설정한 주소 |
-| 필요한 것 | Node 20 이상 |
+| External dependencies | **0** — Node built-ins only |
+| Install scripts | **none** — unzip and run |
+| Where source can go | **one address** — the one you configured |
+| Requirement | Node 20+ |
-직접 확인하실 수 있습니다.
+Verify it yourself:
 ```bash
 npm view deel-local-cli dependencies   # {}
-npm view deel-local-cli scripts        # install/postinstall 없음
-deel audit                             # 심사서 전문 출력
+npm view deel-local-cli scripts        # no install/postinstall
+deel audit                             # full review sheet
 ```
 ---
-## 무엇이 다른가
+## What's different
-로컬 모델을 상대하는 코딩 에이전트는 몇 개 있습니다. 그런데 **로컬로 돌리는
-걸 전제로 속을 다시 설계한** 것은 드뭅니다.
+A handful of coding agents can talk to a local model. Far fewer were
+**redesigned inside for running locally.**
-| | 다른 도구 | deel |
+| | Other tools | deel |
 |---|---|---|
-| `/undo` | 파일만 되돌린다 — 대화는 그 일이 있었다고 믿는 채로 | **대화까지** 같이 되감는다 |
-| 긴 대화 | 클라우드가 안 느끼는 비용을 로컬에서도 그대로 짊어진다 | 프리픽스 캐시가 **살아남게** 순서를 설계 |
-| 작은 모델의 편집 | 공백 하나 틀려도 실패 | 성공률 20%→**100%**, 엉뚱한 곳 0건 |
-| 국산 모델 | 겪어 보기 전엔 모른다 | 공개 문서로 **미리** 안다 |
-| "다 됐습니다" | 확인 안 된 것도 됐다고 한다 | `/evidence`·`/export` — **안 된 것까지** 적는다 |
-| MCP·ACP | SDK 가 필요하다 | `child_process` + `JSON` 뿐 |
-| 심사 서류 | 사람이 손으로 써서 실제와 어긋난다 | **코드가 소스를 훑어서** 만든다 |
+| `/undo` | rolls back files only — the conversation still believes it happened | rewinds **the conversation too** |
+| Long conversations | pay a cost cloud tools never feel, unchanged, locally | ordering designed so the prefix cache **survives** |
+| Edits on small models | fail on a single whitespace mismatch | 20%→**100%** success, 0 wrong-location edits |
+| Korean models | unknown until you've run them | known **in advance** from public docs |
+| "Done" | says so even for what wasn't checked | `/evidence` / `/export` — **unproven items included** |
+| MCP · ACP | need an SDK | `child_process` + `JSON`, nothing else |
+| Compliance paperwork | hand-written, drifts from reality | **generated by scanning the source** |
 <br>
-#### `/undo` 는 파일과 대화를 같이 되감습니다
+#### `/undo` rewinds the conversation along with the files
-파일만 되돌리면 모델은 방금 그 편집을 했다고 계속 믿고 다음 턴을 그 위에
-쌓습니다 — 화면에는 아무 일도 없었던 것처럼 보입니다. deel 은 되돌린 만큼
-오간 메시지도 같이 접습니다. 접다가 도구 호출의 짝이 어긋나면 API 가 400 을
-내므로, 짝을 다시 맞추는 로직(`repairToolPairs`)까지 같이 돕니다.
+Roll back only the files and the model still believes it just made that edit
+— it builds the next step on a premise that no longer holds, and nothing on
+screen says otherwise. deel folds the messages back in lockstep with the
+files. Folding can orphan a tool call, which the server answers with a 400,
+so the same pass repairs the pairing (`repairToolPairs`).
-#### 긴 대화에서 로컬 모델이 갈수록 느려지는 이유를 직접 잡았습니다
+#### Fixed the hidden reason local models get slower as a conversation grows
-Ollama·llama.cpp 는 프롬프트 앞부분이 한 글자라도 바뀌면 그 뒤 전부를 다시
-계산합니다. 클라우드 API 는 이 비용을 안 느끼니 신경 쓸 이유가 없지만,
-로컬로 돌리는 사람에게는 대화가 길어질수록 턴마다 지연이 쌓입니다. deel 은
-매 턴 바뀔 수 있는 것(모드·핀)을 프롬프트 **맨 끝**으로 보내고, Ollama 에는
-`keep_alive: 60m` 을 같이 보내 앞부분이 캐시에 그대로 남게 합니다. 이 순서는
-검사(`test/cache.test.js`)가 지킵니다.
+Ollama and llama.cpp only reuse computation when a request's prefix exactly
+matches the last one — change one character near the front and everything
+after it, the whole conversation, gets recomputed. A cloud API never pays
+this cost, so cloud-first tools have no reason to care; someone running
+locally feels it compound every turn. deel pushes what can change per turn
+(mode, pins) to the **end** of the prompt and sends Ollama `keep_alive: 60m`
+so the front stays cached. The ordering is enforced by a test
+(`test/cache.test.js`).
-#### 작은 모델도 편집이 실제로 성공합니다
+#### Edits actually succeed on small models
-작은 로컬 모델은 고치려는 문자열을 공백 하나까지 완벽히 재현하지 못하는
-경우가 흔합니다. `npm run bench` 로 잰 내부 벤치마크에서, 정확히 일치만
-요구하던 옛 방식은 성공률 20% 였습니다. 지금 방식(공백·들여쓰기를 단계적으로
-완화)은 **100%** — 그러면서도 엉뚱한 곳을 고친 건수는 두 방식 다 **0건**
-입니다. 모호하면 찾지 못했다고 말할지언정 짐작해서 고치지 않습니다.
+Small local models often can't reproduce the exact whitespace of the string
+they're trying to edit. The internal benchmark (`npm run bench`) measured
+20% success for the old exact-match-only approach. The current approach
+(stepped whitespace/indent tolerance) measures **100%** — and both approaches
+land at **0** wrong-location edits. When it's ambiguous, it says so instead
+of guessing.
-#### 국산 모델은 겪어 보기 전에 압니다
+#### Korean models are known before you've ever run them
-EXAONE·HyperCLOVA X·Kanana·Midm·Solar 는 공개 문서로 확인 가능한 버릇(예:
-추론형 여부)을 deel 이 미리 알고 시작합니다. 다른 도구는 이 모델들을 한
-번도 못 만나 본 채로 취급하고, 사람이 열 몇 턴을 겪어야 요령이 붙습니다.
+EXAONE, HyperCLOVA X, Kanana, Midm, and Solar get whatever's verifiable from
+public documentation (e.g., whether a model is a reasoning model) applied
+before the first prompt. Other tools meet these models cold, and it takes a
+dozen-plus turns of trial and error before anyone learns their quirks.
-#### "다 됐습니다" 대신 증명서를 냅니다
+#### "Done" comes with a receipt, not just a claim
-`/evidence` 와 `/export` 는 무엇을 바꿨는지뿐 아니라 **무엇을 확인하지
-못했는지**까지 적습니다. AI 코딩 도구가 사람을 제일 잘 속이는 순간이 자신
-있게 "됐습니다" 라고 말할 때라는 걸 알기 때문입니다. `/export` 는 바깥
-주소가 하나도 없는 자기완결 HTML 이라 폐쇄망 어디서든 열립니다.
+`/evidence` and `/export` record what wasn't verified alongside what was —
+because the moment an AI coding tool is most likely to mislead someone is
+exactly the moment it confidently says "done." `/export` is a self-contained
+HTML file with zero outbound links, so it opens anywhere, including an
+air-gapped network.
-#### MCP·ACP 를 SDK 없이 붙였습니다
+#### MCP and ACP, with no SDK
-Model Context Protocol 과 Agent Client Protocol 은 둘 다 표준입출력으로 줄
-단위 JSON-RPC 2.0 을 주고받는 게 전부입니다. deel 은 `child_process` 와
-`JSON` 만으로 둘 다 구현했습니다 — 의존성 0개가 "기능을 뺀 결과" 가 아니라
-"안 필요해서" 라는 걸 이 두 가지가 보여 줍니다.
+Both the Model Context Protocol and the Agent Client Protocol are just
+newline-delimited JSON-RPC 2.0 over stdio. deel implements both with nothing
+but `child_process` and `JSON` — proof that zero dependencies isn't a
+capability given up, it's a capability that was never needed.
-#### 심사 서류를 손으로 안 씁니다
+#### Compliance paperwork it doesn't hand-write
-`deel pack` 이 만드는 반입심사서·SBOM·감사 사양은 **코드가 소스를 훑어서**
-만든 겁니다. 손으로 적은 서류는 언젠가 실제와 어긋나고, 담당자가 그걸 한 번
-발견하면 나머지 서류도 안 믿습니다.
+The import-review report, SBOM, and audit spec that `deel pack` produces are
+generated **by scanning the actual source**, not typed by a person.
+Hand-written paperwork eventually drifts from reality, and the moment a
+reviewer catches one drifted claim, they stop trusting the rest of it.
 ---
-## 빠른 시작
+## Quick start
+### The screen speaks your language
+deel is written in Korean — the code, the function names, the comments. That part stays.
+What you see on screen does not have to. Four screen languages ship: **한국어 · English ·
+日本語 · 中文**.
+> **How this is kept honest:** `/lang` counting the table is not enough — it can only count
+> strings that made it *into* the table, and for a long time the tool result summaries and the
+> thinking indicator never did. So a test starts deel in each language and reads the screen:
+> `test/langleak.test.js` walks seven screens and fails if a Korean character shows up on an
+> English one. It also fails on `1 files`, and on a stray `·` left dangling at the end of a line.
+```bash
+DEEL_LANG=en deel        # this run only  (also ja, zh)
+/lang en                 # and remember it
+/lang ja                 # 日本語
+/lang zh                 # 中文
+/lang                    # how much is translated so far
+```
+Nothing ever comes through blank. A line that has not been translated falls back to English
+first and Korean second — so a Japanese or Chinese screen degrades to English, not to Korean —
+and `/lang` prints exactly how many strings are covered.
+What the model reads follows the same switch. Set it to English and the rules, the mode
+instructions, and the tool descriptions all go out in English — so the model answers you in
+English instead of Korean. That side is cheaper, too: the part of the window that ships on every
+single request drops from about 4,900 tokens to about 3,450 — on a 32k model, from 15% of the
+window to 10.5%.
+Tool names and argument names stay Korean (`목적`, `할일`, `번호`). Those are identifiers, not
+prose — rename them and the tool stops being called at all.
-### 설치
+### Install
 ```bash
 npm install -g deel-local-cli
 ```
-설치가 싫으면 소스를 받아 그대로 쓰셔도 됩니다. `npm install` 이 필요 없습니다.
+Or skip installing entirely — there is no `npm install` step:
 ```bash
 git clone https://github.com/jysvai/deel-local-cli
 node deel-local-cli/bin/deel.js
 ```
-> **주의** — 홈 디렉터리(`~`)에서 `npm install` 하지 마세요. 거기에 `node_modules` 가 생기면
-> 이후 모든 npm 명령이 그 폴더를 훑어서 무관한 패키지 경고를 냅니다. `-g` 로 설치하거나 `npx` 를 쓰세요.
+> **Note** — do not run `npm install` in your home directory. A `node_modules` there makes every
+> later npm command scan it and report warnings about unrelated packages. Use `-g` or `npx`.
-### 연결 정하기
+### Point it at a model
-이 PC 에 떠 있는 로컬 서버를 훑어서 고르는 방법:
+Scan this machine and pick one:
 ```bash
 deel scan --pick
 ```
-주소를 직접 넣는 방법 (사내 게이트웨이는 이쪽):
+Or enter an address directly (use this for a corporate gateway):
 ```bash
 deel setup
 ```
-### 시작
+### Start
-작업할 폴더에서 `deel` 을 칩니다. **그 폴더가 작업 범위가 되고, 밖의 파일은 읽지도 쓰지도 못합니다.**
+Run `deel` in the folder you want to work in. **That folder becomes the scope — files outside it
+cannot be read or written.**
 ```bash
 cd C:\work\myproject
@@ -241,376 +301,491 @@ deel
 ---
-## 데이터가 나가는 길
+## Where your data can go
-코딩 에이전트는 소스 코드를 통째로 모델에 보냅니다. **그 주소가 어디인지가 전부입니다.**
-말로 보장하는 대신 코드가 막습니다 — `src/safety/network.js` 가 요청마다 확인하고,
-허용 목록에 없으면 요청을 만들지도 않습니다.
+A coding agent ships your whole source to a model. **The address is everything.**
+Rather than promising in prose, the code enforces it: `src/safety/network.js` checks every request
+and never builds one for an address that is not on the allow-list.
 ```
- [A] 모델 게이트웨이 ─── 소스 코드가 나가는 유일한 길
-     setup 에서 정한 한 자리만. 모델을 바꾸면 이전 자리는 닫힙니다.
+ [A] Model gateway ────── the only path your source travels
+     One address, set in `setup`. Switching models closes the previous one.
- [B] 웹 읽기 (WebFetch) ─ 받아 오기만 하는 길
-     GET 만. 본문 0바이트. 사내망·로컬 주소는 거절. 다녀온 곳은 전부 기록.
+ [B] Web read (WebFetch) ─ receive-only
+     GET only, zero-byte body. Private/loopback addresses refused. Every visit logged.
- [C] 플러그인 받기 ────── /plugin install 을 칠 때만 잠깐
+ [C] Plugin fetch ─────── open only while /plugin install runs
- [D] MCP 서버 ─────────── 딴 자식 프로세스, 남의 프로그램
-     .deel/mcp.json 에 사람이 직접 적어야만 뜹니다. 기본은 꺼져 있습니다.
+ [D] MCP servers ──────── a separate child process, someone else's program
+     Only starts if a human writes it into .deel/mcp.json. Off by default.
 ```
-A·B·C 는 deel 이 직접 만드는 요청이라 하나씩 걸러낼 수 있습니다. **[D] 는
-다릅니다** — MCP 서버는 별도 프로세스라 그 안에서 무슨 소켓을 여는지 코드로
-볼 수 없습니다. 그래서 `--offline` 일 때는 요청을 거르는 대신 **그 서버
-자체를 아예 띄우지 않습니다** — 막을 수 없는 것을 막았다고 말하지 않습니다.
+A, B, and C are requests deel makes itself, so each one can be filtered.
+**D is different** — an MCP server is its own process; there is no way to see
+what sockets it opens from the outside. So under `--offline`, instead of
+filtering its requests, deel **never starts the server at all** — it doesn't
+claim to have blocked what it can't actually see.
-`--offline` 을 주면 **B·C·D 가 모두 막히고 이 컴퓨터 안으로만** 다닙니다.
+Pass `--offline` and **B, C, and D are all closed** — traffic stays on this machine.
 ```bash
 deel --offline
 ```
-무엇이 어디로 갈 수 있는지는 켤 때 화면 맨 위에 늘 적혀 있습니다.
+The destination is printed at the top of every session:
 ```
- 보냄    이 컴퓨터 안 127.0.0.1:11434  ← 여기 말고는 어디로도 안 갑니다
+ deel 1.8.0  ⌂ inside
+ Sends to this machine 127.0.0.1:11434  ← nowhere else
 ```
-수집·전송하는 것이 없습니다. 텔레메트리, 사용 통계, 오류 보고 전부 없습니다.
-대화 기록·되돌리기 이력·설정은 작업 폴더의 `.deel/` 안에만 남습니다.
+### Three run modes
-> 검증: `npm test` 의 network·web·mcp 검사 123항목. 허용되지 않은 서버에 실제로
-> 요청이 **한 건도 닿지 않는지**, `--offline` 일 때 MCP 서버가 **한 번도 안
-> 뜨는지**까지 진짜 서버를 띄워서 확인합니다.
+Through 1.6 the only lock was `--offline`, and **the default was open**. One
+line in `.deel/config.json` pointing outside was enough. The screen did show
+`↗`, but that is a *notice*, not a lock.
+| Mode | How | On an external address |
+|---|---|---|
+| `⌂ inside` | `deel` (default) | **Asks.** Say yes once and that connection stops asking |
+| `↗ outside` | `deel online` · `--online` | Does not ask |
+| `⛊ sealed` | `deel offline` · `--offline` | Ignores even remembered permission (strongest) |
+**Both the address and the permission are required.** Changing the address
+alone does not get you out.
+Local and intranet ranges (`127.x` · `10.x` · `192.168.x` · `172.16-31.x`) pass
+in all three modes — `offline` does not mean "no internet," it means "nothing
+leaves the company."
+Nothing is collected or transmitted. No telemetry, no usage stats, no crash reporting.
+Conversation history, undo snapshots and config live only in `.deel/` inside your working folder.
+> Verified by 159 checks in `npm test` (network + web + mcp), including bringing up a real
+> server and confirming that **not a single request reaches it** when it is not allow-listed,
+> and that an MCP server **never starts** under `--offline`.
 ---
-## 로컬 모델 여러 개 쓰기
+## Connecting a vendor API
-로컬 런타임은 보통 하나만 쓰지 않습니다. Ollama 로 작은 모델을 돌리면서
-LM Studio 로 큰 모델을 띄워 두기도 합니다. `deel scan` 이 알려진 자리 13곳을 동시에 두드려
-전부 찾아냅니다.
+Local models are the default and that does not change. But "we have no GPU
+in-house" and "just this one task on a bigger model" are real situations, so
+vendor APIs can connect. **The modes above guard that door.**
+```bash
+deel setup
+```
+Instead of asking for a URL, it asks **where you're connecting**.
+```
+1. I only have a key — I'll figure out where it goes    1 blank
+2. Enter an address (corporate gateway · local)          2 blanks
+3. OpenAI (GPT)                                          1 blank
+4. Anthropic (Claude)                                    1 blank
+5. Google (Gemini)                                       1 blank
+6. AWS Bedrock                                           2 blanks
 ```
-$ deel scan
-── 로컬 모델 서버 훑기 ───────────────────────────────────────────────
-  127.0.0.1 의 알려진 자리 13곳을 두드립니다. 바깥으로는 나가지 않습니다.
+Option 1 is the point — the key prefix decides which single vendor is asked.
-  ✓ 3곳 찾음
+```
+❯ sk-ant-api03-••••
+  ✓ Looks like an Anthropic (Claude) key. (the key starts with sk-ant-)
+    It is not thrown at every vendor in turn.
+```
+Probing vendors one by one would send an Anthropic key to OpenAI's server and
+then to Google's. You get a 401 and stop — but **the key has already left.**
+So an unrecognized key is never guessed at; you are asked.
+Bedrock asks for a region — five including Seoul (`ap-northeast-2`), plus
+"enter it yourself." Claude has a different wire shape, absorbed in six places
+([1.7.0 release notes](docs/en/releases/1.7.md#170)).
+### Going outside masks secrets in file contents too
+While everything stayed local, text read from files was deliberately **not**
+masked: mask it and the model writes the mask back into the file, destroying
+your real key.
+Going outside flips that trade. One `Read` puts your whole `.env` into someone
+else's server log, and that cannot be undone. The other side is now handled
+elsewhere — `Write`, `Append` and `Edit` refuse to write a mask back into a file.
-  ◆ Ollama      127.0.0.1:11434   Ollama 규격   36ms
+### You can see what it costs
+```
+❯ ─ 12.4s · 3 tools · ↑8.2k ↓1.1k · $0.0271
+```
+**There is no built-in price table.** Prices change whenever a vendor decides,
+and a table baked into source would have the tool confidently printing wrong
+amounts six months later. Write them in `.deel/config.json` — dollars per
+million tokens:
+```json
+"요금": { "claude-opus-4-6": { "입력": 0, "출력": 0, "기준": "2026-09-01" } }
+```
+The amount is shown with **where it came from and as of when**, and after six
+months it is marked stale. Unknown means nothing is printed — a local-only
+session never sees money at all.
+---
+## Keys that expire (corporate gateways)
+Corporate gateways do not hand out a fixed key. They hand out a one-hour token, behind a
+corporate login. Pasting one in works until lunch, and then you get `HTTP 401` — a message
+that **does not distinguish "wrong key" from "old key."** People go re-issue a key that was
+never the problem.
+So write down *how to get a key* instead of the key:
+```json
+"열쇠받기": {
+  "명령": "az account get-access-token --resource api://ai-gw --query accessToken -o tsv",
+  "수명": 3600
+}
+```
+It runs right before a request, keeps the result in memory only, and fetches a fresh one a
+minute before expiry — a token alive when the request left and dead when it arrived is
+exactly that 401. On a 401 it fetches once more and retries **once**; a second 401 means you
+genuinely lack access.
+| | |
+|---|---|
+| You write the path | Nothing is auto-detected. Guessing at `az` on your PATH would mean you no longer know when this program runs what |
+| Separate process | Never `import`ed — code inside our process would see other keys and the conversation |
+| Asked once per session | Not once per fetch. Three prompts and people just press the key |
+| Not while sealed | An `--offline` session does not go out to a login portal |
+| Never written to disk | Memory only, for the life of the session |
+| Banner output rejected | `Logged in as …` followed by a token gets a 400 from the gateway, indistinguishable on screen from a wrong key. The first line is shown back so you know to add `--query` |
+`/status` says `Key store  fetched · 52 min left` — not "stored", because we are not holding
+it. An organisation can set the same block in the [managed policy](docs/en/config.md) file,
+where it overrides the user's config and is never asked about.
+---
+## Multiple local runtimes
+People rarely run just one. `deel scan` knocks on 13 known ports concurrently and identifies
+each runtime from its **response**, not its port number — Ollama by `/api/version`,
+LM Studio by `/api/v0/models`, llama.cpp by `/props`. Unrecognised ones are marked as a guess.
+```
+$ deel scan
+  ✓ found 3
+  ◆ Ollama      127.0.0.1:11434   Ollama API      36ms
       · qwen2.5-coder:7b            7B · 4.4GB
       · llama3.2:1b                 1B · 1.2GB
-  ◆ LM Studio   127.0.0.1:1234     OpenAI 호환    7ms
+  ◆ LM Studio   127.0.0.1:1234     OpenAI-compat    7ms
       · devstral-small-2507
-  ◆ llama.cpp   127.0.0.1:8080     OpenAI 호환    7ms
+  ◆ llama.cpp   127.0.0.1:8080     OpenAI-compat    7ms
       · gemma-3-4b-it
-  합계  서버 3곳 · 모델 6개
-  추천  Ollama · qwen2.5-coder:7b
-        코딩용 모델 · 도구 호출을 잘하는 계열
+  Recommended  Ollama · qwen2.5-coder:7b
 ```
-포트로 단정하지 않고 **응답을 보고** 런타임을 구분합니다 — Ollama 는 `/api/version`,
-LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추정)` 이라고 밝힙니다.
-| 명령 | 하는 일 |
+| Command | What it does |
 |---|---|
-| `deel scan` | 찾아서 보여주기만 |
-| `deel scan --pick` | 목록에서 골라 등록 |
-| `deel scan --save` | 찾은 것 전부 등록 |
-| `deel scan --ports 9000,9100` | 기본 자리 말고 더 볼 포트 |
-| `deel scan --host <주소>` | 기본은 `127.0.0.1` |
-| `deel scan --key <키>` | 키가 필요한 로컬 서버일 때 |
+| `deel scan` | Show what is running |
+| `deel scan --pick` | Choose one from the list |
+| `deel scan --save` | Register everything found |
+| `deel scan --ports 9000,9100` | Extra ports to probe |
+| `deel scan --host <addr>` | Defaults to `127.0.0.1` |
-등록한 뒤에는 대화 중 `/model` 로 갈아탑니다. **대화 내용은 그대로 이어집니다.**
+Switch with `/model` mid-conversation — **the conversation carries over.**
-> **자세히** — 걸린 모델에 맞춰 스스로 바뀝니다 · 국산 모델은 겪기 전에 압니다 · 작은 창에서는 고정 몫을 줄입니다 · 켤 때 이 폴더가 무슨 프로젝트인지 읽습니다
+> **More** — It adapts to whatever model is attached · Korean models are known before they are experienced · Small windows get a smaller fixed share · On startup it reads what kind of project this folder is
 >
-> **[모델 다루기 읽기 →](docs/ko/models.md#로컬-모델-여러-개-쓰기)**
+> **[Models read →](docs/en/models.md#multiple-local-runtimes)**
 ---
-## 대화 중 명령
+## Slash commands
-이름은 Claude Code / Codex 관례에 맞췄습니다.
+Names follow Claude Code / Codex conventions.
-| 명령 | 하는 일 |
+| Command | What it does |
 |---|---|
-| `/help` | 명령 목록 |
-| `/bell [on|off]` | 다 됐을 때·물어볼 때 종소리와 창 제목 |
-| `/lang [ko|en|ja|zh] [시킬말]` | 화면 말 (한국어·English·日本語·中文 네 가지, 전부 다 채워져 있다). **시킬 말을 따로 줄 수 있다** — `/lang ko en` 이면 모델에게는 영어로 시키고 답은 한국어로 받는다(8k 창에서 고정 몫 23% 감소). 코드는 그대로 |
-| `/keys` | 이 터미널이 무슨 키를 보내는지 눌러서 확인 — 줄바꿈이 안 될 때 |
-| `/consult <프로필> <질문>` | 다른 모델에게 한 번 물어보기 — 지금 쓰는 것은 안 바꿈 |
-| `/export` | 이 대화를 **보고서 한 장**(HTML)으로 — 시킨 것·바뀐 것·확인한 것. 폐쇄망에서 여는 자기완결 파일 |
-| `/lsp [on\|off]` | 언어 서버 — 무엇이 깔려 있고 `Def`·`Refs` 를 쓸 수 있는지. `off` 는 고친 뒤 진단만 끔 |
-| `/context` | 무엇이 컨텍스트를 먹고 있는지 |
-| `/ctx [auto\|숫자\|자세히]` | 컨텍스트 **길이** — 모델에 맞춰 다시 재거나 직접 지정 |
-| `/out [숫자\|auto]` | 한 번에 받을 **답 길이** 상한 — 큰 파일이 잘리면 여기를 올립니다 |
-| `/grade [작음\|보통\|큼\|auto]` | 모델 **급** — 얼마나 알아서 하나. `/ctx` 와 다른 축입니다 |
-| `/compact` | 앞선 대화를 요약해서 접기 |
-| `/clear` | 대화 비우기 (연결·규칙은 유지) |
-| `/thread [new\|fork\|close\|번호]` | 대화 갈래 — 곁가지를 딴 자리에서. 연결·되돌리기는 같이 씁니다 |
-| `/learned [지우기]` | 쓰면서 저절로 알게 된 것 — 되는 명령·이 모델의 버릇 |
-| `/pin <말>` | 못 박기 — 접거나 요약해도 **안 지워지는** 말 |
-| `/evidence [파일]` | 증거 — 무엇을 바꿨고 무엇이 그걸 증명하나. **안 된 것도** 적습니다 |
-| `/commit [전부\|미리보기\|제목]` | 이번 대화가 바꾼 것만 담아 커밋. 메시지는 diff 와 증거에서. **push 는 안 합니다** |
-| `/model` | 연결·모델 바꾸기 |
-| `/model 카드` | 이 모델을 겪어 본 결과 — 그래서 deel 이 무엇을 바꿔 뒀는지 |
-| `/think <강도>` | 추론 강도 (`off·low·medium·high·max`) |
-| `/think 배분 <배분>` | 단계별 배분 (`균일·절약·깊게`) |
-| `/think 자세히` | 단계표 — 어느 단계를 어떤 강도·상한으로 도는지 |
-| `/mode <모드>` | 승인 정책 — 얼마나 물어보나 (`auto` · `confirm` · `strict`) |
-| `/work [모드]` | 작업 모드 — 무슨 일을 하는 중인가 |
-| `/auto` | 다시 맡기기 — 말을 보고 알맞은 모드로 저절로 옮겨 갑니다 |
-| `/code` `/plan` `/architect` `/debug` `/ask` `/orchestrator` | 작업 모드 바로 바꾸기 (그때부터 고정) |
-| `/level [수준]` | 화면에 무엇을 내놓을지 (`쉬움` · `개발자`) |
-| `/motion [기본\|기사\|동물\|사무실\|끔]` | 일하는 동안 뭐가 도나 — 그 자리에서 바뀌고 설정에 남습니다 |
-| `/undo [턴수]` | 파일 변경 되돌리기 |
-| `/diff [파일]` | 이번 대화에서 바뀐 파일 · 바뀐 자리 보기 |
-| `/preview [폴더\|파일\|off]` | 만든 웹을 이 자리에서 띄워 보기 — 브라우저가 같이 열립니다 |
-| `/tools` | 쓸 수 있는 도구 |
-| `/skills [검색어\|all\|off]` | 스킬 보기·검색·골라 올리기 |
-| `/plugin [install\|remove\|pack]` | 플러그인 관리 |
-| `/cost` | 이번 세션 사용량 |
-| `/status` | 연결 상태 |
-| `/scan [save]` | 이 PC 에 떠 있는 로컬 모델 서버 훑기 (`save` 면 바로 등록) |
-| `/sessions` | 이 폴더의 지난 대화 목록 |
-| `/recall <말>` | 지난 대화에서 **내용으로** 찾기 |
-| `/memory` | 대화가 끝나도 남는 기억 — 보기·적기·지우기 |
-| `/mcp` | 밖에서 붙인 도구(MCP) 서버 보기 |
-| `/init` | `DEEL.md` 규칙 파일 만들기 |
-| `/exit` | 끝내기 |
-`/scan` 과 `/sessions` 는 나가지 않고도 씁니다. 로컬 서버를 새로 켰거나 모델을
-바꿔 올렸을 때 `/scan save` → `/model` 두 번이면 대화를 이어둔 채로 갈아탑니다.
-**치지 않고 쓰는 것**
-| 키 | 무엇을 |
+| `/help` | Command list |
+| `/lang [ko\|en] [prompt lang]` | Screen language. **The prompt language is a separate axis** — `/lang en ko` instructs the model in Korean while answering you in English. Korean screen + English prompt cuts the 8k fixed share by 23% |
+| `/keys` | Press keys to see what your terminal actually sends — for when new lines will not work |
+| `/bell [on\|off]` | Ring and set the window title when a turn ends, or when deel needs an answer |
+| `/consult <profile> <question>` | Ask a second model one question. Your current model stays put |
+| `/export` | This conversation as a **one-page HTML report** — asked, changed, verified. Self-contained, opens on any network |
+| `/lsp [on\|off]` | Language servers — what is installed, and whether `Def`/`Refs` are available. `off` turns post-edit diagnostics off only |
+| `/context` | What is consuming the context window |
+| `/ctx [auto\|number]` | Context **length** — re-read it off the model, or set it yourself |
+| `/grade [small\|medium\|large\|auto]` | Model **grade** — how much it does on its own. A different axis from `/ctx` |
+| `/out [number\|auto]` | Cap on a **single reply** — raise it when large files get cut |
+| `/compact` | Summarise and fold older turns |
+| `/clear` | Clear the conversation (keeps link and rules) |
+| `/thread [new\|fork\|close\|n]` | Conversation threads — side work in its own context. Link and undo stay shared |
+| `/learned [clear]` | What deel has picked up on its own — commands that work here, this model's habits |
+| `/pin <text>` | Pin a line — folding and compaction **cannot reach it** |
+| `/evidence [file]` | Evidence — what changed, and what proves it. **What is unproven is listed too** |
+| `/commit [all\|preview\|title]` | Commits only what this session changed; message from the diff and the evidence. **Never pushes** |
+| `/model` | Switch connection / model |
+| `/model 카드` | Model card — what this model has actually done here, and what deel changed because of it |
+| `/think <level>` | Reasoning level (`off·low·medium·high·max`) |
+| `/think 배분 <profile>` | Per-stage profile (`even·save·deep`) |
+| `/think 자세히` | Stage table — which stage runs at which level and cap |
+| `/mode <mode>` | Approval policy — how much it asks (`auto` · `confirm` · `strict`) |
+| `/work [mode]` | Work mode — what kind of work you are doing |
+| `/auto` | Hand the wheel back — it picks the mode from what you type |
+| `/code` `/plan` `/architect` `/debug` `/ask` `/orchestrator` | Switch work mode directly (pins it) |
+| `/level [level]` | How much to show (`쉬움` simple · `개발자` developer) |
+| `/motion [plain\|knight\|animal\|office\|off]` | What animates while it works — takes effect at once, and is saved |
+| `/undo [turns]` | Revert file changes |
+| `/diff [file]` | Files changed this session, and the changed lines |
+| `/preview [folder\|file\|off]` | Serve what you built, right here — a browser opens with it |
+| `/tools` | Available tools |
+| `/skills [query\|all\|off]` | Browse, search, load skills |
+| `/plugin [install\|remove\|pack]` | Manage plugins |
+| `/cost` | Session usage |
+| `/status` | Connection status |
+| `/scan [save]` | Sweep this machine for local model servers (`save` registers them) |
+| `/sessions` | Past conversations in this folder |
+| `/recall <text>` | Search past conversations **by content** |
+| `/memory` | What persists across sessions — view, add, delete |
+| `/mcp` | Externally attached tools (MCP servers) |
+| `/init` | Create a `DEEL.md` rules file |
+| `/exit` | Quit |
+Discovered plugin commands are invoked as `/<plugin>:<name>`, with `$ARGUMENTS` substituted.
+`/scan` and `/sessions` work without leaving the session. If you just started another local
+server or loaded a different model, `/scan save` then `/model` switches over without losing
+the conversation.
+**Without typing**
+| Key | What it does |
 |---|---|
-| `Tab` | 치던 `/` 명령을 채웁니다. 치는 도중에 후보가 상자 아래에 뜹니다 |
-| `Shift+Tab` | 승인 방식 (`⏵⏵ 자동` → `⏵ 위험만` → `⏸ 모두`) |
-| `Ctrl+O` | 작업 모드 (`종합` → `코드` → `계획` → …) |
-| `↑` `↓` | 지난 입력 이력 |
-| `Ctrl+C` | 답하는 중이면 그 답만 끊고, 빈 줄에서 두 번이면 끝냅니다 |
-| 일하는 중에 그냥 치고 `Enter` | 하던 일을 안 버리고 방향만 틉니다 — 다음 걸음부터 반영 |
+| `Tab` | Completes the `/` command you are typing. Candidates appear under the box as you type |
+| `Shift+Tab` | Approval policy (`⏵⏵ auto` → `⏵ risky only` → `⏸ everything`) |
+| `Ctrl+O` | Work mode (`종합` → `코드` → `계획` → …) |
+| `↑` `↓` | Input history |
+| `Ctrl+C` | Stops the answer in progress; twice on an empty line quits |
+| Typing while it works, then `Enter` | Steers without throwing anything away — takes effect from the next step |
-한글 조합·붙여넣기·`Ctrl+A/E`·백스페이스는 전부 그대로 됩니다.
+Korean IME composition, paste, `Ctrl+A/E` and backspace all keep working.
-> **자세히** — @파일 로 바로 붙이기 · 도중에 멈추기 · 멈추지 않고 방향만 틀기
+> **More** — Attaching a file with @ · Interrupting · Steering without stopping
 >
-> **[화면과 조작 읽기 →](docs/ko/interface.md#대화-중-명령)**
+> **[The screen read →](docs/en/interface.md#slash-commands)**
 ---
-## 작업 모드
+## Work modes
-무슨 일을 하는 중인지에 따라 **줄 수 있는 도구와 추론 설정이 같이 바뀝니다.**
-`Shift+Tab` 으로 차례로 돌리거나, 이름을 그대로 치면 됩니다.
+What you are working on changes **which tools the model is given and how hard it thinks.**
+Cycle with `Shift+Tab`, or type the name.
-| 모드 | 하는 일 | 파일을 고치나 | 추론 |
+| Mode | For | Can edit files | Reasoning |
 |---|---|---|---|
-| `/auto` ◎ 종합 | **처음 값.** 말을 보고 알맞은 모드로 옮겨 간다 | 예 | 보통 (`save`) |
-| `/code` ◆ 코드 | 고치고 만든다 | 예 | 보통 (`save`) |
-| `/plan` ☰ 계획 | 먼저 계획만 세운다 | **아니오** | 깊게 (`deep`·high) |
-| `/architect` ◈ 설계 | 구조를 짠다 | **아니오** | 깊게 (`deep`·high) |
-| `/debug` ◉ 디버그 | 원인을 찾는다 | 예 | 깊게 · 단계 많이 (32) |
-| `/ask` ◇ 묻기 | 설명만 한다 | **아니오** | 얕게 (`low`) |
-| `/orchestrator` ❋ 총괄 | 큰 일을 쪼개서 | 예 | 단계 아주 많이 (40) |
+| `/auto` ◎ Auto | **Default.** Reads your message and switches for you | Yes | Normal (`save`) |
+| `/code` ◆ Code | Writing and fixing | Yes | Normal (`save`) |
+| `/plan` ☰ Plan | Planning first | **No** | Deep (`deep`·high) |
+| `/architect` ◈ Architect | Shaping structure | **No** | Deep (`deep`·high) |
+| `/debug` ◉ Debug | Finding causes | Yes | Deep, more steps (32) |
+| `/ask` ◇ Ask | Explaining only | **No** | Shallow (`low`) |
+| `/orchestrator` ❋ Orchestrator | Breaking up large work | Yes | Many steps (40) |
-읽기만 하는 모드에서는 `Write`·`Edit`·`Bash` 를 **모델에게 아예 보내지 않습니다.**
-"고치지 마세요" 라고 부탁하지 않습니다 — 모델은 부탁을 잊습니다. 없는 도구는 못 씁니다.
+In read-only modes, `Write`, `Edit` and `Bash` are **never sent to the model at all.**
+It is not asked politely not to edit — models forget requests. A tool that isn't there can't be used.
-`/mode` 와 헷갈리지 마세요. 둘은 다른 축입니다.
+Don't confuse this with `/mode`. They are separate axes:
-- `/mode` — **얼마나 물어보나** (auto · confirm · strict)
-- `/work` — **무슨 일을 하는 중인가** (위 일곱 가지)
+- `/mode` — **how much it asks you** (auto · confirm · strict)
+- `/work` — **what kind of work you are doing** (the seven above)
-`/think` 나 `/mode` 를 직접 고른 적이 있으면 그 선택이 우선합니다.
-모드가 사람이 고른 값을 덮어쓰지 않습니다.
+If you have explicitly set `/think` or `/mode`, your choice wins. A work mode never
+overrides something a person chose.
-> **자세히** — 저절로 옮겨 가기 (종합 모드)
+> **More** — Switching by itself (Auto mode)
 >
-> **[화면과 조작 읽기 →](docs/ko/interface.md#작업-모드)**
+> **[The screen read →](docs/en/interface.md#work-modes)**
 ---
-## 쉬움 · 개발자
+## Simple vs developer
-처음 켠 사람에게 명령 스무 개를 들이밀면 아무것도 못 고릅니다.
-그렇다고 기능을 잠그면 쓸 만해졌을 때 막힙니다. 그래서 **보이는 것만** 나눕니다.
+Twenty commands on first launch means nothing gets chosen. Locking features away means
+hitting a wall later. So only **what is shown** differs.
-| | 쉬움 (기본) | 개발자 |
+| | Simple (`쉬움`, default) | Developer (`개발자`) |
 |---|---|---|
-| `/help` 목록 | 자주 쓰는 것만 | 전부 |
-| 오류 문구 | 무엇을 하면 되는지 | 원래 문구 그대로 |
-| 안전 장치 | **똑같음** | **똑같음** |
+| `/help` listing | Common commands only | Everything |
+| Error messages | What to do about it | The original text |
+| Safety | **Identical** | **Identical** |
-`/level 개발자` 로 바꾸면 설정에 남아 다음에 켤 때도 이어집니다.
+`/level 개발자` is saved to config and persists across sessions.
-중요한 것 두 가지입니다.
+Two things matter here:
-- **감춘 것도 그대로 먹습니다.** 쉬움에서 `/think high` 를 쳐도 됩니다. 목록에 안 띄울 뿐입니다.
-- **초보라고 승인을 덜 받지 않습니다.** 되돌리기·작업 범위·위험 명령 차단은 두 수준이 같습니다.
-  초보일수록 되돌릴 수 있어야 합니다.
+- **Hidden commands still work.** `/think high` works in simple mode. It just isn't listed.
+- **Beginners do not get fewer safeguards.** Undo, workspace scope and dangerous-command
+  blocking are identical. A beginner needs the undo more, not less.
-> **자세히** — 입력칸 · 명령은 다 안 쳐도 됩니다 · 일하는 중에는 상자가 그대로 있습니다 · 왼쪽 그림도 같이 움직입니다 외 1개
+> **More** — The input box · You don't have to type the whole command · The box stays while it works · The picture on the left moves too and 1 more
 >
-> **[화면과 조작 읽기 →](docs/ko/interface.md#쉬움--개발자)**
+> **[The screen read →](docs/en/interface.md#simple-vs-developer)**
 ---
-## 도구
+## Tools
-이름과 인자를 Claude Code 와 같게 맞췄습니다. 그 관례로 쓰인 스킬·명령이 그대로 먹습니다.
+Names and arguments match Claude Code, so skills written for that convention work unchanged.
-| 도구 | 하는 일 |
+| Tool | What it does |
 |---|---|
-| `Read` | 파일 읽기 (줄 번호 · `offset`/`limit` 지원 · **엑셀은 CSV 로, hwpx·docx·pptx·PDF 는 글로 바꿔서**) |
-| `Write` | 파일 쓰기·덮어쓰기 (**여러 개는 `files` 배열로 한 번에**) |
-| `Append` | 파일 끝에 이어 붙이기 — **큰 파일을 나눠 쓰는 자리** |
-| `Edit` | 정확한 문자열 바꾸기 (`replace_all` · **여러 군데는 `edits` 배열로 한 번에**) |
-| `Move` | 파일·폴더 옮기기·이름 바꾸기 — **구조를 바꾸는 자리** (`moves` 배열로 한 번에 · 되돌리기에 잡힘) |
-| `Glob` | 이름 패턴으로 파일 찾기 |
-| `Grep` | 내용 정규식 검색 |
-| `Bash` | 명령 실행 (**끝나지 않는 것은 `background: true`**) |
-| `Skill` | 스킬 본문 펼쳐 읽기 (스킬이 있을 때만 모델에게 보임) |
-| `WebFetch` | 웹 페이지 읽기 (읽기 전용 · `--offline` 이면 숨김) |
-| `Ask` | 갈림길에서 **사람에게 되묻기** — 고를 것을 주고 숫자 하나로 받는다 |
-| `Recall` | **지난 대화**에서 찾기 — "저번에 그거" 를 모델이 스스로 뒤진다 |
-| `Remember` | 대화가 끝나도 남길 것 한 줄 — 다음에 켤 때 처음부터 안다 |
-| `TodoWrite` | 할 일 목록 — 긴 일을 쪼개서 어디까지 했는지 화면에 띄움 |
-| `Outline` | 폴더의 **뼈대만** 보기 — 통째로 읽는 것보다 수십 분의 일 |
-| `Verify` | 만든 것이 **진짜 되는지** 확인 |
-| `Task` | 큰 일의 한 덩이를 **따로 떨어진 창**에서 돌리기 |
-| `Jobs` | **뒤에서 도는 명령** 보기·읽기·끝내기 — `Bash` 의 `background` 와 짝 |
-| `Def` | 이름이 **어디 정의됐는지** — 언어 서버가 깔려 있을 때만 보입니다 |
-| `Refs` | 이름을 **어디서 쓰는지** 전부 — 언어 서버가 깔려 있을 때만 보입니다 |
-Claude Code 에 없는 것은 아홉입니다 — `Append` · `Move` · `Ask` · `Recall` ·
-`Remember` · `Outline` · `Verify` · `Task` · `Jobs`. 도구 하나가 스키마로 150~400토큰을 먹고
-그게 **매 요청마다** 나가므로, 늘릴 때마다 검사에서 한 번 멈추게 해 뒀습니다
-(`test/loop.test.js`). 뒤의 넷은 그 값을 치르고도 넣을 만해서 넣은 것들이라,
-아래에 왜인지를 적어 뒀습니다.
-> **자세히** — Outline · Verify · Task · Def · Refs · 끝나지 않는 명령은 뒤에서 외 9개
+| `Read` | Read a file (line numbers, `offset`/`limit`, **Excel as CSV, hwpx/docx/pptx and PDF as text**) |
+| `Write` | Write / overwrite a file (**several at once via the `files` array**) |
+| `Append` | Append to the end of a file — **how large files get written in pieces** |
+| `Edit` | Replace an exact string (`replace_all`; **several sites at once via the `edits` array**) |
+| `Move` | Move / rename files and folders — **how you restructure** (`moves` array; covered by undo) |
+| `Glob` | Find files by name pattern |
+| `Grep` | Regex search file contents |
+| `Bash` | Run a command (**`background: true` for anything that does not finish**) |
+| `Skill` | Expand a skill body (shown to the model only when skills exist) |
+| `WebFetch` | Read a web page (read-only; hidden under `--offline`) |
+| `Ask` | **Ask you back** at a fork — offers the choices, takes a single number |
+| `Recall` | Search **past conversations** — the model digs up "that thing last time" itself |
+| `Remember` | One line that outlives the session — known from the start next time |
+| `TodoWrite` | Checklist — breaks long work into steps and shows progress |
+| `Outline` | See a folder's **skeleton only** — tens of times cheaper than reading it whole |
+| `Verify` | Check that what was built **actually works** |
+| `Task` | Run one chunk of a big job in a **separate context** |
+| `Jobs` | Inspect, read and stop **background commands** — the other half of `Bash`'s `background` |
+| `Def` | **Where a name is defined** — only shown when a language server is installed |
+| `Refs` | **Every place a name is used** — only shown when a language server is installed |
+Nine tools here are not in Claude Code — `Append`, `Move`, `Ask`, `Recall`, `Remember`,
+`Outline`, `Verify`, `Task`, `Jobs`. Each tool costs 150-400 tokens of schema on **every request**,
+so a test stops you every time the list grows (`test/loop.test.js`). The last four earned
+their cost; here is why.
+> **More** — Outline · Verify · Task · Def · Refs · Commands that never finish and 9 more
 >
-> **[도구 자세히 읽기 →](docs/ko/tools.md#도구)**
+> **[Tools in depth read →](docs/en/tools.md#tools)**
 ---
-## 한글 문서와 엑셀
-**CP949 로 저장된 파일은 CP949 로 되돌려 씁니다.** 인코딩을 바꾸지 않습니다.
-엑셀(`.xlsx`)은 CSV 로, 한글·워드·파워포인트(`.hwpx`/`.docx`/`.pptx`)와
-**PDF** 는 글로 바꿔서 읽습니다 — 전부 읽기 전용입니다.
+## Korean text and Excel
-PDF 는 **못 읽은 쪽을 못 읽었다고 말합니다.** 스캔본·암호·글꼴 표가 없는 쪽은
-빈 글로 넘기지 않고 그 자리에 까닭을 적습니다 — 빈 글은 「그런 내용이 없다」로
-읽히기 때문입니다.
+**A file saved as CP949 is written back as CP949.** The encoding is never changed.
+Excel (`.xlsx`) is read as CSV — read-only.
-옛 형식(`.ppt`·`.doc`·`.xls`·`.rtf`)은 **이 PC 에 깔린 LibreOffice 를 빌려서**
-읽습니다 — `rg` 를 빌려 쓰는 것과 같은 원칙으로, 아무것도 설치하지 않습니다.
-없으면 **없다고 못 박고 끝냅니다**(무엇이 없어서 못 하는지, 무엇을 하면 되는지,
-그리고 「다시 열지 말라」까지). 끄려면 `DEEL_CONVERT=off`.
+Old formats (`.ppt`, `.doc`, `.xls`, `.rtf`) are read by **borrowing the LibreOffice already
+on this machine** — the same terms on which deel borrows `rg`, and nothing is ever installed.
+With no converter it **says so definitively and stops**: what is missing, what you can do about
+it, and not to open the file again. Turn it off with `DEEL_CONVERT=off`.
-> **자세히** — 인코딩 · 엑셀 · hwpx/docx/pptx · PDF · 변환기 빌려 쓰기
+> **More** — Encoding · Excel · borrowing a converter
 >
-> **[한글 문서와 엑셀 읽기 →](docs/ko/documents.md#한글-문서와-엑셀)**
+> **[Korean documents and Excel read →](docs/en/documents.md#korean-text-and-excel)**
 ---
-## 만든 웹을 그 자리에서 띄웁니다
+## Serving what you built
 ```
 ❯ /preview
-  ▶ 띄웠습니다  http://127.0.0.1:56801/
-  보여 주는 것 .
-  파일을 고치면 화면이 저절로 새로 뜹니다.
-  이 컴퓨터에서만 열립니다(127.0.0.1). 다른 PC 에서는 안 보입니다.
-  끄려면 /preview off  · deel 을 끝내면 같이 꺼집니다.
+  ▶ Serving  http://127.0.0.1:56801/
+  showing .
+  Edit a file and the page reloads by itself.
+  Only this machine can open it (127.0.0.1). No other PC can see it.
+  Stop with /preview off  · it shuts down when deel exits.
 ```
-브라우저가 같이 열립니다. `/preview 폴더` 로 자리를 정하고, `/preview off` 로 끕니다.
+A browser opens with it. `/preview <folder>` picks what to serve, `/preview off` stops it.
-**파일을 두 번 눌러 여는 것(`file://`)과 다릅니다.** `file://` 에서는 아래가 전부
-막힙니다 — 그런데 오류는 콘솔에만 나오고 화면은 그냥 희어서, 만든 사람은 제 코드를
-의심하며 시간을 씁니다. 진짜 HTTP 서버라 다 돕니다:
+**This is not the same as double-clicking the file (`file://`).** Under `file://` everything
+below is blocked — and the error only shows up in the console while the page stays blank, so
+you end up suspecting your own code. This is a real HTTP server, so it all works:
 | | `file://` | `/preview` |
 |---|---|---|
-| `<script type="module">` · `import` | 막힘 (CORS) | **됨** |
-| `fetch('./자료.json')` | 막힘 | **됨** |
-| `new Worker(...)` | 막힘 | **됨** |
-| `WebAssembly.compileStreaming` | 막힘 (형식) | **됨** |
-| 텍스처·`getImageData` | 캔버스 오염 | **됨** |
-| `.glb` / `.gltf` (Three.js) | 형식 없음 → 조용히 안 그려짐 | **됨** |
+| `<script type="module">` · `import` | blocked (CORS) | **works** |
+| `fetch('./data.json')` | blocked | **works** |
+| `new Worker(...)` | blocked | **works** |
+| `WebAssembly.compileStreaming` | blocked (MIME) | **works** |
+| textures · `getImageData` | tainted canvas | **works** |
+| `.glb` / `.gltf` (Three.js) | no MIME type → silently not drawn | **works** |
-실제 크롬에서 이 일곱 가지를 돌려 **7/7** 을 확인했습니다.
+All seven were run in a real Chrome and confirmed **7/7**.
-라우터를 쓰는 앱(React Router 등)은 안쪽 주소에서 새로고침해도 첫 장이 나옵니다.
-다만 확장자가 있는 요청(`app.js`)에는 절대 안 그럽니다 — 없는 스크립트에 HTML 을
-돌려주면 `Unexpected token '<'` 로 죽는데, 그게 진짜 원인(파일 이름 오타)을 가립니다.
+Apps with a router (React Router and friends) get the first page back when you reload on a
+deep link. Never for requests with an extension (`app.js`) though — returning HTML for a
+missing script dies with `Unexpected token '<'`, which hides the real cause (a typo in a filename).
-### 열어 주는 만큼만 엽니다
+### It opens exactly as much as it says
-서버를 띄운다는 것은 내 디스크를 남에게 열어 주는 일입니다.
+Starting a server means opening your disk to somebody else.
-- **`127.0.0.1` 에만** 묶습니다. `0.0.0.0` 은 아예 못 씁니다 — 같은 사무실 망에서
-  아무나 내 소스를 읽게 됩니다.
-- 포트는 **0**(커널이 빈 것을 줍니다). 고정 포트는 남이 쓰던 것을 뺏습니다.
-- 경로는 작업 범위 밖으로 못 나갑니다. `../` · `%2e%2e` · 두 번 인코딩 · 절대 경로 ·
-  널바이트 · 심볼릭 링크 — 여덟 가지를 검사로 막아 뒀습니다.
-- **주기만 합니다.** `POST` · `PUT` · `DELETE` 는 405 로 거절합니다.
-- `deel` 을 끝내면 같이 꺼집니다.
+- Bound to **`127.0.0.1` only**. `0.0.0.0` is not available at all — on an office network
+  that would let anyone read your source.
+- Port **0** (the kernel hands out a free one). A fixed port steals someone else's.
+- Paths cannot leave the working scope. `../` · `%2e%2e` · double encoding · absolute paths ·
+  null bytes · symlinks — eight of these are held shut by tests.
+- **It only serves.** `POST` · `PUT` · `DELETE` are refused with 405.
+- It shuts down when `deel` exits.
-## 스킬·플러그인
-**남의 스킬은 품고 다니지 않습니다.** 켜질 때 그 PC 를 훑어 있는 것을 그대로 씁니다.
-**다만 일하는 방법 일곱 가지는 품고 다닙니다.** 사내에서 새로 받은 PC 에는
-`~/.claude/skills` 도 플러그인도 없습니다. 거기서는 방법론이 0개라 모델이 매번
-제 나름대로 했고, 시킨 것만 겨우 하고 끝나는 얄팍한 결과가 거기서 나왔습니다.
+---
-| 스킬 | 언제 |
-|---|---|
-| `깊이있게-만들기` | 고도화·보고용·선포용 — 최소치만 내고 끝내지 않게 |
-| `끝까지-하기` | 시킨 것이 여러 조각일 때. 빼먹은 것은 말하게 |
-| `차근차근-디버깅` | 재현 → 좁히기 → 원인 → 고치기 → 증명 |
-| `검사-먼저` | 고치기 전에 실패하는 검사부터 |
-| `찔러보기` | 되는지 모를 때 시간 정해 작게 찔러 보고 버리기 |
-| `코드-줄이기` | 동작은 그대로 두고 읽기 쉽게 |
-| `스스로-검토` | 다 됐다고 말하기 전에. 못 잰 것까지 말하게 |
+## Skills and plugins
-목록으로 늘 나가는 몫은 354토큰입니다(8k 창의 4%). 본문은 `Skill` 로 부를 때만 나갑니다.
-같은 이름을 직접 만들면 그쪽이 이깁니다 — 품고 다니는 것이 제일 낮은 자리입니다.
+**deel does not carry skills with it.** On startup it scans the machine it is running on and uses
+whatever is there. On a clean PC: zero. On a PC with skills installed: those skills.
 ```
-품고 다님  (패키지 안)                                    ← 제일 낮은 자리
-프로젝트  ./.deel/skills   ./.claude/skills   ./.deel/commands   ./.claude/commands
-사용자    ~/.deel/skills   ~/.claude/skills   ~/.claude/commands
-플러그인  ~/.claude/plugins/**   ~/.deel/plugins/**
+project  ./.deel/skills   ./.claude/skills   ./.deel/commands   ./.claude/commands
+user     ~/.deel/skills   ~/.claude/skills   ~/.claude/commands
+plugins  ~/.claude/plugins/**   ~/.deel/plugins/**
 ```
-Claude Code 와 같은 형식(`SKILL.md` + YAML 앞머리, `commands/*.md`, `$ARGUMENTS`)을 읽습니다.
+Reads the Claude Code format: `SKILL.md` with YAML front matter, `commands/*.md`, `$ARGUMENTS`.
-> **자세히** — 3단계로 나눠 올립니다 · 플러그인 받아 오기 · 안 넣은 것
+> **More** — Loaded in three stages · Fetching plugins · Deliberately not included
 >
-> **[늘려 쓰기 읽기 →](docs/ko/extend.md#스킬플러그인)**
+> **[Extending read →](docs/en/extend.md#skills-and-plugins)**
 ---
-## 추론 강도
+### The hidden latency of local models — keeping the prefix cache alive
+Ollama and llama.cpp reuse computation **only while the request starts the same way as the
+last one.** Change one early character and everything after it — the entire conversation —
+is recomputed. This is the usual hidden reason long local sessions feel slower and slower,
+and it never shows up anywhere, because it is not an error.
+deel routes every message to the right mode automatically, and that mode instruction used to
+sit **early** in the prompt — every mode switch broke the whole cache. So the stable parts
+(rules, folder, project fingerprint, user rules, memory, skills) are frozen at the front and
+the per-turn parts (mode, pins) go last. A test pins this order down (`test/cache.test.js`).
+Ollama also gets `keep_alive: 60m` — with the 5-minute default, the model unloads while you
+glance at another window, and the first message after you come back recomputes everything.
+Override with `DEEL_KEEP_ALIVE`. If you run llama.cpp directly, `--cache-reuse 256` on the
+server side does the same job.
-에이전트 한 번의 대답은 모델을 여러 번 부릅니다. **부를 때마다 필요한 생각의 양이 다릅니다.**
-전부 세게 두면 느리고, 전부 얕게 두면 엉뚱한 길로 갑니다.
+## Reasoning effort
-기본은 **한 줄**입니다. 알고 싶은 것은 '지금 얼마나 생각하나' 이지 단계표가 아닙니다.
+One answer means several model calls, and **each needs a different amount of thinking.**
+All-high is slow; all-low wanders off.
+The default is **one line**. What you want to know is how hard it is thinking right now,
+not a stage table.
 ```
 $ /think
@@ -619,17 +794,17 @@ $ /think
   더 세게 /think high   더 빠르게 /think low
 ```
-| 배분 | 성격 |
+| Profile | Character |
 |---|---|
-| `even` (균일) | 모든 단계 같은 강도 — 예측 가능한 대신 느림 |
-| `save` (절약, 기본) | 첫 판단만 세게, 이어가기는 얕게 |
-| `deep` (깊게) | 전 단계 한 칸씩 위로 — 어려운 일에만 |
+| `even` | Same effort everywhere — predictable, slower |
+| `save` (default) | Hard on the first decision only |
+| `deep` | Everything one notch up — for hard work |
-배분은 `/think 배분 절약` 로 정합니다. **강도와 배분은 다른 축이라 명령을 갈랐습니다** —
-전에는 `/think high` 와 `/think save` 가 같은 이름으로 다른 것을 정해서,
-화면을 봐도 지금 무엇이 무엇인지 읽히지 않았습니다.
+Set the profile with `/think 배분 절약`. **Level and profile are different axes, so the
+commands were split** — `/think high` and `/think save` used to set different things under
+one name, which made the screen unreadable.
-단계표는 `/think 자세히` 로 뺐습니다(개발자 수준 기본).
+The stage table moved to `/think 자세히` (the default at developer level).
 ```
 $ /think 자세히
@@ -646,373 +821,412 @@ $ /think 자세히
   컨텍스트 40,960 · 지금 찬 양 2,087
 ```
-마지막에서 두 번째 줄이 있는 이유: **세 값이 다 같을 때 그게 고장인지 아닌지**
-이 한 줄로 갈립니다. 아는 상한이 낮으면 셋이 같아지는 것이 맞습니다.
-한동안 이 표는 세 줄이 늘 `16,384` 였고, 그건 표가 뜻이 없다는 뜻이었습니다.
+That second-to-last line exists for a reason: **when all three caps are equal, it is the
+only thing that says whether that is correct.** A low known cap makes them equal, and that
+is fine. For a while all three read `16,384` always — which meant the table said nothing.
-> **자세히** — 컨텍스트 길이는 모델에서 긁어옵니다 · /out · 잘린 도구 호출
+> **More** — Context length is read off the model · /out · Truncated tool calls
 >
-> **[속도와 씀씀이 읽기 →](docs/ko/tuning.md#추론-강도)**
+> **[Speed and spend read →](docs/en/tuning.md#reasoning-effort)**
 ---
-## 자동 압축
+## Auto-compaction
-컨텍스트가 80% 차면 앞선 대화를 **요약해서 접고 계속 이어 갑니다.**
-그냥 잘라내면 모델이 하던 일을 잊고, 파일을 다시 읽고, 이미 고친 곳을 또 고칩니다.
+At 80% context, older turns are **summarised and folded** so work continues.
+Plain truncation makes the model forget: it re-reads files and re-fixes what it already fixed.
 ```
-  ◱ 대화 44개를 요약으로 접었습니다 — 10,399 → 3,170 토큰 (70% 줄어듦)
+  ◱ Folded 44 turns into a summary — 10,399 → 3,170 tokens (70% smaller)
 ```
-요약은 목표 / 한 일 / 알아낸 것 / 정한 것 / 남은 일 다섯 항목으로 남습니다.
-접을 때 **도구 호출과 그 결과가 갈라지지 않는 자리**를 골라 자릅니다 — 갈라지면 서버가 400 을 냅니다.
-요약 요청이 실패하면 옛 방식(그냥 줄이기)으로 물러서고 멈추지 않습니다.
+The summary keeps goal / done / learned / decided / remaining. The cut point is chosen so a
+**tool call is never separated from its result** — splitting them makes the server return 400.
+If the summary request fails, it falls back to plain trimming rather than stopping.
-`/compact` 로 직접 접을 수도 있습니다.
+`/compact` folds on demand.
 ---
-## 대화 이어하기
+## Resuming a conversation
-터미널을 실수로 닫거나 컴퓨터가 재부팅돼도 하던 대화를 그대로 이어 받습니다.
-오간 내용은 **메시지 하나가 끝날 때마다 바로** `.deel/sessions/` 에 적히기 때문에,
-도중에 죽어도 그 직전까지는 남습니다.
+Close the terminal by accident, or reboot, and the conversation is still there.
+Messages are written to `.deel/sessions/` **as each one completes**, so a crash
+loses at most the message in flight.
 ```
 $ deel sessions
-── 이 폴더의 대화 ──────────────────────────────────────────────
-  ● 20260824-090200  방금        1턴  devstral-small-2507
-      테스트 깨진 거 고쳐줘
-  · 20260824-084500  2시간 전     2턴  qwen2.5-coder:7b
-      src/a.js 의 로그를 logger 로 바꿔줘
+── conversations in this folder ────────────────────────────────
+  ● 20260824-090200  just now    1 turn   devstral-small-2507
+      fix the failing test
+  · 20260824-084500  2h ago      2 turns  qwen2.5-coder:7b
+      switch src/a.js logging to the logger
 ```
-| 명령 | 하는 일 |
+| Command | What it does |
 |---|---|
-| `deel --continue` | 이 폴더에서 가장 최근 대화 이어하기 |
-| `deel --resume <id>` | 골라서 이어하기 |
-| `deel sessions` | 남아 있는 대화 목록 |
-| `deel sessions --rm <id>` | 하나 지우기 |
+| `deel --continue` | Resume the most recent conversation in this folder |
+| `deel --resume <id>` | Resume a specific one |
+| `deel sessions` | List what is stored |
+| `deel sessions --rm <id>` | Delete one |
+The format is `jsonl` — one message per line — so a power cut costs only the last line.
+Resumed history keeps tool calls paired with their results, so work continues immediately.
+Conversations older than 30 days and outside the most recent 30 are pruned automatically.
+Everything lives in `.deel/sessions/` inside the working folder, and `.gitignore`
+covers `.deel/` so it never reaches a repository.
+---
+## Starting over (`deel reset`)
-한 줄에 메시지 하나씩 쓰는 `jsonl` 이라, 쓰다가 전원이 나가도 마지막 줄만 잃습니다.
-이어받은 대화는 도구 호출과 그 결과의 짝까지 그대로 살아 있어 바로 이어서 일할 수 있습니다.
-30일이 지나고 최근 30개 밖인 것은 자동으로 정리합니다.
+Switching gateways, learned facts that went stale, handing the machine to someone else —
+sometimes you want to go back to the beginning. Reinstalling does not do it: `~/.deel`
+survives an install. Hence a command of its own.
-저장 위치는 작업 폴더의 `.deel/sessions/` 이고, `.gitignore` 에 `.deel/` 이 들어 있어
-깃에 올라가지 않습니다.
+```
+$ deel reset
+── what can be wiped ──────────────────────────────────────────
+  home            C:\Users\me\.deel
+  working folder  C:\work\myproject
+  connections                        2
+  memory                             8 lines
+  conversations                     14
+  learned                            2 places
+  evidence, exports, temp            6
+  plugins                            3
+  sealed key                             DPAPI — this PC, this account only
+── what is kept ───────────────────────────────────────────────
+  undo snapshots                    41  needs all --hard
+  audit log                      1,203 lines  needs all --hard
+  written by you                         .deel/mcp.json · .deelignore
+     never touched, by any route.
+```
+**Bare `deel reset` wipes nothing.** It shows what exists and asks.
+| Command | What goes |
+|---|---|
+| `deel reset model` | connections and profiles, plus the key in the OS keystore |
+| `deel reset memory` | memory (`.deel/memory.md`) |
+| `deel reset sessions` | conversation history |
+| `deel reset learned` | learned facts (this PC + this folder) |
+| `deel reset plugins` | installed plugins |
+| `deel reset all` | everything above **except plugins** |
+| `deel reset all --hard` | plus undo snapshots and the audit log |
+| `--yes` | skip the question (scripts, first-time provisioning) |
+What it does **not** touch matters more.
+| Kept | Why |
+|---|---|
+| `.deel/history/` (undo snapshots) | This is the safety net offered in place of an approval prompt. `--hard` only |
+| `.deel/audit.jsonl` | The evidence for an internal review. `--hard` only |
+| `.deel/mcp.json` · `.deelignore` · `DEEL.md` | You wrote these by hand. **Never touched, by any route** |
+| Everything else in the working folder | Nothing outside `.deel` and the home folder is ever reached |
+It runs on a broken config. That is usually *why* someone reaches for a reset, so
+`deel reset` starts without reading the connection — the same reason `deel --version` answers
+without one. Plugins take time to fetch again, so they stay out of `all`; ask for them by name.
 ---
-## 밖에서 도구 붙이기 (MCP)
+## Attaching tools from outside (MCP)
-사내 위키 검색기, 이슈 트래커, DB 조회기 같은 것을 각 팀이 MCP 서버로 만들어 두면
-deel 은 그걸 **코드를 안 고치고** 도구로 씁니다.
+A corporate wiki search, an issue tracker, a DB query tool — if a team publishes one as an MCP
+server, deel uses it as a tool **without a code change**.
-`.deel/mcp.json` 에 적습니다. Claude Code 설정을 그대로 복사해 붙일 수 있습니다:
+Configure in `.deel/mcp.json`. A Claude Code config can be copied over verbatim:
 ```json
-{ "mcpServers": { "사내위키": { "command": "node", "args": ["wiki-mcp.js"] } } }
+{ "mcpServers": { "wiki": { "command": "node", "args": ["wiki-mcp.js"] } } }
 ```
-모델에게는 `mcp__사내위키__검색` 이라는 이름으로 보입니다. `/mcp` 로 무엇이 붙었는지 봅니다.
+The model sees it as `mcp__wiki__search`. `/mcp` shows what is attached.
-**의존성은 그대로 0 입니다.** stdio 규격은 자식 프로세스의 stdin/stdout 에 줄 단위
-JSON-RPC 2.0 을 주고받는 것이 전부라, `child_process` 와 `JSON` 이면 됩니다. SDK 가
-필요 없습니다.
+**Dependencies stay at zero.** The stdio transport is nothing but newline-delimited JSON-RPC
+2.0 over a child process's stdin/stdout, so `child_process` and `JSON` cover it. No SDK.
-> **자세히** — 다만 이건 남의 프로그램입니다
+> **More** — But this is somebody else's program
 >
-> **[늘려 쓰기 읽기 →](docs/ko/extend.md#밖에서-도구-붙이기-mcp)**
+> **[Extending read →](docs/en/extend.md#attaching-tools-from-outside-mcp)**
 ---
-## 에디터 안에서 쓰기 (ACP)
+## Inside your editor (ACP)
-터미널을 하나 더 띄우게 하는 도구는 두 주쯤 뒤에 안 씁니다. 개발자는 하루 종일
-IDE 안에 있습니다. 그래서 **ACP**(Agent Client Protocol)를 지킵니다 — Zed ·
-JetBrains · Neovim · Emacs 가 **저쪽을 한 줄도 안 고치고** deel 을 붙입니다.
+A tool that makes you open one more terminal window stops being used after about two weeks.
+Developers live inside the IDE. So deel speaks **ACP** (Agent Client Protocol) — Zed,
+JetBrains, Neovim and Emacs attach to it **without changing a line on their side**.
-에디터 설정에 이 명령 하나만 적으면 됩니다.
+One command in your editor's settings:
 ```
 deel acp
 ```
-에디터가 이걸 자식 프로세스로 띄우고, 표준입출력으로 줄 단위 JSON-RPC 2.0 을
-주고받습니다. 사람이 직접 칠 명령은 아닙니다.
+The editor spawns that as a child process and exchanges newline-delimited JSON-RPC 2.0 over
+stdio. It is not a command you type yourself.
-**붙으면 이렇게 됩니다.**
+**What you get once it is attached:**
-| 에디터 쪽 | deel 쪽 |
+| In the editor | From deel |
 |---|---|
-| 답이 흘러나오는 자리 | 모델이 흘리는 글 · 생각 |
-| 도구 목록 (아이콘·상태) | `Read` 는 읽기, `Edit` 는 고치기, `Bash` 는 실행 — **갈래를 붙여** 보냅니다 |
-| 파일 링크 | 고친 파일의 **절대 경로**. 눌러서 그 자리로 갑니다 |
-| 승인 창 | deel 의 안전망이 그대로 에디터 창으로 뜹니다 (`이번만` · `앞으로 묻지 않기` · `안 함`) |
-| 모드 고르개 | deel 의 작업 모드 7개 (`종합` · `코드` · `계획` · `설계` · `디버그` · `묻기` · `총괄`) |
-| 멈춤 단추 | 도중에 닿습니다 — 답을 기다리는 중에도 |
-| 지난 대화 | 껐다 켜도 그대로 열립니다. 터미널과 **같은 자리**에 남아서, 에디터에서 하던 것을 `deel --resume` 으로 이어받는 것도 됩니다 |
-**의존성은 그대로 0 입니다.** MCP 와 같은 이유입니다 — 줄 단위 JSON-RPC 2.0 이
-전부라 SDK 가 필요 없습니다.
-> **자세히** — 조용히 깨지는 자리들
+| Streaming reply pane | The model's text and its reasoning |
+| Tool list with icons and status | `Read` is a read, `Edit` is an edit, `Bash` is an execution — **the kind is sent**, not just a name |
+| Clickable file links | The **absolute path** of every file touched |
+| Approval dialog | deel's safety rails, rendered as the editor's own prompt (`allow once` · `always allow` · `reject`) |
+| Mode picker | deel's seven work modes (auto · code · plan · architect · debug · ask · orchestrator) |
+| Stop button | Reaches the turn mid-flight, even while waiting on the model |
+| Past conversations | Still there after a restart. They live in the **same place** as the terminal's, so a session started in the editor can be picked up with `deel --resume` |
+**Still zero dependencies.** Same reason as MCP — newline-delimited JSON-RPC 2.0 is the whole
+transport, so no SDK is needed.
+> **More** — Details — the places this breaks silently
 >
-> **[늘려 쓰기 읽기 →](docs/ko/extend.md#에디터-안에서-쓰기-acp)**
+> **[Extending read →](docs/en/extend.md#inside-your-editor-acp)**
 ---
-## 비밀이 새지 않게
+## Keeping secrets out of the conversation
-사람이 열쇠를 붙여 넣는 일은 드뭅니다. 새는 자리는 거의 항상 **명령 출력**입니다.
+People rarely paste a key. The leak is almost always **command output**.
 ```
 env                  OPENAI_API_KEY=sk-proj-…
-git remote -v        https://사람:토큰@github.com/…
+git remote -v        https://user:token@github.com/…
 curl -v              > Authorization: Bearer eyJ…
-검사 실패 로그         연결 문자열이 통째로
+a failing test log   the whole connection string
 ```
-그 글은 모델에게 실려 가고, **동시에** `.deel/sessions/*.jsonl` 로 디스크에
-적힙니다. 그 파일은 나중에 `/recall` 로 다시 읽히고 `deel pack` 에 딸려 갈 수도
-있습니다. 한 번 새면 여러 벌이 됩니다.
+That text goes to the model **and** gets written to `.deel/sessions/*.jsonl` on disk. That
+file is later re-read by `/recall` and can end up inside a `deel pack` bundle. Leak once and
+you have several copies.
-그래서 도구 결과가 대화로 들어가는 **한 자리**에서 가립니다.
+So it is masked at the single point where tool output enters the conversation.
 ```
-  ⏺ Bash(env | grep API)  완료
-    ⊘ 비밀로 보이는 값 2군데가 대화에 들어갔습니다 (openai · 환경변수) — 모델에 가려서 보냈습니다
+  ⏺ Bash(env | grep API)  done
+    ⊘ 2 secret-looking values entered the conversation (openai · env var) — masked before the model
 ```
-찾는 것: 사설키 블록 · OpenAI/Anthropic 열쇠 · GitHub 토큰 · Slack 토큰 ·
-AWS 키 · Google 키 · JWT · 주소에 박힌 열쇠 · `Authorization` 계열 헤더 ·
-이름이 `…KEY`/`…TOKEN`/`…SECRET`/`…PASSWORD` 인 환경변수. 그리고 **설정에 든
-게이트웨이 열쇠는 모양과 상관없이** — 그건 짐작이 아니라 아는 값이니까요.
+What it looks for: private-key blocks · OpenAI/Anthropic keys · GitHub tokens · Slack tokens ·
+AWS keys · Google keys · JWTs · credentials embedded in URLs · `Authorization`-family headers ·
+env vars named `…KEY` / `…TOKEN` / `…SECRET` / `…PASSWORD`. Plus **the configured gateway key
+regardless of its shape** — that one is not a guess, it is a known value.
-### 파일 내용은 일부러 안 가립니다
+### File contents are deliberately not masked
-가리고 싶은 마음이 제일 드는 자리가 `.env` 인데, 거기를 가리면 이렇게 됩니다 —
-모델이 가려진 글을 보고, 그걸 고쳐서 되돌려 씁니다. 그러면 진짜 열쇠가 있던
-자리에 `«가림»` 이 적힙니다. **비밀을 지키려다 사람의 열쇠를 우리 손으로
-지우는 셈입니다.**
+`.env` is exactly where masking feels most tempting, and exactly where it backfires: the model
+sees the masked text, edits it, writes it back — and `«가림»` lands where the real key was.
+**Protecting the secret would destroy it.**
-그래서 파일 쪽은 가리는 대신 **알립니다.**
+So on the file side it reports instead of rewriting.
 ```
-  ⏺ Read(.env)  12줄
-    ! 비밀로 보이는 값 3군데가 대화에 들어갔습니다 (환경변수)
-      — 파일 내용은 가리지 않습니다 (가리면 되돌려 쓸 때 지워집니다)
+  ⏺ Read(.env)  12 lines
+    ! 3 secret-looking values entered the conversation (env var)
+      — file contents are not masked (masking them would erase the key on write-back)
 ```
-무엇을 못 막는지 분명히 말하는 편이, 막았다고 해 놓고 파일을 망가뜨리는 것보다
-언제나 낫습니다. 어느 쪽이든 감사기록에 남습니다.
+Saying plainly what cannot be stopped beats claiming it was stopped while corrupting the file.
+Either way it lands in the audit log.
 ---
-## 안전망
+## Safety
-승인 프롬프트 대신 **되돌릴 수 있게** 만들었습니다. 기본 모드 `auto` 는 묻지 않고 알아서 합니다.
+Instead of approval prompts, the design makes things **reversible**. The default `auto` mode
+does not ask.
-| 장치 | 내용 |
+| Mechanism | Detail |
 |---|---|
-| **되돌리기** | 파일을 고치기 전 항상 스냅샷. `/undo` 로 턴 단위 복구. **`Bash` 로 옮기고 지우는 것도 포함** |
-| **바뀐 자리 보기** | 고칠 때마다 바뀐 줄을 화면에. 이번 대화 전체는 `/diff` |
-| **작업 범위** | 시작한 폴더 밖은 모델이 시켜도 거부 |
-| **위험 명령 차단** | 되돌릴 수 없는 것만 (디스크 포맷, 재귀 삭제, `--force` 푸시 등) |
-| **재실행 금지** | 변경성 명령은 실패해도 다시 실행하지 않음 — 두 번 돌면 사고 |
-| **중단** | Ctrl+C 로 도중에 끊어도 대화가 성한 채로 남음 |
-| **헛돌기 차단** | 같은 도구가 같은 이유로 3번 실패하면 그 턴을 멈추고 왜인지 말함 |
-| **안 읽는 자리** | 남의 도구 살림과 deel 자신의 기록·설정(열쇠)은 거절 |
-| **감사 로그** | `.deel/audit.jsonl` 에 전부 기록 |
-| 모드 | 언제 물어보나 |
+| **Undo** | Snapshot before every write. `/undo` restores per turn. **Includes moves and deletes done through `Bash`** |
+| **Change display** | The changed lines are shown on every edit; `/diff` for the whole session |
+| **Scope** | Outside the starting folder is refused, even if the model insists |
+| **Blocked commands** | Only irreversible ones (disk format, recursive delete, `--force` push) |
+| **No re-run** | A mutating command is never retried after failure |
+| **Interrupt** | Ctrl+C stops mid-answer and leaves the conversation valid |
+| **Spin guard** | Three identical failures stop the turn, with the reason |
+| **Not read** | Other tools' private stores, and deel's own logs and config (the key), are refused |
+| **Audit log** | Everything recorded in `.deel/audit.jsonl` |
+| Mode | Asks when |
 |---|---|
-| `auto` (기본) | 안 물어봄. 되돌리기가 안전망 |
-| `confirm` | 되돌릴 수 없는 명령만 |
-| `strict` | 파일 변경·명령 전부 |
+| `auto` (default) | Never — undo is the safety net |
+| `confirm` | Irreversible commands only |
+| `strict` | All file changes and commands |
-되돌리기 이력은 파일 내용을 통째로 담기 때문에 큰 파일을 여러 번 고치면 금방 커집니다.
-32MB 를 넘으면 **최근 50턴만 남기고** 오래된 것을 버립니다. 방금 한 일은 언제나
-되돌릴 수 있고, 지금 이력이 얼마나 되는지는 `/status` 에서 봅니다.
+Undo history stores whole file contents, so repeated edits to large files add up. Past 32MB
+it keeps the **most recent 50 turns** and drops the rest. What you just did is always
+undoable; `/status` shows how large the history currently is.
-> **자세히** — Bash 로 사라진 것도 되돌아갑니다 · 안 읽는 자리
+> **More** — Files removed through Bash come back too · What it will not read
 >
-> **[안전망과 사내 반입 읽기 →](docs/ko/safety.md#안전망)**
+> **[Safety and corporate review read →](docs/en/safety.md#safety)**
 ---
-## 사내 반입
-심사서와 소스를 zip 하나로 묶습니다.
+## Corporate review package
 ```bash
-deel pack --out deel-반입.zip
+deel pack --out deel-import.zip
 ```
 ```
-── 반입 묶음 ───────────────────────────────────────────────────
-  ✓ deel-반입.zip
-     94개 파일 · 509.6KB
-  의존성          0개
-  설치 스크립트   없음
-  외부 import     0건
-  네트워크 호출   3곳 (설정한 주소로만)
-  포트 열기       1곳 (/preview 만)
+  ✓ deel-import.zip
+     94 files · 509.6KB
+  Dependencies      0
+  Install scripts   none
+  External imports  0
+  Network calls     3 sites (configured address only)
+  Ports opened      1 site (/preview only)
 ```
-zip 안에는 **사람이 읽을 것 한 장, 기계가 읽을 것 두 장**이 같이 들어갑니다.
-반입 심사는 사람만 보는 절차가 아니기 때문입니다 — 보안팀은 SBOM 을 스캐너에
-먹여 취약점 목록을 뽑고, 운영팀은 감사 사양을 보고 SIEM 수집 규칙을 짭니다.
+The zip carries **one document for people and two for machines.** A corporate review is
+not a human-only process — security feeds an SBOM to a scanner, and operations reads the
+audit-log spec to write SIEM ingestion rules.
-| 파일 | 무엇 |
+| File | What |
 |---|---|
-| `반입심사서.txt` | 의존성 · 설치 스크립트 · **소스를 훑어 찾은 네트워크·외부 명령 호출 자리 전부**(파일:줄) · 나가는 길 세 갈래 · 파일별 SHA-256 |
-| `sbom.cdx.json` | **SBOM (CycloneDX 1.5).** 스캐너에 그대로 넣습니다. 파일마다 부품 하나에 SHA-256, 의존성은 **빈 배열로 명시** — 안 적어 낸 것과 없는 것은 다릅니다 |
-| `심사명세.json` | 통신 목록(갈래마다 언제·어디로·무엇이·막는법·소스 자리) · **감사기록 사양**(칸 이름과 뜻, 안 남기는 것) · 파일 해시 |
+| `반입심사서.txt` | Dependencies · install scripts · **every network and process-spawn call site found by scanning the source** (file:line) · the three outbound lanes · SHA-256 per file |
+| `sbom.cdx.json` | **SBOM (CycloneDX 1.5).** Feed it straight to a scanner. One component per file with SHA-256; dependencies stated as an **explicit empty array** — "not declared" and "none" are different claims |
+| `심사명세.json` | Egress list (per lane: when, where, what, how it's stopped, and the source location) · **audit-log spec** (field names and meanings, plus what is never recorded) · file hashes |
 ```bash
-deel audit                    # 사람이 읽는 심사서만 보기
-deel sbom                     # 기계가 읽는 두 장을 표준출력으로 (deel sbom | jq)
-deel sbom --out 심사.json     # 파일로
-deel sbom --only sbom         # SBOM 한 장만
+deel audit                    # the human-readable sheet only
+deel sbom                     # the two machine-readable ones, on stdout (deel sbom | jq)
+deel sbom --out review.json   # to a file
+deel sbom --only sbom         # just the SBOM
 ```
-셋 다 손으로 적지 않고 코드가 소스를 훑어서 만듭니다 — 손으로 적으면 언젠가
-사실과 어긋나고, **어긋난 심사 서류는 없느니만 못합니다.** 담당자가 한 번 틀린
-것을 발견하면 나머지도 안 믿습니다. 감사기록 사양만은 손으로 적혀 있어서,
-그것이 진짜 기록과 어긋나지 않는지를 검사가 매번 대조합니다.
+All three are generated by scanning the source, never written by hand — hand-written sheets
+drift, and **a review document that drifts is worse than none.** Find one wrong line and the
+reviewer stops trusting the rest. The audit-log spec is the one hand-written part, so a test
+checks it against real log records on every run.
-> **자세히** — 사내 게이트웨이 진단
+> **More** — Diagnosing a corporate gateway
 >
-> **[안전망과 사내 반입 읽기 →](docs/ko/safety.md#사내-반입)**
+> **[Safety and corporate review read →](docs/en/safety.md#corporate-review-package)**
 ---
-## 설정
+## Configuration
-`~/.deel/config.json` 에 저장됩니다. 프로젝트 폴더에 `.deel/config.json` 이 있으면 그쪽이 우선입니다.
+Stored in `~/.deel/config.json`. A `.deel/config.json` in the project folder takes precedence.
-> **자세히** — 붙는 서버 · 환경변수 · 실행 옵션 · 프로젝트 규칙
+> **More** — Supported servers · Environment variables · Flags · Project rules
 >
-> **[설정 읽기 →](docs/ko/config.md#설정)**
+> **[Configuration read →](docs/en/config.md#configuration)**
 ---
-## 문제 해결
+## Troubleshooting
-| 증상 | 확인할 것 |
+| Symptom | Check |
 |---|---|
-| `주소를 찾을 수 없습니다` | 주소 오타, DNS, 사내망 접속 여부 |
-| `연결이 거부되었습니다` | 서버가 꺼져 있거나 포트가 다름 |
-| `인증서 문제` | `set NODE_EXTRA_CA_CERTS=C:\경로\사내CA.pem` |
-| 프록시를 거쳐야 함 | `set HTTPS_PROXY=http://프록시:포트` (인증은 `http://user:pw@프록시:포트`). 첫 화면과 `/status` 에 `프록시 …` 가 뜨면 거치는 것. 안 거칠 곳은 `NO_PROXY=.corp.com,10.1.2.3`, 아예 끄려면 설정에 `"proxy": "none"` |
-| 프록시가 407 을 줌 | 프록시 주소에 `user:pw@` 를 넣으세요. NTLM · Negotiate 만 받는 프록시는 못 씁니다 — 담당자에게 Basic 이나 인증 없는 주소를 문의 |
-| 401 / 403 | 키가 틀렸거나 인증 헤더 형식이 다름 (4가지를 자동 시도합니다) |
-| `허용되지 않은 주소입니다` | 자물쇠가 막은 것. 정상입니다 — `/model` 로 연결을 고르세요 |
-| 도구 호출이 안 먹음 | `deel diagnose` 로 판정을 보세요. 작은 모델(1B~3B)은 자주 못 합니다 |
-| 대답이 비어 있음 | 스트리밍을 무시하는 서버입니다. 한 번은 저절로 다시 부르고, 그래도 비면 이 대화에서는 스트리밍을 끕니다 |
-| 큰 파일이 중간에 끊김 | `/out` 으로 지금 상한을 보고 올리세요. 상한을 몰라 16,384 로 서 있을 수 있습니다 |
-| `HTTP 400` 만 뜸 | 서버가 보낸 문장을 그대로 보여 줍니다. 길이 문제면 숫자를 읽어 저절로 맞춥니다 |
-| `429` · `503` 이 뜸 | 게이트웨이가 잠깐 막은 것입니다. 세 번까지 저절로 기다렸다 다시 부릅니다(`Retry-After` 를 지킵니다). 그래도 계속 뜨면 할당량을 보세요 |
-| `deel scan` 이 0곳 | 로컬 서버가 꺼져 있거나 다른 포트 — `--ports` 로 지정 |
+| `address not found` | Typo, DNS, VPN / intranet connectivity |
+| `connection refused` | Server is down or the port differs |
+| certificate error | `set NODE_EXTRA_CA_CERTS=C:\path\corp-ca.pem` |
+| behind a proxy | `set HTTPS_PROXY=http://proxy:port` (with auth: `http://user:pw@proxy:port`). If the first screen and `/status` show `proxy …`, it is in use. Exclude hosts with `NO_PROXY=.corp.com,10.1.2.3`; turn it off entirely with `"proxy": "none"` in the config |
+| the proxy answers 407 | Put `user:pw@` into the proxy address. Proxies that only accept NTLM · Negotiate are not supported — ask the admin for Basic or an unauthenticated address |
+| 401 / 403 | Wrong key or auth header style (four are tried automatically) |
+| `address not permitted` | The lock did its job — pick a connection with `/model` |
+| Tool calls don't work | Run `deel diagnose`. Small models (1B–3B) often can't |
+| Empty replies | The server ignores streaming. deel retries once, then turns streaming off for the session |
+| Large files cut off mid-write | Check `/out` and raise it — the cap may be sitting at the 16,384 default because it could not be discovered |
+| Only `HTTP 400` shows | The server's own message is shown verbatim. If it is a length problem the number is read and applied automatically |
+| `429` · `503` shows | The gateway pushed back for a moment. deel waits and calls again, up to three times (honouring `Retry-After`). If it keeps happening, check your quota |
+| `deel scan` finds nothing | Server is off or on another port — use `--ports` |
 ---
-## 개발
+## Development
 ```bash
-npm test          전체 검증 (4,932항목)
-npm run coverage  검사가 소스의 어디를 밟았는지
-npm run verify    반입·통신 검증만
-npm run bench     편집 성공률 측정
-npm run demo      화면이 어떻게 보이는지 실제로 돌려 보기
-npm run check     전 파일 문법 검사
+npm test          Full suite (~5,890 checks; a few are TTY-dependent)
+npm run coverage  Which lines the tests actually execute
+npm run verify    Import + network checks only
+npm run bench     Edit success rate
+npm run demo      See what the UI actually looks like
+npm run check     Syntax check every file
 ```
-검증은 **가짜 게이트웨이**를 띄워서 합니다. 실제 모델 없이 규격 그대로
-루프·스트리밍·도구 실행·되돌리기·압축을 결정적으로 확인합니다.
-zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교차 확인합니다.
-`npm test` 는 파일을 하나씩 돌리고 **파일별 종료코드**를 표로 남깁니다.
-화면의 통과 표시가 아니라 종료코드가 CI 가 보는 값이기 때문입니다. 둘은
-갈라질 수 있습니다 — 검사를 다 통과하고도 끝낼 때 죽으면 화면은 초록인데
-종료코드는 1 입니다. 실제로 윈도우에서 그렇게 한 번 놓쳤습니다.
-첫 실패에서 멈추지 않고 끝까지 돌기 때문에, 한 번 돌리면 전부 알 수 있습니다.
+Tests run against a **fake gateway**, so the loop, streaming, tool execution, undo and compaction
+are verified deterministically without any model. ZIP output is cross-checked with the real
+`unzip`; the TAR reader is fed archives produced by the real `tar`.
-```
-  ────────────────────────────────────────────────────────────
-  검사 파일              종료코드   통과   실패   시간
-  ────────────────────────────────────────────────────────────
-  ✓ smoke.js            0            20     0     0.2초
-  ✗ scan.test.js        1            19     0     0.2초
-  ────────────────────────────────────────────────────────────
-  ✗ scan.test.js — 종료코드 1
-     검사는 전부 통과했는데 종료코드만 1 입니다 —
-     끝낼 때 남은 핸들·처리 안 된 거절 때문입니다.
-```
+`npm test` runs each file separately and reports **per-file exit codes**, because the exit code
+— not the pass marks on screen — is what CI reads, and the two can disagree: a file can pass
+every check and still die on the way out, leaving the screen green and the exit code 1. That
+happened once on Windows and cost a lot of time. The runner does not stop at the first failure,
+so one run tells you everything.
-| 검증 | 항목 | 무엇을 |
+| Suite | Checks | Covers |
 |---|---|---|
-| `smoke` | 20 | 도구·작업범위·되돌리기·감사로그 |
-| `loop` | 16 | 에이전트 루프·스트리밍·도구 호출 |
-| `guard` | 24 | **안 하는 자리** — 거부·모르는 도구·두 번 실행·범위 밖 |
-| `network` | 30 | 정해진 자리 밖으로 새지 않는가 |
-| `web` | 25 | 웹 읽기가 읽기만 하는가 |
-| `abort` · `steer` | 16 · 15 | Ctrl+C 로 끊어도 대화가 성한가 · 도중에 낀 말이 다음 부름에 실리는가 |
-| `parallel` | 23 | 읽기만 동시에 도는가 · 할 일 목록 |
-| `cli` | 75 | **진짜 `deel` 을 띄워** 끝까지 돌려 본다 |
-| `setup` | 42 | 첫 실행 마법사 (가짜 TTY 로 사람처럼 입력) |
-| `detect` | 66 | 주소 한 줄로 규격·인증을 짚어내는가 |
-| `modes` · `route` | 89 · 33 | 작업 모드 · 종합에서 알맞은 모드로 옮겨 가는가 |
-| `ctxsize` | 43 | 모델에 걸린 컨텍스트 길이를 긁어오는가 |
-| `commands` · `commands-more` | 128 · 62 | 슬래시 명령 전부 |
-| `ui` · `ui2` | 60 · 40 | 암호 가림·한글 폭·상태줄·대화 목록·엑셀→글 |
-| `encoding` · `xlsx` | 68 · 72 | 한글 인코딩 판별 · 엑셀 읽기 |
-| `compact` | 21 | 요약 압축·짝 안 깨짐·실패 시 물러섬 |
-| `store` | 34 | 대화 저장·이어하기·중간에 죽어도 복구 |
-| `scan` | 29 | 여러 런타임을 구분해 찾는가 |
-| `plugins` | 38 | 플러그인 받기·묶기·ZIP/TAR |
-| `no-bundle` | 12 | 배포 묶음에 남의 것이 안 섞였는가 · 검사 파일 위생 |
-| `edit-bench` | 20건 | 편집 성공률 |
-> **자세히** — 어디를 밟았는지 · 폴더 구조
+| `smoke` | 20 | Tools, scope, undo, audit log |
+| `loop` | 16 | Agent loop, streaming, tool calls |
+| `guard` | 24 | **What it refuses to do** — denied edits, unknown tools, repeated mutations, out-of-scope writes |
+| `network` | 30 | Nothing escapes the configured address |
+| `web` | 25 | Web reads stay read-only |
+| `abort` · `steer` | 16 · 15 | Ctrl+C leaves the conversation valid · a line typed mid-turn rides the next call |
+| `parallel` | 23 | Read-only tools run together; checklists |
+| `cli` | 75 | **Spawns the real `deel`** and drives it to completion |
+| `setup` | 42 | First-run wizard, driven through a fake TTY |
+| `detect` | 66 | Identifying shape and auth from one address |
+| `modes` · `route` | 89 · 33 | Work modes; auto-switching from Auto |
+| `ctxsize` | 43 | Reading context length off the model |
+| `commands` · `commands-more` | 128 · 62 | Every slash command |
+| `ui` · `ui2` | 60 · 40 | Password masking, CJK width, status line, session list, Excel→text |
+| `encoding` · `xlsx` | 68 · 72 | Legacy-encoding detection; Excel reading |
+| `compact` | 21 | Summary folding, pairing intact, graceful fallback |
+| `store` | 34 | Session persistence, resume, crash recovery |
+| `scan` | 29 | Distinguishing multiple runtimes |
+| `plugins` | 38 | Plugin fetch/pack, ZIP/TAR |
+| `no-bundle` | 12 | Nothing foreign in the published package; test-file hygiene |
+| `edit-bench` | 20 cases | Edit success rate |
+> **More** — Coverage · Layout
 >
-> **[개발 읽기 →](docs/ko/develop.md#개발)**
+> **[Development read →](docs/en/develop.md#development)**
 ---
-## 릴리스 노트
+## Release notes
-| 판 | 무엇이 바뀌었나 |
+| Version | What changed |
 |---|---|
-| **[1.6.3](docs/ko/releases.md#163)** | 일이 되고 있는데 헛돈다고 끊던 자리 — 배열로 옮기면 무엇이 움직였는지가 사라졌다 |
-| **[1.6.2](docs/ko/releases.md#162)** | 누르면 멈추고, 시킨 대로 하고, 안 끊긴다 — ESC · 되묻기 · 요청 누락 · 붙여넣기 접기 · 끊긴 자리 잇기 |
-| **[1.6.1](docs/ko/releases.md#161)** | 헛도는 턴을 만들던 자리들 — 울타리가 `/dev/null` 까지 막던 것 · 옷 문서를 못 읽던 것 · 파일에서 그림이 사라지던 것 |
-| **[1.6.0](docs/ko/releases.md#160)** | 사내망에서 안 되던 것들 — 프록시 · 429 · 윈도우 셸 · 5만 개 저장소 · PDF · 캡처 붙여넣기 · 에디터 이어하기 |
-| **[1.5.8](docs/ko/releases.md#158)** | 5MB 문서를 919줄 중 8줄만 보던 것 · 정규식을 경로로 읽어 명령을 막던 것 |
-| **[1.5.7](docs/ko/releases.md#157)** | 맥 한글 폴더에서 제 파일이 「범위 밖」이던 것 · 붙여넣기 · ESC |
-| **[1.5.6](docs/ko/releases.md#156)** | 막히면 물어본다 — 글로 묻고 턴을 끝내는 대신에 |
-| **[1.5.5](docs/ko/releases.md#155)** | 계획을 세우면 방이 찬다 — 「한 명뿐」은 고정이 아니라 버그였다 |
-| [1.5.4](docs/ko/releases.md#154) | 방에 하루가 흐른다 — 아침·낮·노을·밤 · 벽시계 · 식은 커피 |
-| [1.5.3](docs/ko/releases.md#153) | 맥에서 걸린 세 가지 — 줄바꿈 안내 · 사무실이 안 사라짐 · `/motion` 하나로 |
-| [1.5.2](docs/ko/releases.md#152) | 적대적 리뷰가 남긴 나머지를 전부 정리했다 — 화면이 거짓말하던 자리들 |
-| [1.5.1](docs/ko/releases.md#151) | 1.5.0 이 넣은 것 두 개가 망가진 채 나갔다. 그것을 고친다 |
-| [1.5.0](docs/ko/releases.md#150) | 줄바꿈이 생겼고, 화면이 재미있어졌고, 그러면서 오히려 가벼워졌다 |
-| [1.4.3](docs/ko/releases.md#143) | README 가 왜 다른지 말하고, 심사서의 빠진 한 줄을 채운다 |
-| [1.4.2](docs/ko/releases.md#142) | 1.4.1 이 보안 수정 전에 나갔다 — 그걸 바로잡는 판 |
-| [1.4.1](docs/ko/releases.md#141) | 새 기능 없이, 실제로 찾은 것만 고친다 — 윈도우 abort·ReDoS·XSS |
-| [1.4.0](docs/ko/releases.md#140) | deel 이 제 얼굴을 갖고, 영어로도 말하고, 뜻까지 본다 — 열한 자리 |
-| [1.3.0](docs/ko/releases.md#130) | 말 대신 증거, 터미널 대신 에디터 — 여섯 자리 |
-| [1.2.0](docs/ko/releases.md#120) | 대화가 끊기지 않게 — 여섯 자리 |
-무엇이 왜 바뀌었는지는 **[릴리스 노트](docs/ko/releases.md)** 에 있습니다.
+| **[1.8.0](docs/en/releases/1.8.md#180)** | A full day against a gateway that hands out one-hour tokens — fetch the key instead of storing it · `deel reset` · an English screen that is actually English |
+| [1.7.0](docs/en/releases/1.7.md#170) | Local stays local; it goes out only when you say so — three modes · vendor setup · automatic masking · cost |
+| [1.6.1](docs/en/releases/1.6.md#161) | The places that made a turn spin in circles — the fence blocking `/dev/null` · old documents it could not read · images vanishing from files |
+| **[1.6.0](docs/en/releases/1.6.md#160)** | The things that did not work on a corporate network — proxy · 429 · Windows shell · 50k-file repos · PDF · clipboard paste · editor resume |
+| **[1.5.8](docs/en/releases/1.5.md#158)** | A 5MB document showed 8 lines out of 919 · a regex read as a path blocked the command |
+| **[1.5.7](docs/en/releases/1.5.md#157)** | Korean folders on macOS made your own files "out of scope" · paste · ESC |
+| **[1.5.6](docs/en/releases/1.5.md#156)** | It asks when stuck — instead of writing a question and ending the turn |
+| **[1.5.5](docs/en/releases/1.5.md#155)** | A plan fills the room — "only one person" was a bug, not a design |
+| [1.5.4](docs/en/releases/1.5.md#154) | A day passes in the room — morning to night, a wall clock, a cold coffee |
+| [1.5.3](docs/en/releases/1.5.md#153) | Three things a Mac user tripped over — newline hint, office stays put, one `/motion` |
+| [1.5.2](docs/en/releases/1.5.md#152) | Everything else the adversarial reviews turned up — where the screen was lying |
+| [1.5.1](docs/en/releases/1.5.md#151) | Two of the things 1.5.0 added shipped broken. This fixes them |
+| [1.5.0](docs/en/releases/1.5.md#150) | Line breaks exist now, the screen got fun, and it came out lighter than before |
+| [1.4.3](docs/en/releases/1.4.md#143) | The README explains what's different, and the review report gets its missing line |
+| [1.4.2](docs/en/releases/1.4.md#142) | 1.4.1 shipped before its own security fixes — this corrects that |
+| [1.4.1](docs/en/releases/1.4.md#141) | No new features, only what was actually found and fixed — Windows abort, ReDoS, XSS |
+| [1.4.0](docs/en/releases/1.4.md#140) | deel gets a face, speaks English, and sees meaning — eleven places |
+| [1.3.0](docs/en/releases/1.3.md#130) | Evidence instead of claims, the editor instead of a terminal — six places |
+| [1.2.0](docs/en/releases/1.2.md#120) | So the conversation doesn't break — six places |
+What changed and why is in the **[release notes](docs/en/releases.md)**.
 ---
-## 라이선스
+## Licence
 [MIT](LICENSE)