@litfamily/litcodex 1.0.9 → 1.0.11
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.
- package/README-Ko-KR.md +48 -41
- package/README.md +57 -46
- package/dist/install/doctor.js +16 -1
- package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
- package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
- package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
- package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
- package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
- package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
- package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
- package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
- package/node_modules/@litcodex/lit-loop/package.json +1 -1
- package/package.json +2 -2
- package/readme-assets/badge-version.svg +1 -1
package/README-Ko-KR.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitCodex 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
|
-
<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
5
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
4
|
+
<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-version.svg" alt="1.0.11" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-license.svg" alt="MIT license" /></a>
|
|
6
6
|
</p>
|
|
7
7
|
|
|
8
8
|
<p align="center">
|
|
9
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
9
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-book-open.svg" width="16" alt="" /> 문서</a> <a href="#설치">설치</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
@@ -24,13 +24,13 @@ LitCodex는 Codex CLI 플러그인입니다. 계획, 검토, 조사와 오래
|
|
|
24
24
|
Node.js 22 이상과 Codex CLI가 필요합니다.
|
|
25
25
|
|
|
26
26
|
```sh
|
|
27
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
27
|
+
npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex install
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
설치기는
|
|
31
|
-
설치 중에
|
|
32
|
-
`gpt-6-luna`/`max
|
|
33
|
-
`npm exec --yes --package @litfamily/litcodex@1.0.
|
|
30
|
+
설치기는 플러그인과 훅, 에이전트를 등록하고 `~/.codex/config.toml`에서는 자기가 관리하는 항목만 고칩니다.
|
|
31
|
+
설치 중에 어떤 모델이 작업을 이끌지(리드), 어떤 모델이 거들지(헬퍼), 답변 스타일은 무엇으로 할지 묻습니다.
|
|
32
|
+
새로 설치하면 리드는 `gpt-6-astra`/`xhigh`, 헬퍼는 `gpt-6-luna`/`max`로 시작합니다. 바뀔 내용을 먼저 보려면
|
|
33
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
|
|
34
34
|
설치하려면 `install` 뒤에 `--yes`를 붙이세요.
|
|
35
35
|
|
|
36
36
|
전역 명령으로 쓰려면 다음을 실행합니다.
|
|
@@ -40,19 +40,23 @@ npm install -g @litfamily/litcodex
|
|
|
40
40
|
litcodex install
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
|
|
44
|
-
`lit-typographic-motion
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
`litcodex motion-runtime install`로 다시
|
|
48
|
-
`CI=1`을 설정하세요. `litcodex install`도 같은 준비 과정을 실행하며, 이를 끄는 옵션은 없습니다.
|
|
43
|
+
전역으로 설치하면 `CI`가 설정되어 있지 않은 한 짧은 설치 스크립트가 환영 문구를 보여 주고, 영상 스킬
|
|
44
|
+
`lit-typographic-motion`이 쓸 도구를 미리 받아 둡니다. 처음 영상을 요청할 때 렌더링 도구가 이미 준비되어 있게
|
|
45
|
+
하려는 것입니다. 그래서 인터넷을 조금 씁니다. 버전이 고정된 npm 패키지는 레지스트리에서, 고정된 글꼴·라이선스 파일은 GitHub와 apache.org에서
|
|
46
|
+
받아 모두 `${XDG_CACHE_HOME:-~/.cache}/litcodex/motion-runtime/`에 둡니다. 브라우저는 받지 않습니다. 이 단계가
|
|
47
|
+
끝나지 않아도 LitCodex 설치는 그대로 남고, 나중에 `litcodex motion-runtime install`로 다시 해 보면 됩니다.
|
|
49
48
|
|
|
50
|
-
|
|
49
|
+
전역 설치 때 이 스크립트를 빼려면 `--ignore-scripts`를 붙이거나 그 명령에만 `CI=1`을 설정하세요.
|
|
50
|
+
다만 이렇게 빼도 내려받기가 뒤로 미뤄질 뿐입니다. `litcodex install`이 설치에 성공한 뒤 같은 도구를 준비하고,
|
|
51
|
+
이 단계는 끌 수 없습니다.
|
|
52
|
+
|
|
53
|
+
> 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex <command>` 형식을 사용하세요.
|
|
51
54
|
|
|
52
55
|
기존 설정과 떼어 놓고 써 보려면
|
|
53
56
|
[격리된 체험 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial)를
|
|
54
|
-
따르세요.
|
|
55
|
-
|
|
57
|
+
따르세요. 체험용 홈 디렉터리를 통째로 따로 만드는 방법인데, `CODEX_HOME` 하나만 바꾸면 기존 설정이 여전히
|
|
58
|
+
읽힐 수 있기 때문입니다. Windows에서도 설치기와 CLI shim은 동작하고, POSIX가 필요한 Python 경로만
|
|
59
|
+
`BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`으로 멈춥니다.
|
|
56
60
|
|
|
57
61
|
## 첫 작업
|
|
58
62
|
|
|
@@ -62,8 +66,8 @@ GitHub와 apache.org에서 받고, 브라우저는 내려받지 않습니다.
|
|
|
62
66
|
lit 회원가입 폼에 입력 검증을 추가해줘
|
|
63
67
|
```
|
|
64
68
|
|
|
65
|
-
|
|
66
|
-
|
|
69
|
+
답변이 `🔥 **LIT IGNITED · <discipline>** 🔥` 한 줄로 시작하면 요청이 LitCodex에 닿은 것입니다. 목표는 성공
|
|
70
|
+
기준을 모두 통과해야 완료되고, 기록은 프로젝트의 `.litcodex/lit-loop/` 아래에 남습니다.
|
|
67
71
|
|
|
68
72
|
직접 판단할 수 있는 첫 작업이 필요하다면 빈 폴더에서 이렇게 시작해 보세요.
|
|
69
73
|
|
|
@@ -86,8 +90,8 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
|
|
|
86
90
|
| `review-work` | 변경과 그 근거를 검토합니다. |
|
|
87
91
|
| `litresearch` | 출처를 달아 조사하고, 아직 불확실한 부분을 따로 적어 둡니다. |
|
|
88
92
|
|
|
89
|
-
|
|
90
|
-
|
|
93
|
+
메시지 전체가 그 한 단어일 때만 동작하는 단어가 두 개 있습니다. `handoff`만 보내면 인수인계 문서를 만들고,
|
|
94
|
+
`lit-scientific-visualization`만 보내면 시각화 어댑터를 불러옵니다. Python 패키지는 설치하지 않습니다.
|
|
91
95
|
|
|
92
96
|
## 패키지에 들어 있는 스킬
|
|
93
97
|
|
|
@@ -97,7 +101,7 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
|
|
|
97
101
|
|
|
98
102
|
**작업을 계획하고 실행하기**
|
|
99
103
|
|
|
100
|
-
- `lit-loop`(`lit`):
|
|
104
|
+
- `lit-loop`(`lit`): 세션이 바뀌어도 이어지는 루프 안에서 일하고, 확인하지 못한 것은 그대로 적어 둡니다.
|
|
101
105
|
- `litwork`: 처음부터 끝까지 꼼꼼한 구현이나 수정입니다. 실패하는 테스트 먼저, 그다음 실제 화면에서 증명합니다.
|
|
102
106
|
- `lit-plan`: `.litcodex/plans/`에 번호 붙은 승인 계획을 만듭니다. 계획만 세웁니다.
|
|
103
107
|
- Start Work(`lit start work <승인된 계획>`): 승인된 계획을 다섯 관문으로 실행합니다.
|
|
@@ -109,7 +113,7 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
|
|
|
109
113
|
|
|
110
114
|
**검토, 조사, 지식**
|
|
111
115
|
|
|
112
|
-
- `review-work`:
|
|
116
|
+
- `review-work`: 리뷰 다섯 개가 따로 돌고, 하나라도 통과하지 못하면 승인이 나지 않습니다.
|
|
113
117
|
- `litresearch`: 조사를 요청할 때만 움직이며, 여러 갈래로 증거를 모아 출처와 함께 종합합니다.
|
|
114
118
|
- `autoresearch`: 승인된 예산 안에서 실험을 반복합니다.
|
|
115
119
|
- `autoconference`: 예산을 정해 두고 연구 회의를 엽니다.
|
|
@@ -155,45 +159,48 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
|
|
|
155
159
|
## 설치하면 달라지는 것
|
|
156
160
|
|
|
157
161
|
Codex가 플러그인을 불러오고 훅을 실행합니다. 훅은 요청이 어떤 모드에 속하는지 가리고, 스킬은 에이전트의 작업
|
|
158
|
-
절차를 안내하며, 루프 CLI는 프로젝트 기록을 관리합니다.
|
|
159
|
-
|
|
162
|
+
절차를 안내하며, 루프 CLI는 프로젝트 기록을 관리합니다. Codex 목표 도구는 LitCodex가 직접 부르지 않고, 도구가
|
|
163
|
+
있을 때 에이전트가 씁니다. 멈췄거나(paused) 막힌(blocked) 목표는 아래 복구 절차를 따르세요.
|
|
160
164
|
|
|
161
165
|
- Codex에 플러그인·훅·에이전트가 등록되고 `~/.codex/config.toml`의 관리 항목이 갱신됩니다. 관련 없는 Codex
|
|
162
166
|
설정은 그대로 둡니다. `--reconfigure` 전에는 바뀔 내용을 먼저 확인하세요.
|
|
163
|
-
-
|
|
167
|
+
- 고른 모델은 설정 파일에 적히는 값입니다. 그 모델을 실제로 쓸 수 있는지, 실제로 도는지는 Codex와 사용자 계정에 달려 있습니다.
|
|
164
168
|
- 프로젝트마다 `.litcodex/lit-loop/` 아래에 로컬 기록이 생기며, Git과 패키지에서는 제외됩니다.
|
|
165
|
-
-
|
|
166
|
-
캐시해 둔
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
`--json`·`--dry-run
|
|
169
|
+
- doctor 진단은 Codex 설정, 설치 상태, 플러그인 상태를 바꾸지 않고 살펴보기만 합니다. 터미널에서 직접 실행해
|
|
170
|
+
성공적으로 끝난 doctor처럼 조건에 맞는 실행이면 캐시해 둔 새 버전 안내가 뜰 수 있고, 백그라운드 작업이 정해진
|
|
171
|
+
레지스트리만 조회해 `~/.litcodex/update-check.json`에 적어 둡니다. 이 작업은 아무것도 설치하지 않습니다. 이와
|
|
172
|
+
별개로, 조건에 맞는 대화형 관리 명령 뒤에는 업데이트 실행기가 새 전역 패키지를 설치할 수 있습니다.
|
|
173
|
+
`LITCODEX_NO_UPDATE_CHECK=1`을 설정하면 둘 다 꺼집니다. 실패했거나 `--json`·`--dry-run`으로 돌렸거나,
|
|
174
|
+
비TTY·CI 환경이거나 이 설정으로 끈 doctor 실행은 부수 효과가 없습니다.
|
|
170
175
|
- 테스트, 픽스처, 테스트 헬퍼, Vitest 설정은 저장소에만 있습니다. npm 패키지와 설치된 마켓플레이스 플러그인에는
|
|
171
176
|
들어가지 않습니다.
|
|
172
177
|
|
|
173
|
-
선택 기능인 Jev 스킬 힌트는
|
|
174
|
-
프롬프트가 매번 TypeSafe(typesafe.ai)로
|
|
175
|
-
|
|
176
|
-
|
|
178
|
+
선택 기능인 Jev 스킬 힌트는 평범한 요청에 맞는 번들 스킬을 제안해 주며, 기본값은 꺼짐입니다.
|
|
179
|
+
켜면(`LITCODEX_JEV=1`과 본인의 `TYPESAFE_API_KEY`) 조건에 맞는 프롬프트가 매번 TypeSafe(typesafe.ai)로 갑니다.
|
|
180
|
+
2,000자로 자르고 홈 경로, 이메일 주소, 토큰 형태의 문자열을 가린 뒤 나머지는 그대로 보냅니다. 파일, 도구 출력,
|
|
181
|
+
대화 기록은 보내지 않습니다. 켜기 전에
|
|
182
|
+
[전체 설명](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#jev-스킬-힌트-선택)(각 상태가 화면에서 어떻게 보이는지도 나옵니다)과
|
|
177
183
|
[개인정보 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)를 읽어 주세요.
|
|
178
184
|
|
|
179
185
|
## 확인, 문제 해결, 제거
|
|
180
186
|
|
|
181
187
|
```sh
|
|
182
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
188
|
+
npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex doctor
|
|
183
189
|
```
|
|
184
190
|
|
|
185
191
|
`litcodex doctor`는 등록·훅·설정·호스트 기능을, `litcodex loop doctor`는 현재 프로젝트의 루프 상태를 확인합니다.
|
|
186
|
-
|
|
192
|
+
둘 다 설치 상태를 보는 검사이고, 로그인한 모델 작업이 실제로 도는지는 작은 작업을 하나 맡겨 보면 알 수 있습니다.
|
|
187
193
|
|
|
188
194
|
- **`lit`을 입력해도 반응이 없다면.** `litcodex doctor`를 실행하고 Codex에서 훅을 승인했는지 확인하세요.
|
|
189
195
|
- **명령을 찾지 못한다면.** 위의 `npm exec` 형식을 쓰거나, npm 전역 bin 경로를 `PATH`에 넣으세요.
|
|
190
|
-
- **
|
|
196
|
+
- **Codex 목표가 멈췄거나(paused) 막혔다면(blocked).** `/goal resume`으로 재개하고 활성 상태인지 확인한 뒤
|
|
191
197
|
`litcodex loop run --retry-failed`로 다시 시도하세요. 미완료 목표는 지우지 말고 남겨 두세요.
|
|
192
|
-
-
|
|
198
|
+
- **아무 출력 없이 창(pane)이 닫힌다면.** 어느 단계가 문제인지부터 찾습니다. 열린 터미널에서 도움말, 설치,
|
|
199
|
+
doctor를 하나씩 실행해 각 종료 코드를 적어 두고
|
|
193
200
|
[문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)을 참고하세요.
|
|
194
201
|
|
|
195
202
|
```sh
|
|
196
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
203
|
+
npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex uninstall
|
|
197
204
|
```
|
|
198
205
|
|
|
199
206
|
플러그인과 LitCodex가 관리하는 설정을 지우고, 관련 없는 설정은 그대로 둡니다.
|
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitCodex robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
|
-
<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
5
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
4
|
+
<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-version.svg" alt="1.0.11" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-license.svg" alt="MIT license" /></a>
|
|
6
6
|
</p>
|
|
7
7
|
|
|
8
8
|
<p align="center">
|
|
9
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
9
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-book-open.svg" width="16" alt="" /> Docs</a> <a href="#install">Install</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
@@ -24,14 +24,15 @@ the results stay in your project, where a later session can pick them up.
|
|
|
24
24
|
You need Node.js 22 or later and Codex CLI.
|
|
25
25
|
|
|
26
26
|
```sh
|
|
27
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
27
|
+
npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex install
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
The installer registers the plugin, hooks and agents, and
|
|
31
|
-
`~/.codex/config.toml`. It asks
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
30
|
+
The installer registers the plugin, its hooks and its agents, and changes only the keys it manages in
|
|
31
|
+
`~/.codex/config.toml`. It asks which model leads, which model helps, and which output style you like. A
|
|
32
|
+
fresh install starts with `gpt-6-astra` at `xhigh` for the lead and `gpt-6-luna` at `max` for helpers. To
|
|
33
|
+
see the changes before they happen, run
|
|
34
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex --dry-run install`. To install without
|
|
35
|
+
any questions, add `--yes` after `install`.
|
|
35
36
|
|
|
36
37
|
For a global command:
|
|
37
38
|
|
|
@@ -40,19 +41,24 @@ npm install -g @litfamily/litcodex
|
|
|
40
41
|
litcodex install
|
|
41
42
|
```
|
|
42
43
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
That
|
|
46
|
-
GitHub and apache.org,
|
|
47
|
-
|
|
48
|
-
`litcodex install`
|
|
44
|
+
After a global install, unless `CI` is set, a short setup script prints a welcome and gets the video skill,
|
|
45
|
+
`lit-typographic-motion`, ready ahead of time, so its rendering tools are in place before your first
|
|
46
|
+
video. That means a few downloads: pinned npm packages from your registry and pinned font and license
|
|
47
|
+
files from GitHub and apache.org, all into `${XDG_CACHE_HOME:-~/.cache}/litcodex/motion-runtime/`. No
|
|
48
|
+
browser is downloaded. If the step does not finish, LitCodex is still installed; run
|
|
49
|
+
`litcodex motion-runtime install` later to try again.
|
|
49
50
|
|
|
50
|
-
|
|
51
|
+
To keep the script out of the global install, add `--ignore-scripts` or set `CI=1` for that command.
|
|
52
|
+
That only postpones the downloads: `litcodex install` prepares
|
|
53
|
+
the same tools after a successful install, with no switch to turn it off.
|
|
54
|
+
|
|
55
|
+
> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex <command>`.
|
|
51
56
|
|
|
52
57
|
To try LitCodex apart from your existing settings, follow the
|
|
53
|
-
[isolated trial guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial)
|
|
54
|
-
|
|
55
|
-
need POSIX stop
|
|
58
|
+
[isolated trial guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial).
|
|
59
|
+
It gives the trial a whole home of its own, since changing only `CODEX_HOME` still lets your existing
|
|
60
|
+
settings be found. On Windows the installer and CLI shims work; Python routes that need POSIX stop there
|
|
61
|
+
with `BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`.
|
|
56
62
|
|
|
57
63
|
## First task
|
|
58
64
|
|
|
@@ -62,9 +68,9 @@ Open Codex in your project, approve the LitCodex hooks in the startup review, an
|
|
|
62
68
|
lit add input validation to the signup form
|
|
63
69
|
```
|
|
64
70
|
|
|
65
|
-
The reply opens with `🔥 **LIT IGNITED · <discipline>**
|
|
66
|
-
A goal is complete
|
|
67
|
-
`.litcodex/lit-loop/` in your project.
|
|
71
|
+
The reply opens with `🔥 **LIT IGNITED · <discipline>** 🔥`, which tells you the request reached
|
|
72
|
+
LitCodex. A goal is complete once every one of its success criteria passes, and the records live
|
|
73
|
+
under `.litcodex/lit-loop/` in your project.
|
|
68
74
|
|
|
69
75
|
For a first run you can judge yourself, try this in an empty folder:
|
|
70
76
|
|
|
@@ -87,8 +93,9 @@ was recorded, and sending `handoff` on its own before you leave gives the next s
|
|
|
87
93
|
| `review-work` | Reviews the change and its evidence. |
|
|
88
94
|
| `litresearch` | Researches with sources and keeps track of what is still uncertain. |
|
|
89
95
|
|
|
90
|
-
Send exact bare `handoff`
|
|
91
|
-
`lit-scientific-visualization` hook route loads the plotting adapter;
|
|
96
|
+
Two words work only when they are the whole message. Send exact bare `handoff` to write a continuation
|
|
97
|
+
packet. The exact bare `lit-scientific-visualization` hook route loads the plotting adapter;
|
|
98
|
+
it does not install Python dependencies.
|
|
92
99
|
|
|
93
100
|
## What else is in the package
|
|
94
101
|
|
|
@@ -98,8 +105,8 @@ You can pick these skills in the Codex skill picker or mention one by scoped nam
|
|
|
98
105
|
|
|
99
106
|
**Planning and running work**
|
|
100
107
|
|
|
101
|
-
- `lit-loop` (`lit`): works inside
|
|
102
|
-
- `litwork`: a careful
|
|
108
|
+
- `lit-loop` (`lit`): works inside a loop that survives across sessions, and writes down what it could not verify.
|
|
109
|
+
- `litwork`: a careful build or fix from start to finish, failing test first, then proof where the thing actually runs.
|
|
103
110
|
- `lit-plan`: an approved plan with numbered rows in `.litcodex/plans/`; planning only.
|
|
104
111
|
- Start Work (`lit start work <approved-plan>`): runs an approved plan through five gates.
|
|
105
112
|
- `litgoal`: binds one goal with observable criteria to the loop.
|
|
@@ -110,7 +117,7 @@ You can pick these skills in the Codex skill picker or mention one by scoped nam
|
|
|
110
117
|
|
|
111
118
|
**Review, research and knowledge**
|
|
112
119
|
|
|
113
|
-
- `review-work`: five
|
|
120
|
+
- `review-work`: five separate reviews, and any one of them can hold back approval.
|
|
114
121
|
- `litresearch`: parallel evidence gathering and a cited synthesis, only when you ask for research.
|
|
115
122
|
- `autoresearch` and `autoconference`: an approved, budgeted experiment loop, and a budgeted research conference.
|
|
116
123
|
- `lit-fetch`: reads a public page with URL, DNS and text-safety checks when ordinary retrieval falls short.
|
|
@@ -156,48 +163,52 @@ In ten one-line A/B tasks against plain Codex, the final verdicts for LitCodex w
|
|
|
156
163
|
## What it changes
|
|
157
164
|
|
|
158
165
|
Codex hosts the plugin and runs its hooks. The hooks work out which mode a request belongs to, the skills
|
|
159
|
-
guide the agent, and the loop CLI keeps the project records.
|
|
160
|
-
|
|
161
|
-
step below.
|
|
166
|
+
guide the agent, and the loop CLI keeps the project records. LitCodex never calls Codex's goal tools
|
|
167
|
+
itself; the agent uses them when they are there. A paused or blocked goal needs the recovery step below.
|
|
162
168
|
|
|
163
169
|
- Codex gets the plugin, hooks and agents, plus the managed keys in `~/.codex/config.toml`. Your unrelated
|
|
164
170
|
Codex settings stay as they are. Look at the planned changes before you use `--reconfigure`.
|
|
165
|
-
-
|
|
171
|
+
- The model you pick is a setting in your config. Whether it is open to you, and whether it actually
|
|
172
|
+
runs, is up to Codex and your account.
|
|
166
173
|
- Each project gets local records under `.litcodex/lit-loop/`, kept out of Git and packages.
|
|
167
174
|
- The doctor diagnostic core never modifies Codex config, install state or plugin state. An eligible
|
|
168
|
-
interactive doctor run may show a cached advisory notice
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
175
|
+
interactive doctor run (a successful one you start by hand) may show a cached advisory notice about a
|
|
176
|
+
newer version; a detached worker keeps it fresh with a fixed registry refresh saved at
|
|
177
|
+
`~/.litcodex/update-check.json`, and installs nothing. A separate foreground updater can install a newer
|
|
178
|
+
global package after an eligible interactive management command. Set `LITCODEX_NO_UPDATE_CHECK=1` to
|
|
179
|
+
turn off both. A doctor run that failed, or ran with `--json`, `--dry-run`, in a non-TTY or CI shell, or
|
|
180
|
+
with the opt-out set, stays side-effect-free.
|
|
173
181
|
- Tests, fixtures, test helpers and the Vitest configuration live only in the repository. Neither the npm
|
|
174
182
|
package nor the installed marketplace plugin includes them.
|
|
175
183
|
|
|
176
|
-
The optional Jev skill hint
|
|
177
|
-
`TYPESAFE_API_KEY`) sends each eligible prompt to TypeSafe
|
|
178
|
-
|
|
179
|
-
|
|
184
|
+
The optional Jev skill hint suggests a bundled skill for a plain prompt, and it is off by default.
|
|
185
|
+
Turning it on (`LITCODEX_JEV=1` plus your own `TYPESAFE_API_KEY`) sends each eligible prompt to TypeSafe
|
|
186
|
+
(typesafe.ai). The prompt is cut to 2,000 characters and home paths, email addresses and token-shaped
|
|
187
|
+
strings are redacted; the rest of it is sent as written. Nothing else from the session goes with it:
|
|
188
|
+
no files, tool output or history.
|
|
189
|
+
Read [the full description](https://github.com/wjgoarxiv/litcodex#jev-skill-hint-optional), which shows what
|
|
190
|
+
appears on screen in each state, and the
|
|
180
191
|
[privacy notes](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)
|
|
181
192
|
before you turn it on.
|
|
182
193
|
|
|
183
194
|
## Check, fix, remove
|
|
184
195
|
|
|
185
196
|
```sh
|
|
186
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
197
|
+
npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex doctor
|
|
187
198
|
```
|
|
188
199
|
|
|
189
200
|
`litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks the
|
|
190
|
-
current project's loop state.
|
|
201
|
+
current project's loop state. Both look at the setup; a small real task shows whether signed-in model work runs.
|
|
191
202
|
|
|
192
203
|
- **`lit` does nothing.** Run `litcodex doctor` and check that the hooks are approved in Codex.
|
|
193
204
|
- **The command is missing.** Use the `npm exec` form above, or put npm's global bin directory on your `PATH`.
|
|
194
205
|
- **A native goal is paused or blocked.** Run `/goal resume`, confirm the goal is active, then retry with
|
|
195
206
|
`litcodex loop run --retry-failed`. Keep the unfinished goal.
|
|
196
|
-
- **The pane closes before any output.**
|
|
197
|
-
|
|
207
|
+
- **The pane closes before any output.** Find the failing step: run help, install and doctor one at a
|
|
208
|
+
time in an open terminal, note each exit status, and see [troubleshooting](https://github.com/wjgoarxiv/litcodex#troubleshooting).
|
|
198
209
|
|
|
199
210
|
```sh
|
|
200
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
211
|
+
npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex uninstall
|
|
201
212
|
```
|
|
202
213
|
|
|
203
214
|
This removes the plugin and the config LitCodex manages, and leaves your other settings alone.
|
package/dist/install/doctor.js
CHANGED
|
@@ -8,6 +8,7 @@ import { createRequire } from "node:module";
|
|
|
8
8
|
import { homedir } from "node:os";
|
|
9
9
|
import { join } from "node:path";
|
|
10
10
|
import { EXPLICIT_GPT56_SOL_MODEL, GPT56_MODELS } from "../config-migration/gpt56-policy.js";
|
|
11
|
+
import { isNewer } from "../update-check.js";
|
|
11
12
|
import { inspectAgentRouting, routingReport } from "./agent-routing.js";
|
|
12
13
|
import { detectAuthMode } from "./auth-mode.js";
|
|
13
14
|
import { probeBundledSkills } from "./bundled-skills.js";
|
|
@@ -193,8 +194,22 @@ function readAutoUpdateReport(env) {
|
|
|
193
194
|
try {
|
|
194
195
|
const parsed = JSON.parse(readFileSync(receiptPath, "utf8"));
|
|
195
196
|
if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
|
|
196
|
-
const
|
|
197
|
+
const fields = parsed;
|
|
198
|
+
const status = fields["status"];
|
|
197
199
|
if (typeof status === "string") {
|
|
200
|
+
const target = fields["latestVersion"];
|
|
201
|
+
// A failed update whose target the installed package has since reached (or passed) is history:
|
|
202
|
+
// a later install finished the job, so the old receipt no longer describes this machine.
|
|
203
|
+
if (status === "unknown-state" &&
|
|
204
|
+
typeof target === "string" &&
|
|
205
|
+
(target === PACKAGE_VERSION || isNewer(PACKAGE_VERSION, target))) {
|
|
206
|
+
return {
|
|
207
|
+
enabled,
|
|
208
|
+
status: "resolved",
|
|
209
|
+
receiptPath,
|
|
210
|
+
detail: `an earlier update to ${target} did not finish, and ${PACKAGE_VERSION} is installed now`,
|
|
211
|
+
};
|
|
212
|
+
}
|
|
198
213
|
return {
|
|
199
214
|
enabled,
|
|
200
215
|
status,
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@litcodex/lit-loop",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.11",
|
|
4
4
|
"description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"private": true,
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@litcodex/lit-loop",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.11",
|
|
4
4
|
"description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"private": true,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@litfamily/litcodex",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.11",
|
|
4
4
|
"description": "Codex loop harness installer. Run `npm exec --package @litfamily/litcodex -- litcodex install` to set up the LitCodex Codex platform: the bare `lit` hook and the durable lit-loop runtime.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"codex",
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
"readme-assets"
|
|
45
45
|
],
|
|
46
46
|
"dependencies": {
|
|
47
|
-
"@litcodex/lit-loop": "1.0.
|
|
47
|
+
"@litcodex/lit-loop": "1.0.11"
|
|
48
48
|
},
|
|
49
49
|
"bundledDependencies": [
|
|
50
50
|
"@litcodex/lit-loop"
|
|
@@ -1 +1 @@
|
|
|
1
|
-
<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.11"><title>release: 1.0.11</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.11</text></g></svg>
|