@litfamily/litopencode 1.0.18 → 1.0.20

package/CHANGELOG.md

@@ -5,6 +5,20 @@ are tracked separately from this product history.
 
 ## Unreleased
 
+## 1.0.20 - 2026-10-12
+
+- The band along the bottom of OpenCode's main screen is now a small card that stays on screen for the whole session. The top edge shows LIT, the current workflow and its phase. The first row shows PLAN ━ WORK ━ REVIEW with the goal and the next task. The second row shows a chip for each LitOpenCode skill that ran: skills used by the current request are bright and get a short shine as they appear, then dim into a recent list when the answer is done, and extra chips fold into `+N`. The bottom edge shows context use, elapsed time and the git branch. Before you use lit in a session, the card shows the project's last goal. `band: false` still hides it and `band: { card: true }` still adds the detail card.
+
+## 1.0.19 - 2026-10-11
+
+- The README is shorter for first-time readers. It says what LitOpenCode does, how to install it and what to type first, and the detail now lives in docs pages (guide, skills, screens and brand) in English and Korean. The GitHub page also plays a short film of a real session.
+- A lit mission now shows in OpenCode's TUI. A pill chip sits by the prompt, a rounded sidebar panel carries the phase and a smooth progress bar, a band runs along the bottom of the main screen, the home screen shows a line for the last mission, and a finished mission gets a short completion moment. In the plugin's `tui.json` options, `band: false` turns the band off and `band: { card: true }` adds a card under it with the warnings, the next task and the goal.
+- Install adds the TUI plugin to `tui.json` or `tui.jsonc` and backs the file up first, and `litopencode tui remove` takes it out again. Auto-update backs up these files with the rest of the install and puts them back when an update fails.
+- Install and doctor read a commented `opencode.jsonc` safely. They accept comments, trailing commas, a BOM and CRLF line endings, and an edit keeps every comment. When a comment sits inside an entry that has to change, install stops before writing anything and prints the entry to add by hand. A second install from a local checkout no longer adds a duplicate plugin entry.
+- A prompt such as "lit turn notes.md into a 10-slide deck" now loads the office skills: lit-pptx for a deck and lit-docx for a Word report. The dot in a file name no longer breaks the match.
+- The prose check that runs before a write now skips YAML, JSON and CSV files, so a line such as `source:` in a config file no longer blocks the write.
+- `--dry-run` writes nothing. Loop commands that change the ledger list the files they would touch, and `motion-runtime` refuses an unknown option before it downloads anything.
+
 ## 1.0.18 - 2026-10-09
 
 - The prose check that runs before a file is written now works inside OpenCode. It used to start under OpenCode's own program instead of Node and to look for the new text in the wrong place, so it never saw a write. It now stops an added line such as an unrequested source label before the file is saved, adds a short note after the write when the wording only needs a second look, and checks the text of the Word, PowerPoint and PDF files a session creates.

package/README-Ko-KR.md

@@ -1,120 +1,90 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
-
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크" /></p>
-
-<details>
-<summary>ASCII 로고 복사</summary>
-
-```text
-                             ▄▄▄▄
-                   ▗███▌   ▗██████▖
- ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
- ▐█████        ▗▟██████▌    ▝▀▜█▀▘
- ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
- ▐█████    ▗▟█████████████████████████ ▐█▀
- ▐█████    ████████████████████████████▀
- ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
- ▐█████    ▀    ▄██ ████▌█████████████▌
- ▐█████       ▄████ ████▌█████████████▌
- ▐█████     ▄█████▛                                 litopencode
- ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
- ▐█████ ▐█████▀          █████     ▐▛▀
- ▐█████ ▐███▀            █████
- ▐█████ ▐█▀              █████
- ▐█████ ▝                █████
- ▐█████▄▄▄▄▄▄▄▖          █████
- ▐███████████▛           █████
- ▐██████████▀            █████
-
-```
-
-</details>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitOpenCode 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 # LitOpenCode
 
-[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/README-Ko-KR.md)
-
-> **불씨를 건네받았다.**<br>
-> **이제, 당신의 작업에 옮길 차례다.**
+**LitOpenCode는 OpenCode용 워크플로 플러그인입니다. 프롬프트에 `lit`만 붙이면 계획하고, 만들고, 확인하고, 기록까지 남겨서 다음 세션이 어디서 멈췄는지 바로 압니다.**
 
 <p align="center">
-<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/badge-version.svg" alt="1.0.18" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/readme/badge-version.svg" alt="1.0.20" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="월간 npm 다운로드 수" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub 스타" /></a>
 </p>
 
-LitOpenCode는 OpenCode에 워크플로 agent, 슬래시 명령, 로컬 근거 기록을 더합니다.
-
-프롬프트에 `lit`을 붙이면 계획하고, 만들고, 확인한 뒤 다음 할 일을 프로젝트에 적어 둡니다. 그래서 다음 세션이 멈춘 자리에서 바로 이어 갈 수 있습니다. 모델을 돌리고 권한을 묻는 일은 지금처럼 OpenCode가 합니다.
+LitOpenCode는 목표와 계획, 확인한 내용, 다음 할 일을 프로젝트 안의 `.litopencode/litgoal/`에 남겨 두기 때문에, 긴 작업도 다음 날 멈춘 자리에서 이어 갈 수 있습니다.
 
-**[전체 안내와 스킬 갤러리는 GitHub에서 →](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md)**
-
-## 설치
-
-Node.js와 npm, 그리고 OpenCode가 있으면 됩니다.
-
-```sh
-LIT_PACKAGE='@litfamily/litopencode@latest'
-npm exec --package "$LIT_PACKAGE" -- litopencode install
-```
+**[전체 안내, 화면, 스킬 갤러리는 GitHub에서 →](https://github.com/wjgoarxiv/litopencode/blob/main/README-Ko-KR.md)**
 
-OpenCode를 다시 시작하고 `Tab` 키를 눌러 `lit-loop`를 고르세요. 권한은 `safe`에서 시작하는데, 무언가 하기 전에 OpenCode가 먼저 물어보는 설정입니다. 로그인과 API 키는 OpenCode에 이미 설정해 둔 모델 제공자(provider) 쪽 것을 그대로 씁니다.
+## 빠르게 시작하기
 
-바뀔 내용을 먼저 보려면 `--dry-run`을 붙이세요. 아무것도 쓰지 않습니다. 질문 없이 설치하려면 `--yes`를 붙이세요. 기본값으로 설치하되 예전에 저장해 둔 선택은 그대로 둡니다.
+Node.js와 npm, 그리고 모델 제공자를 설정해 둔 OpenCode가 있으면 됩니다.
 
 ```sh
-npm exec --package @litfamily/litopencode@latest -- litopencode install --dry-run  # 변경 사항 미리 보기
-npm exec --package @litfamily/litopencode@latest -- litopencode install --yes     # 기본값 사용, 저장된 선택 유지
+npm exec --package @litfamily/litopencode@latest -- litopencode install
 ```
 
-## 첫 작업
-
-빈 폴더를 OpenCode에서 열고 `lit-loop`를 고른 다음 이렇게 보내 보세요.
+기본값으로 바로 설치하려면 `--yes`를, 아무것도 쓰지 않고 무엇이 바뀔지만 보려면 `--dry-run`을 붙이세요. OpenCode를 다시 시작하고 **Tab** 키로 **lit-loop**를 고른 뒤, 빈 폴더를 열고 이렇게 보냅니다.
 
 ```text
 lit 외부 의존성 없이 index.html 하나로 할 일 목록을 만들고, 추가와 완료 표시를 확인한 뒤 다음 할 일을 남겨줘.
 ```
 
-`index.html`이 만들어지면 열어서 직접 써 보세요. 다음에 돌아왔을 때는 `/lit-recap`이 어디까지 했는지 알려 줍니다.
+직접 열어 볼 수 있는 `index.html`이 생기고, 다음에 돌아오면 `/lit-recap`이 어디까지 했는지 알려 줍니다.
 
-## 자주 쓰는 경로
+## 할 수 있는 일
 
 | 입력 | 하는 일 |
 | --- | --- |
-| `lit` 또는 `/lit` | 범위가 분명한 작업을 시작하고, 확인한 내용을 기록합니다. |
-| `lit-plan` → `/start-work` → `/review-work` | 계획, 승인, 실행, 검토. planner는 파일을 고치거나 shell을 실행할 수 없습니다. |
-| `handoff` 또는 `/lit-handoff` | 현재 결과와 다음 할 일을 다음 세션에 넘깁니다. |
-| `/lit-recap` | 로컬 기록을 짧게 요약해 보여 줍니다. |
-| `/litresearch` | 출처 근거를 남기며 조사합니다. |
-
-이 밖에도 디버깅, 리팩터링, 코드 검토, 조사 스킬이 있고, 만들기 전에 디자인 방향을 골라 알려 주는 워드 보고서(`lit-docx`)와 파워포인트 발표자료(`lit-pptx`), 다이어그램, 과학 그림, 화면 구현, README, 글 다듬기(`/lit-humanizer`) 스킬도 함께 설치됩니다. 스킬마다 무엇을 만드는지는 그림과 함께 [GitHub 스킬 갤러리](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md#스킬-한눈에-보기)에 있습니다.
-
-## 설치하면 바뀌는 것
-
-많지 않습니다. OpenCode 설정에 플러그인을 등록하고, LitOpenCode의 명령과 스킬 파일을 OpenCode 설정 폴더에 복사합니다. 어떤 일에 어떤 모델을 쓸지 정한 route는 `~/.config/opencode/litopencode.json`에 저장됩니다. `XDG_CONFIG_HOME`을 지정하면 설정 폴더가 그쪽으로 옮겨 가고, 이미 손봐 둔 route는 건드리지 않습니다. 작업 기록은 프로젝트마다 `.litopencode/litgoal/`에 쌓이고, 다음 세션은 이 기록을 읽고 이어 갑니다.
+| `lit` 또는 `/lit` | 일을 정리하고, 계획하고, 만들고, 확인하고, 요약하며 단계마다 기록을 남깁니다. |
+| `lit-plan` → `/start-work` → `/review-work` | 계획하고, 승인하고, 실행하고, 검토합니다. 계획 에이전트는 파일을 고치거나 셸 명령을 실행할 수 없습니다. |
+| `handoff` · `/lit-recap` | 다음 세션이 이어 갈 인수인계 파일을 남기고, 끝낸 일과 다음 할 일을 다시 읽어 줍니다. |
+| `/litresearch` | 여러 차례 조사하며 주장마다 출처를 남깁니다. |
+| `lit` + 보고서·발표자료 | 마크다운 원고와 함께 편집할 수 있는 워드 보고서나 파워포인트 덱을 만듭니다. |
+| `/lit-humanizer` | 딱딱한 영어나 한국어 문장을 사실은 그대로 두고 다시 씁니다. |
 
-OpenAI 제공자를 쓰면 새로 설치했을 때 계획과 검토는 GPT-6 Astra(`gpt-6-astra`)가 `xhigh`로, 만들기와 조사는 GPT-6 Luna(`gpt-6-luna`)가 `max`로 맡습니다.
+스킬마다 만들어 내는 결과의 그림은 [GitHub의 스킬 갤러리](https://github.com/wjgoarxiv/litopencode/blob/main/docs/skills-Ko-KR.md)에서 볼 수 있습니다.
 
-## 안전과 업데이트
+## 업데이트와 제거
 
-- planner는 계획만 세웁니다. `lit-plan`은 `edit`, `bash`, `task` 권한이 거부되어 있고, 더 느슨한 `balanced`나 `yolo` 모드를 직접 골라도 그대로입니다.
-- LitOpenCode는 대화형으로 시작할 때와 install이나 doctor가 성공한 뒤에 스스로 업데이트할 수 있습니다. 끄려면 `--no-auto-update`를 붙이거나 `LITOPENCODE_NO_AUTO_UPDATE=1`을 설정하세요.
-- 스킬 학습 기능은 제거되었습니다. 이전 릴리스가 프로젝트의 `.litopencode` 폴더에 남긴 학습 기록은 더 이상 쓰이지 않으니, 남겨 두든 지우든 편한 대로 하면 됩니다.
-- Jev 스킬 힌트는 선택 기능이고 기본값은 꺼짐입니다. 켜면 조건에 맞는 프롬프트가 TypeSafe로 전송되니, 먼저 [Jev 스킬 힌트 참조 문서](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference-Ko-KR.md#jev-스킬-힌트-선택)를 읽어 보세요. 알림과 doctor 줄이 어떻게 보이는지는 [GitHub 페이지](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md#화면에서-보이는-것)에서 볼 수 있습니다.
-- 뭔가 이상하면 `npm exec --package @litfamily/litopencode@latest -- litopencode doctor`로 패키지와 설정 상태를 확인하세요.
+LitOpenCode는 대화형으로 시작할 때와 install·doctor가 성공한 뒤 새 버전을 확인합니다. 끄려면 `--no-auto-update`를 붙이거나 `LITOPENCODE_NO_AUTO_UPDATE=1`을 설정하세요. `npm exec --package @litfamily/litopencode@latest -- litopencode doctor`는 설치 상태를 확인할 뿐 아무것도 바꾸지 않습니다.
 
-## 제거
-
-별도의 제거 명령은 없습니다. OpenCode의 `opencode.jsonc`(custom root라면 `opencode.json`)에서 `plugin` 배열의 `@litfamily/litopencode` 항목을 지우고 OpenCode를 다시 시작하세요. 전역으로 설치했다면 다음도 실행합니다.
+제거하려면 OpenCode의 `opencode.jsonc`에서 `plugin` 배열의 `@litfamily/litopencode` 항목을 지우고 OpenCode를 다시 시작하세요. 전역으로 설치했다면 다음 명령도 실행합니다.
 
 ```sh
 npm uninstall -g @litfamily/litopencode
 ```
 
-남겨 둘 만한 설치 파일과 기록은 [제거 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference-Ko-KR.md#제거)에 정리되어 있습니다.
-
 ## 더 보기
 
-- [GitHub 전체 안내](https://github.com/wjgoarxiv/litopencode/blob/master/README-Ko-KR.md)
-- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference.md)
-- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/privacy.md)
-- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/LICENSE) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [GitHub의 사용 안내](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide-Ko-KR.md): 설치 옵션, 자동 인수인계, 문제 해결, 제거
+- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/reference-Ko-KR.md) · [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/reference.md)
+- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/CHANGELOG.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/privacy.md)
+- [LitFamily 허브](https://github.com/wjgoarxiv/litfamily) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/LICENSE) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/readme/JetBrainsMono-OFL.txt)
+
+<details>
+<summary>ASCII 로고 복사</summary>
+
+```text
+                             ▄▄▄▄
+                   ▗███▌   ▗██████▖
+ ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
+ ▐█████        ▗▟██████▌    ▝▀▜█▀▘
+ ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+ ▐█████    ▗▟█████████████████████████ ▐█▀
+ ▐█████    ████████████████████████████▀
+ ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
+ ▐█████    ▀    ▄██ ████▌█████████████▌
+ ▐█████       ▄████ ████▌█████████████▌
+ ▐█████     ▄█████▛                                 litopencode
+ ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
+ ▐█████ ▐█████▀          █████     ▐▛▀
+ ▐█████ ▐███▀            █████
+ ▐█████ ▐█▀              █████
+ ▐█████ ▝                █████
+ ▐█████▄▄▄▄▄▄▄▖          █████
+ ▐███████████▛           █████
+ ▐██████████▀            █████
+
+```
+
+</details>

package/README.md

@@ -1,119 +1,90 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
-
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
-
-<details>
-<summary>Copy ASCII logo</summary>
-
-```text
-                             ▄▄▄▄
-                   ▗███▌   ▗██████▖
- ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
- ▐█████        ▗▟██████▌    ▝▀▜█▀▘
- ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
- ▐█████    ▗▟█████████████████████████ ▐█▀
- ▐█████    ████████████████████████████▀
- ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
- ▐█████    ▀    ▄██ ████▌█████████████▌
- ▐█████       ▄████ ████▌█████████████▌
- ▐█████     ▄█████▛                                 litopencode
- ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
- ▐█████ ▐█████▀          █████     ▐▛▀
- ▐█████ ▐███▀            █████
- ▐█████ ▐█▀              █████
- ▐█████ ▝                █████
- ▐█████▄▄▄▄▄▄▄▖          █████
- ▐███████████▛           █████
- ▐██████████▀            █████
-
-```
-
-</details>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitOpenCode robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 # LitOpenCode
 
-[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/README-Ko-KR.md)
-
-**Keep the work lit.**
+**LitOpenCode is a workflow plugin for OpenCode. Add `lit` to a prompt and the work gets planned, built, checked and written down, so the next session knows where you stopped.**
 
 <p align="center">
-<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/badge-version.svg" alt="1.0.18" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/readme/badge-version.svg" alt="1.0.20" /></a>
+<a href="https://www.npmjs.com/package/@litfamily/litopencode"><img src="https://img.shields.io/npm/dm/@litfamily/litopencode?label=downloads&color=D7F75B" alt="npm downloads per month" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="https://github.com/wjgoarxiv/litopencode"><img src="https://img.shields.io/github/stars/wjgoarxiv/litopencode?style=social" alt="GitHub stars" /></a>
 </p>
 
-LitOpenCode adds workflow agents, slash commands, and a local evidence ledger to OpenCode.
-
-Add `lit` to a prompt and it plans, builds, checks, and writes down the next step in your project, so a later session can pick up where this one stopped. OpenCode still runs the model and asks for permission the way it always has.
+LitOpenCode keeps the goal, the plan, what was checked and the next step in `.litopencode/litgoal/` inside your project, so a long task picks up the next day where it stopped.
 
-**[Full guide and skills gallery on GitHub →](https://github.com/wjgoarxiv/litopencode#readme)**
-
-## Install
-
-You need Node.js with npm, and OpenCode.
-
-```sh
-LIT_PACKAGE='@litfamily/litopencode@latest'
-npm exec --package "$LIT_PACKAGE" -- litopencode install
-```
+**[Full guide, screens and skills gallery on GitHub →](https://github.com/wjgoarxiv/litopencode#readme)**
 
-Restart OpenCode, press **Tab**, and pick **lit-loop**. Permissions start at `safe`, where OpenCode asks you before acting. Logins and API keys stay with the provider you already set up in OpenCode.
+## Quick start
 
-To see the changes first, add `--dry-run`; it writes nothing. To skip the questions, add `--yes`; it takes the defaults and keeps choices you saved before.
+You need Node.js with npm, and OpenCode with a model provider set up.
 
 ```sh
-npm exec --package @litfamily/litopencode@latest -- litopencode install --dry-run  # preview changes
-npm exec --package @litfamily/litopencode@latest -- litopencode install --yes     # use defaults; preserve saved choices
+npm exec --package @litfamily/litopencode@latest -- litopencode install
 ```
 
-## Your first task
-
-Open an empty folder in OpenCode, pick `lit-loop`, and send:
+Add `--yes` to take the defaults, or `--dry-run` to preview without writing anything. Restart OpenCode, press **Tab**, pick **lit-loop**, open an empty folder and send:
 
 ```text
 lit Build a to-do list in one index.html with no dependencies; check adding and completing items, then leave results and next steps.
 ```
 
-You get an `index.html` to open and try. Next time, `/lit-recap` shows where you left off.
+You get an `index.html` to try, and next time `/lit-recap` shows where you left off.
 
-## The routes you'll use
+## What you get
 
-| Type | What happens |
+| You enter | What happens |
 | --- | --- |
-| `lit` or `/lit` | Start a task with a clear scope and record what was checked. |
-| `lit-plan` → `/start-work` → `/review-work` | Plan, approve, execute, and review. The planner can't edit files or run shell commands. |
-| `handoff` or `/lit-handoff` | Carry the current result and next step into another session. |
-| `/lit-recap` | Read a short recap from local state. |
-| `/litresearch` | Research with source evidence. |
-
-Beyond these, the package installs skills for debugging, refactoring, code review, research, Word reports (`lit-docx`) and PowerPoint decks (`lit-pptx`) that pick and name a design direction before building, diagrams, scientific figures, interfaces, READMEs, and prose editing (`/lit-humanizer`). Each one, with a picture of what it produces, is in the [skills gallery on GitHub](https://github.com/wjgoarxiv/litopencode#skills-at-a-glance).
-
-## What install changes
-
-Not much. Install adds the plugin to OpenCode's config and copies LitOpenCode's commands and skills into your OpenCode config folder. Your routes, which say which model handles each kind of work, are kept in `~/.config/opencode/litopencode.json`. Setting `XDG_CONFIG_HOME` moves that folder, and routes you've already customized are left as they are. Each project keeps its work record in `.litopencode/litgoal/`, and that record is what a later session reads to carry on.
+| `lit` or `/lit` | Plan, build, verify and recap a task, with a note at each step. |
+| `lit-plan` → `/start-work` → `/review-work` | Plan, approve, build and review. The planner cannot edit files. |
+| `handoff` · `/lit-recap` | Leave a continuation file for the next session, and read back what is done and what is next. |
+| `/litresearch` | Research in rounds with a source for each claim. |
+| `lit` + report or slides | An editable Word report or PowerPoint deck with its Markdown source. |
+| `/lit-humanizer` | Rewrite stiff English or Korean prose and keep the facts. |
 
-With the OpenAI provider, a fresh install uses GPT-6 Astra (`gpt-6-astra`) at `xhigh` for planning and review, and GPT-6 Luna (`gpt-6-luna`) at `max` for execution and research.
+Each skill is pictured in the [skills gallery on GitHub](https://github.com/wjgoarxiv/litopencode/blob/main/docs/skills.md).
 
-## Safety and updates
+## Updates and removal
 
-- The planner only plans. `lit-plan` has `edit`, `bash` and `task` denied, and it stays that way even if you choose the looser `balanced` or `yolo` mode.
-- LitOpenCode can update itself when it starts interactively and after an install or doctor run succeeds. To turn that off, pass `--no-auto-update` or set `LITOPENCODE_NO_AUTO_UPDATE=1`.
-- Skill learning has been removed. Learning records an earlier release left in a project's `.litopencode` folder are no longer used; keep or delete them as you like.
-- The Jev skill hint is optional and off by default. Turning it on sends eligible prompts to TypeSafe, so read the [Jev skill hint reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference.md#jev-skill-hint-optional) first. The GitHub page shows [what the toast and the doctor line look like](https://github.com/wjgoarxiv/litopencode#what-you-will-see).
-- If something seems off, `npm exec --package @litfamily/litopencode@latest -- litopencode doctor` checks the package and your configuration.
+LitOpenCode checks for updates on interactive start and after a successful install or doctor run. To turn that off, pass `--no-auto-update` or set `LITOPENCODE_NO_AUTO_UPDATE=1`. `npm exec --package @litfamily/litopencode@latest -- litopencode doctor` checks the setup and changes nothing.
 
-## Uninstall
-
-There's no uninstall command. Remove the `@litfamily/litopencode` entry from the `plugin` array in OpenCode's `opencode.jsonc` (or a custom root's `opencode.json`), then restart OpenCode. If you installed it globally:
+To remove it, delete the `@litfamily/litopencode` entry from the `plugin` array in OpenCode's `opencode.jsonc` and restart OpenCode. If you installed it globally:
 
 ```sh
 npm uninstall -g @litfamily/litopencode
 ```
 
-The [removal reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference.md#remove) covers the installed files and records you may want to keep.
-
 ## More
 
-- [Full guide on GitHub](https://github.com/wjgoarxiv/litopencode#readme)
-- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference.md) · [한국어 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/reference-Ko-KR.md)
-- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/privacy.md)
-- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/LICENSE) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.18/docs/assets/readme/JetBrainsMono-OFL.txt)
+- [Guide on GitHub](https://github.com/wjgoarxiv/litopencode/blob/main/docs/guide.md): install options, automatic handoff, troubleshooting and removal.
+- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/reference.md)
+- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/migration.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/CHANGELOG.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/privacy.md)
+- [LitFamily hub](https://github.com/wjgoarxiv/litfamily) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/LICENSE) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.20/docs/assets/readme/JetBrainsMono-OFL.txt)
+
+<details>
+<summary>Copy ASCII logo</summary>
+
+```text
+                             ▄▄▄▄
+                   ▗███▌   ▗██████▖
+ ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
+ ▐█████        ▗▟██████▌    ▝▀▜█▀▘
+ ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+ ▐█████    ▗▟█████████████████████████ ▐█▀
+ ▐█████    ████████████████████████████▀
+ ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
+ ▐█████    ▀    ▄██ ████▌█████████████▌
+ ▐█████       ▄████ ████▌█████████████▌
+ ▐█████     ▄█████▛                                 litopencode
+ ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
+ ▐█████ ▐█████▀          █████     ▐▛▀
+ ▐█████ ▐███▀            █████
+ ▐█████ ▐█▀              █████
+ ▐█████ ▝                █████
+ ▐█████▄▄▄▄▄▄▄▖          █████
+ ▐███████████▛           █████
+ ▐██████████▀            █████
+
+```
+
+</details>

package/dist/activation-routing.js

@@ -62,7 +62,9 @@ const uiHardenCue = /\b(?:harden|stress.test|hold up under|robust to)\b|튼튼
 const uiReadOnlyCue = /\b(?:read.only|don't (?:touch|change|fix)|just (?:check|tell))\b|수정은 하지|건드리지 말|고치지는 말|목록만/u;
 const uiBuildCue = /\b(?:redesign|new layout|brand.new|add|implement|build|create|make|wire up)\b|새로|추가|구현|다시 짜|재구성/u;
 const diagramCreationIntent = /^\s*(?:lit[,:]?\s+)?(?:please\s+)?(?:create|draw|make|design|render|build)\b[^.!?\n]*\b(?:diagrams?|flowcharts?|architecture maps?)\b|^\s*(?:lit\s+)?[^.!?\n]*(?:다이어그램|흐름도|구성도|구조도)[^.!?\n]*(?:그려|만들어|제작해)/mu;
-const officeAuthoringVerb = /(?<![a-z])(?:make|create|write|draft|prepare|produce|generate|convert|edit|build)(?![a-z])|만들|작성|써줘|제작|변환|편집/u;
+// "turn X into a deck/report" also authors an Office file. Within the clause, a dot followed by a
+// non-space (notes.md, q3.v2.csv) is part of a file name and does not end the sentence.
+const officeAuthoringVerb = /(?<![a-z])(?:make|create|write|draft|prepare|produce|generate|convert|edit|build)(?![a-z])|(?<![a-z])turn(?=(?:[^.!?\n]|\.(?=\S))*?(?<![a-z])into(?![a-z])(?:[^.!?\n]|\.(?=\S))*?(?<![a-z])(?:slides?|decks?|presentations?|pptx?|reports?|documents?|docx|word)(?![a-z]))|만들|작성|써줘|제작|변환|편집/u;
 const reportNoun = /(?<![a-z])(?:reports?|documents?|docx|word)(?![a-z])|보고서|리포트|기획서|제안서|문서|워드/u;
 const slidesNoun = /(?<![a-z])(?:slides?|decks?|presentations?|pptx?)(?![a-z])|발표자료|발표|슬라이드|피피티|덱/u;
 // lit-typographic-motion (MO-C-18..24). The trigger is a creation verb plus a compound motion-video

package/dist/cli/args.js

@@ -66,7 +66,10 @@ export function parseArgs(argv) {
             throw new Error(`${arg} requires a value`);
         return cleaned;
     };
-    const firstOptionIndex = command === "fetch-public" ? 2 : 1;
+    const tuiAction = command === "tui" ? argv[1] : undefined;
+    if (command === "tui" && tuiAction !== "remove")
+        throw new Error("tui requires an action: remove");
+    const firstOptionIndex = command === "fetch-public" || command === "tui" ? 2 : 1;
     if (command === "fetch-public") {
         fetchPublicUrl = cleanOption(argv[1], "fetch-public URL");
         if (!fetchPublicUrl)
@@ -298,6 +301,7 @@ export function parseArgs(argv) {
         modelSelection: resolveModelSelection(provider, model, effort, subagentModel, subagentEffort),
         modelPrompt: yes ? "never" : modelPrompt,
         outputStylePrompt: yes ? "never" : "auto",
+        ...(tuiAction === undefined ? {} : { tuiAction }),
         loop: {
             projectRoot,
             json: loopJson,

package/dist/cli/auto-update.js

@@ -255,7 +255,7 @@ async function captureSnapshot(configRoot, homeDir) {
     const snapshotPath = path.join(stateRoot(homeDir), `.auto-update-backup-${randomUUID()}`);
     await fs.mkdir(snapshotPath, { recursive: true, mode: 0o700 });
     const entries = [];
-    for (const relativePath of ["opencode.json", "opencode.jsonc", "litopencode.json", "command", "skills"]) {
+    for (const relativePath of ["opencode.json", "opencode.jsonc", "tui.json", "tui.jsonc", "litopencode.json", "command", "skills"]) {
         const source = path.join(configRoot, relativePath);
         const kind = await lstatKind(source);
         if (kind === undefined) {

package/dist/cli/doctor.js

@@ -5,6 +5,7 @@ import { defaultGlobalConfigFile, loadConfig, mergeConfigs, readLitOpenCodeConfi
 import { diagnoseModelRoutes, effectiveAuthoredAgentRoutes, projectModelRoutesForDiagnostics } from "../model-route-policy.js";
 import { litOpenCodeConfigFileForOpenCodeRoot } from "../state.js";
 import { isRecord, readJsonObjectIfPresent, readPackageMetadata } from "./json.js";
+import { parseJsonc } from "./jsonc.js";
 import { inspectCommandAliases } from "./command-aliases.js";
 import { inspectNativeSkills } from "./native-skills.js";
 import { openCodeHostCapabilities } from "./host-capabilities.js";
@@ -13,6 +14,7 @@ import { autoHandoffEnvEnabled, autoHandoffEnvPercent, createAutoHandoffSettings
 import { inspectLspCapability } from "./lsp-capability.js";
 import { probeMotionRuntime } from "./motion-runtime.js";
 import { isLitOpenCodeEntry } from "./plugin-mutation.js";
+import { inspectTuiPlugin } from "./tui-config.js";
 import { jevSkillHintDoctorLine } from "../jev-skill-hint.js";
 import { autoUpdateInstallLockPath, autoUpdateJournalPath, autoUpdateReceiptPath, isAutoUpdateDisabled, readAutoUpdateReceipt } from "./auto-update.js";
 function pluginSpec(metadata) {
@@ -25,9 +27,6 @@ function pluginEntryId(value) {
         return value[0];
     return "";
 }
-function stripJsonComments(value) {
-    return value.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
-}
 async function readOpenCodeConfig(root) {
     const resolvedRoot = path.resolve(root);
     const candidates = [path.join(resolvedRoot, "opencode.json"), path.join(resolvedRoot, "opencode.jsonc")];
@@ -42,7 +41,7 @@ async function readOpenCodeConfig(root) {
             throw error;
         }
         try {
-            const parsed = JSON.parse(candidate.endsWith(".jsonc") ? stripJsonComments(raw) : raw);
+            const parsed = parseJsonc(raw);
             return { path: candidate, config: isRecord(parsed) ? parsed : null, ...(isRecord(parsed) ? {} : { error: "expected object" }) };
         }
         catch (error) {
@@ -114,6 +113,8 @@ export async function doctor(root) {
     const installPlugin = await inspectPlugin(root, metadata);
     const commandAliases = await inspectCommandAliases(root);
     const nativeSkills = await inspectNativeSkills(root, metadata);
+    // The TUI panel is optional, so a missing entry is reported here without failing install.ok.
+    const tui = await inspectTuiPlugin(root, installPlugin.present && installPlugin.configured !== null ? installPlugin.configured : installPlugin.expected);
     const hostConfig = await readOpenCodeConfig(root);
     const motion = probeMotionRuntime(metadata.packageRoot);
     const autoHandoff = await createAutoHandoffSettings({
@@ -193,7 +194,8 @@ export async function doctor(root) {
                 ok: installPlugin.ok && commandAliases.ok && nativeSkills.ok,
                 plugin: installPlugin,
                 commandAliases,
-                nativeSkills
+                nativeSkills,
+                tui
             }
         }, null, 2)
     };

package/dist/cli/host-limits.js

@@ -1,8 +1,6 @@
 import { isRecord } from "./json.js";
-import { writeTextAtomically } from "./install-config.js";
+import { writeOpenCodeConfig } from "./install-config.js";
 import { hostLimitModelIds } from "./model-catalog.js";
-import fs from "node:fs/promises";
-import path from "node:path";
 export const contextCeilingTokens = 372000;
 export const compactionTriggerTokens = 334800;
 export const compactionReserveTokens = contextCeilingTokens - compactionTriggerTokens;
@@ -91,6 +89,5 @@ export async function ensureHostLimits(configPath, config, reconfigure) {
     const next = applyHostLimits(config);
     if (JSON.stringify(config) === JSON.stringify(next))
         return;
-    await fs.mkdir(path.dirname(configPath), { recursive: true });
-    await writeTextAtomically(configPath, JSON.stringify(next, null, 2) + "\n");
+    await writeOpenCodeConfig(configPath, next);
 }

package/dist/cli/install-config.d.ts

@@ -3,6 +3,10 @@ type AtomicWriteOverrides = {
     readonly rename?: (from: string, to: string) => Promise<void>;
 };
 export declare function writeTextAtomically(filePath: string, text: string, overrides?: AtomicWriteOverrides): Promise<void>;
+export declare class OpenCodeConfigCommentError extends Error {
+}
+export declare function renderOpenCodeConfig(filePath: string, currentText: string | null, next: Record<string, unknown>): string;
+export declare function writeOpenCodeConfig(filePath: string, next: Record<string, unknown>): Promise<void>;
 export declare function readInstallModelClassification(root: string): Promise<ModelConfigClassification>;
 export declare function readInstallModelSelection(root: string): Promise<InstallModelSelection | undefined>;
 export declare function assertExistingModelRoutesSafe(root: string): Promise<void>;

package/dist/cli/install-config.js

@@ -5,7 +5,8 @@ import { litOpenCodeAgents, registerLitOpenCodeAgents } from "../agents.js";
 import { defaultGlobalConfigFile, defaultGlobalConfigJson, mergeConfigs, readLitOpenCodeConfigFile } from "../config.js";
 import { diagnoseModelRoutes, effectiveAuthoredAgentRoutes, UnsafeModelRouteError } from "../model-route-policy.js";
 import { litOpenCodeConfigFileForOpenCodeRoot } from "../state.js";
-import { isRecord, readJsonObjectIfPresent } from "./json.js";
+import { isRecord, readJsonObjectIfPresent, readTextIfPresent } from "./json.js";
+import { editJsoncObject, formatJsoncMember, hasJsoncComments, lineEnding } from "./jsonc.js";
 import { installModelEfforts, isModelProvider, modelMenuRows, stripFastSuffix } from "./model-catalog.js";
 import { classifyModelConfig, selectedLitConfig } from "./model-policy.js";
 export async function writeTextAtomically(filePath, text, overrides = {}) {
@@ -19,6 +20,31 @@ export async function writeTextAtomically(filePath, text, overrides = {}) {
         throw error;
     }
 }
+export class OpenCodeConfigCommentError extends Error {
+}
+// A commented OpenCode config is edited in place; when an edit would delete a comment, the user is
+// shown the exact entry to write instead.
+export function renderOpenCodeConfig(filePath, currentText, next) {
+    if (currentText === null)
+        return JSON.stringify(next, null, 2) + "\n";
+    if (!hasJsoncComments(currentText)) {
+        const eol = lineEnding(currentText);
+        return (currentText.startsWith("\uFEFF") ? "\uFEFF" : "") + (JSON.stringify(next, null, 2) + "\n").replace(/\n/gu, eol);
+    }
+    const edit = editJsoncObject(currentText, next);
+    if (edit.ok)
+        return edit.text;
+    const action = edit.key in next
+        ? `set this entry yourself:\n${formatJsoncMember(edit.key, next[edit.key])}`
+        : `remove the "${edit.key}" entry yourself`;
+    throw new OpenCodeConfigCommentError(`Refusing to rewrite ${filePath}: changing its "${edit.key}" entry would delete a comment in it. ` +
+        `Nothing was written. To continue, ${action}\nthen run the command again.`);
+}
+export async function writeOpenCodeConfig(filePath, next) {
+    const text = renderOpenCodeConfig(filePath, await readTextIfPresent(filePath), next);
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await writeTextAtomically(filePath, text);
+}
 async function readValidatedConfig(root) {
     const filePath = litOpenCodeConfigFileForOpenCodeRoot(root);
     if ((await readLitOpenCodeConfigFile(filePath)) === undefined)

package/dist/cli/install-report.js

@@ -125,7 +125,8 @@ function actionLines(report) {
                 : "OpenCode context and compaction limits already ready"
             : "OpenCode context and compaction limits preserved; select LUNA to reconfigure",
         report.commandAliases.changed ? "command aliases written" : "command aliases preserved",
-        report.nativeSkills.changed ? "native skills written" : "native skills preserved"
+        report.nativeSkills.changed ? "native skills written" : "native skills preserved",
+        report.tui.changed ? "TUI mission panel registered" : "TUI mission panel already ready"
     ];
 }
 function progressLine(label) {
@@ -166,6 +167,7 @@ export function renderInstallReport(report) {
         line("", actions[2]),
         line("", actions[3]),
         line("", actions[4]),
+        line("", actions[5]),
         ...section("Routes"),
         line("Model", modelRoute(report)),
         line("Effort", report.litopencodeConfig.model.effort ?? "preserve existing"),
@@ -189,6 +191,7 @@ export function renderInstallReport(report) {
         line("Native skills", report.nativeSkills.write.length + " managed / " + report.nativeSkills.preserve.length + " preserved"),
         ...nativeSkillsLinkLines(report),
         line("Plugin entries", report.plugin.currentCount + " -> " + report.plugin.resultCount),
+        line("TUI config", report.tui.path),
         ...section("Progress"),
         progressLine("Resolve package"),
         progressLine("Read OpenCode config"),