@litfamily/litcodex 1.0.18 → 1.0.20
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 +46 -147
- package/README.md +46 -150
- package/dist/auto-update.d.ts +2 -1
- package/dist/auto-update.js +2 -1
- package/dist/cli.d.ts +1 -1
- package/dist/cli.js +85 -5
- package/dist/config-migration/gpt56-policy.js +0 -3
- package/dist/config-migration/multi-agent-v2-guard.js +10 -21
- package/dist/config-migration/root-settings.js +30 -31
- package/dist/config-migration/toml-lines.d.ts +12 -0
- package/dist/config-migration/toml-lines.js +113 -0
- package/dist/config-migration/toml-shape.js +8 -15
- package/dist/install/doctor-render.js +19 -0
- package/dist/install/doctor-tui.d.ts +7 -0
- package/dist/install/doctor-tui.js +65 -0
- package/dist/install/doctor.js +2 -0
- package/dist/install/generated-skill-payload-hashes.d.ts +5 -5
- package/dist/install/generated-skill-payload-hashes.js +5 -5
- package/dist/install/index.d.ts +6 -1
- package/dist/install/index.js +16 -2
- package/dist/install/office-runtime.d.ts +1 -0
- package/dist/install/office-runtime.js +2 -2
- package/dist/install/types.d.ts +10 -0
- package/dist/install/uninstall.d.ts +2 -0
- package/dist/install/uninstall.js +12 -1
- package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
- package/marketplace/plugins/litcodex/components/auto-update/dist/auto-update.d.ts +16 -1
- package/marketplace/plugins/litcodex/components/auto-update/dist/auto-update.js +99 -13
- 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/dist/deliverable-hedge-guard.d.ts +6 -0
- package/marketplace/plugins/litcodex/components/rules/dist/deliverable-hedge-guard.js +10 -29
- 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/marketplace/plugins/litcodex/hooks/hooks.json +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/runtime/package-lock.json +167 -119
- package/marketplace/plugins/litcodex/skills/lit-pptx/runtime/package.json +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +3 -3
- package/marketplace/plugins/litcodex/skills/readme-studio/templates/hyperframes-cover/package-lock.json +169 -121
- package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
- package/model-catalog.json +17 -8
- package/node_modules/@litcodex/lit-loop/README.md +1 -1
- package/node_modules/@litcodex/lit-loop/package.json +1 -1
- package/package.json +12 -4
- package/readme-assets/badge-version.svg +1 -1
package/README-Ko-KR.md
CHANGED
|
@@ -1,62 +1,45 @@
|
|
|
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.20/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.20/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.20/readme-assets/badge-version.svg" alt="1.0.20" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.20/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.20/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.20/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.20/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
13
13
|
|
|
14
14
|
**Keep the work lit.**
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
다음 세션에 그 기록을 읽게 해서 이어갈 수 있습니다.
|
|
16
|
+
요청을 확인 기준이 붙은 목표로 바꾸고, 그 증거를 프로젝트에 남기고, 끝내지 못한 일은 다음 세션에 넘겨 주는
|
|
17
|
+
Codex CLI 플러그인입니다.
|
|
19
18
|
|
|
20
|
-
**[전체
|
|
19
|
+
**[GitHub에서 전체 안내 보기](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md)** · [English](https://github.com/wjgoarxiv/litcodex#readme)
|
|
21
20
|
|
|
22
21
|
## 설치
|
|
23
22
|
|
|
24
23
|
Node.js 22 이상과 Codex CLI가 필요합니다.
|
|
25
24
|
|
|
26
25
|
```sh
|
|
27
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
26
|
+
npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex install
|
|
28
27
|
```
|
|
29
28
|
|
|
30
|
-
설치기는
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
`npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
|
|
29
|
+
설치기는 어떤 모델이 이끌지, 어떤 모델이 거들지, 답변 스타일은 무엇으로 할지 묻고, 쓰려는 내용을 먼저 보여 준 뒤
|
|
30
|
+
`~/.codex/config.toml`에서 자기가 관리하는 항목만 고칩니다. 계획만 먼저 보려면
|
|
31
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
|
|
34
32
|
설치하려면 `install` 뒤에 `--yes`를 붙이세요.
|
|
35
33
|
|
|
36
|
-
전역 명령으로 쓰려면 다음을 실행합니다.
|
|
37
|
-
|
|
38
34
|
```sh
|
|
39
35
|
npm install -g @litfamily/litcodex
|
|
40
36
|
litcodex install
|
|
41
37
|
```
|
|
42
38
|
|
|
43
|
-
전역으로 설치하면
|
|
44
|
-
|
|
45
|
-
하려는 것입니다. 그래서 인터넷을 조금 씁니다. 버전이 고정된 npm 패키지는 레지스트리에서, 고정된 글꼴·라이선스 파일은 GitHub와 apache.org에서
|
|
46
|
-
받아 모두 `${XDG_CACHE_HOME:-~/.cache}/litcodex/motion-runtime/`에 둡니다. 브라우저는 받지 않습니다. 이 단계가
|
|
47
|
-
끝나지 않아도 LitCodex 설치는 그대로 남고, 나중에 `litcodex motion-runtime install`로 다시 해 보면 됩니다.
|
|
48
|
-
|
|
49
|
-
전역 설치 때 이 스크립트를 빼려면 `--ignore-scripts`를 붙이거나 그 명령에만 `CI=1`을 설정하세요.
|
|
50
|
-
다만 이렇게 빼도 내려받기가 뒤로 미뤄질 뿐입니다. `litcodex install`이 설치에 성공한 뒤 같은 도구를 준비하고,
|
|
51
|
-
이 단계는 끌 수 없습니다.
|
|
52
|
-
|
|
53
|
-
> 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex <command>` 형식을 사용하세요.
|
|
39
|
+
전역으로 설치하면 영상 스킬이 쓸 도구를 미리 준비하느라 버전이 고정된 파일 몇 개를 내려받습니다. 무엇을 받는지와
|
|
40
|
+
건너뛰는 방법은 [설치 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install-Ko-KR.md#전역-명령으로-쓰기)에 있습니다.
|
|
54
41
|
|
|
55
|
-
|
|
56
|
-
[격리된 체험 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial)를
|
|
57
|
-
따르세요. 체험용 홈 디렉터리를 통째로 따로 만드는 방법인데, `CODEX_HOME` 하나만 바꾸면 기존 설정이 여전히
|
|
58
|
-
읽힐 수 있기 때문입니다. Windows에서도 설치기와 CLI shim은 동작하고, POSIX가 필요한 Python 경로만
|
|
59
|
-
`BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`으로 멈춥니다.
|
|
42
|
+
> 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex <command>` 형식을 사용하세요.
|
|
60
43
|
|
|
61
44
|
## 첫 작업
|
|
62
45
|
|
|
@@ -66,141 +49,57 @@ litcodex install
|
|
|
66
49
|
lit 회원가입 폼에 입력 검증을 추가해줘
|
|
67
50
|
```
|
|
68
51
|
|
|
69
|
-
답변이 `🔥 **LIT IGNITED · <discipline>** 🔥` 한 줄로
|
|
70
|
-
|
|
52
|
+
답변이 `🔥 **LIT IGNITED · <discipline>** 🔥` 한 줄로 시작합니다. 목표는 모든 기준에 통과 증거가 있어야 완료되고,
|
|
53
|
+
기록은 프로젝트의 `.litcodex/lit-loop/` 아래에 남습니다. `lit recap`으로 다시 읽을 수 있습니다. 세션을 마치기 전에
|
|
54
|
+
`handoff`만 따로 보내면 다음 세션이 시작할 인수인계 문서가 생깁니다. `lit-scientific-visualization`만 보내면 시각화
|
|
55
|
+
어댑터를 불러오며, Python 패키지는 설치하지 않습니다.
|
|
71
56
|
|
|
72
|
-
|
|
57
|
+
## 스킬
|
|
73
58
|
|
|
74
|
-
|
|
75
|
-
lit
|
|
76
|
-
|
|
77
|
-
```
|
|
59
|
+
모든 스킬은 Codex skill picker에서 고르거나 `$litcodex:lit-humanizer`, `$litcodex:lit-fetch`,
|
|
60
|
+
`$litcodex:lit-handoff`, `$litcodex:lit-scientific-visualization`처럼 이름으로 부를 수 있습니다. 스킬마다 그림은
|
|
61
|
+
[스킬 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/skills-Ko-KR.md)에 있습니다.
|
|
78
62
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
| `lit start work <승인된 계획>` | 승인한 계획을 실행합니다. |
|
|
90
|
-
| `review-work` | 변경과 그 근거를 검토합니다. |
|
|
91
|
-
| `litresearch` | 출처를 달아 조사하고, 아직 불확실한 부분을 따로 적어 둡니다. |
|
|
92
|
-
|
|
93
|
-
메시지 전체가 그 한 단어일 때만 동작하는 단어가 두 개 있습니다. `handoff`만 보내면 인수인계 문서를 만들고,
|
|
94
|
-
`lit-scientific-visualization`만 보내면 시각화 어댑터를 불러옵니다. Python 패키지는 설치하지 않습니다.
|
|
95
|
-
|
|
96
|
-
## 패키지에 들어 있는 스킬
|
|
97
|
-
|
|
98
|
-
아래 스킬은 Codex skill picker에서 고를 수 있고, `$litcodex:lit-humanizer`, `$litcodex:lit-fetch`,
|
|
99
|
-
`$litcodex:lit-handoff`, `$litcodex:lit-scientific-visualization`처럼 `$litcodex:` 접두어를 붙인 이름으로 불러도 됩니다. 스킬마다 그림을
|
|
100
|
-
곁들인 설명은 GitHub에 있습니다.
|
|
101
|
-
|
|
102
|
-
**작업을 계획하고 실행하기**
|
|
103
|
-
|
|
104
|
-
- `lit-loop`(`lit`): 세션이 바뀌어도 이어지는 루프 안에서 일하고, 확인하지 못한 것은 그대로 적어 둡니다.
|
|
105
|
-
- `litwork`: 처음부터 끝까지 꼼꼼한 구현이나 수정입니다. 실패하는 테스트 먼저, 그다음 실제 화면에서 증명합니다.
|
|
106
|
-
- `lit-plan`: `.litcodex/plans/`에 번호 붙은 승인 계획을 만듭니다. 계획만 세웁니다.
|
|
107
|
-
- Start Work(`lit start work <승인된 계획>`): 승인된 계획을 다섯 관문으로 실행합니다.
|
|
108
|
-
- `litgoal`: 관찰 가능한 기준을 붙인 목표 하나를 루프에 묶습니다.
|
|
109
|
-
- `deep-interview`: 만들 수 있을 만큼 분명해질 때까지 한 번에 한 질문씩 묻습니다.
|
|
110
|
-
- `lit-crucible`: 계획 전에 요구사항을 반박해 보고, 반박을 견딘 위험만 계획으로 넘깁니다.
|
|
111
|
-
- `lit-team`: 여러 작업자에게 겹치지 않는 몫을 나누고, 각자 증거와 함께 보고하게 합니다.
|
|
112
|
-
- `lit-recap`, `lit-handoff`: 지금 상태를 읽기 전용으로 요약하고, 다음 세션이 이어받을 파일을 만듭니다.
|
|
113
|
-
|
|
114
|
-
**검토, 조사, 지식**
|
|
115
|
-
|
|
116
|
-
- `review-work`: 리뷰 다섯 개가 따로 돌고, 하나라도 통과하지 못하면 승인이 나지 않습니다.
|
|
117
|
-
- `litresearch`: 조사를 요청할 때만 움직이며, 여러 갈래로 증거를 모아 출처와 함께 종합합니다.
|
|
118
|
-
- `autoresearch`: 승인된 예산 안에서 실험을 반복합니다.
|
|
119
|
-
- `autoconference`: 예산을 정해 두고 연구 회의를 엽니다.
|
|
120
|
-
- `lit-fetch`: 보통 방법으로 부족할 때 주소·DNS·본문 안전 검사를 거쳐 공개 페이지를 읽습니다.
|
|
121
|
-
- `wikify`: 검토를 거친 프로젝트 지식을 디스크에 두고, 나중 질문에 출처와 함께 답합니다.
|
|
122
|
-
- `coding-session-audit`: 지난 Codex 세션을 기록으로 읽고 어디서 멈췄는지 보여 줍니다.
|
|
123
|
-
- `lit-comprehend`: 에이전트가 쓴 작업을 이해하도록 돕는 설명 페이지를 만들고, 짧은 퀴즈로 마무리합니다.
|
|
124
|
-
|
|
125
|
-
**문서, 그림, 화면**
|
|
126
|
-
|
|
127
|
-
- `lit-docx`, `lit-pptx`: 여섯 방향 중 하나로 절제된 Word 문서를, 여덟 방향 중 하나로 빽빽한 PowerPoint 파일을 원고 Markdown과 함께 만듭니다. 만들기 전에 고른 방향과 대안 두 가지를 밝힙니다.
|
|
128
|
-
- `lit-diagram-drawer`: 편집 가능한 다이어그램을 그리고 검사한 뒤 PNG와 Office용 SVG로 내보냅니다.
|
|
129
|
-
- `lit-scientific-visualization`: 학술지 규격 그림을 벡터와 600 DPI로 내보냅니다.
|
|
130
|
-
- `lit-typographic-motion`: 트리트먼트부터 쓰고 짧은 영상을 만듭니다.
|
|
131
|
-
- `lit-humanizer`: 딱딱한 AI 문장을 한국어나 영어로 다시 씁니다. 사실과 단서는 남깁니다.
|
|
132
|
-
- `readme-studio`: 사실에 맞는 README와 움직이는 커버를 만듭니다.
|
|
133
|
-
- `frontend-ui-ux`, `visual-qa`, `browser-drive`: 화면을 만들고, 실제 화면을 폭별로 확인하고, 브라우저
|
|
134
|
-
드라이버를 확인한 뒤 실제 페이지를 조작합니다.
|
|
135
|
-
|
|
136
|
-
**코드**
|
|
137
|
-
|
|
138
|
-
- `debugging`: 버그를 재현하고, 가설을 세 개 이상 세워 확인한 뒤, 확인된 원인만 고칩니다.
|
|
139
|
-
- `refactor`: 동작을 테스트로 고정한 채 코드 구조를 바꿉니다.
|
|
140
|
-
- `lit-code`: 테스트 먼저, 경계에서 타입 확인 같은 엄격한 구현 규칙입니다.
|
|
141
|
-
- `lit-commit`: 변경을 저장소 스타일에 맞는 작은 커밋으로 나눕니다.
|
|
142
|
-
- `lit-burnoff`, `lit-burnoff-file`: 변경분 전체나 파일 하나에서 AI식 군더더기를 걷어냅니다.
|
|
143
|
-
- `structural-search`: 문법 구조로 코드를 찾고, 바꾸기 전에 결과를 미리 보여 줍니다.
|
|
144
|
-
- `lsp-setup`, `lit-init`: 언어 서버 설정을 확인하고, 필요한 곳에만 짧은 AGENTS.md 안내를 만듭니다.
|
|
145
|
-
|
|
146
|
-
**LitCodex 관리**
|
|
147
|
-
|
|
148
|
-
- `litcodex-doctor`, `litcodex-report-bug`, `litcodex-contribute-bug-fix`: 설치 상태 점검, 출처를 단 버그 보고서,
|
|
149
|
-
테스트가 붙은 수정 PR입니다.
|
|
150
|
-
- `rules`, `lsp`, `comment-checker`는 알아서 돌아갑니다. 프롬프트마다 프로젝트 규칙을 넣고, 수정 뒤에는 LSP와
|
|
151
|
-
주석을 확인합니다.
|
|
63
|
+
- **루프와 계획:** `lit-loop`(`lit`), `litwork`, `lit-plan`, Start Work(`lit start work <승인된 계획>`), `litgoal`,
|
|
64
|
+
`deep-interview`, `lit-crucible`, `lit-team`, `lit-recap`, `lit-handoff`.
|
|
65
|
+
- **검토와 조사:** `review-work`, `litresearch`, `autoresearch`, `autoconference`, `lit-fetch`, `wikify`,
|
|
66
|
+
`coding-session-audit`, `lit-comprehend`.
|
|
67
|
+
- **문서, 그림, 화면:** `lit-docx`, `lit-pptx`, `lit-diagram-drawer`, `lit-scientific-visualization`,
|
|
68
|
+
`lit-typographic-motion`, `lit-humanizer`, `readme-studio`, `frontend-ui-ux`, `visual-qa`, `browser-drive`.
|
|
69
|
+
- **코드:** `debugging`, `refactor`, `lit-code`, `lit-commit`, `lit-burnoff`, `lit-burnoff-file`,
|
|
70
|
+
`structural-search`, `lsp-setup`, `lit-init`.
|
|
71
|
+
- **관리:** `litcodex-doctor`, `litcodex-report-bug`, `litcodex-contribute-bug-fix`. `rules`, `lsp`,
|
|
72
|
+
`comment-checker`는 알아서 돌아갑니다.
|
|
152
73
|
|
|
153
74
|
## 설치하면 달라지는 것
|
|
154
75
|
|
|
155
|
-
Codex가 플러그인을 불러오고 훅을 실행합니다. 훅은 요청이 어떤 모드에 속하는지 가리고, 스킬은 에이전트의 작업
|
|
156
|
-
절차를 안내하며, 루프 CLI는 프로젝트 기록을 관리합니다. Codex 목표 도구는 LitCodex가 직접 부르지 않고, 도구가
|
|
157
|
-
있을 때 에이전트가 씁니다. 멈췄거나(paused) 막힌(blocked) 목표는 아래 복구 절차를 따르세요.
|
|
158
|
-
|
|
159
76
|
- Codex에 플러그인·훅·에이전트가 등록되고 `~/.codex/config.toml`의 관리 항목이 갱신됩니다. 관련 없는 Codex
|
|
160
|
-
설정은 그대로 둡니다.
|
|
161
|
-
- 고른 모델은 설정 파일에 적히는 값입니다. 그 모델을 실제로 쓸 수 있는지, 실제로 도는지는 Codex와 사용자 계정에 달려 있습니다.
|
|
77
|
+
설정은 그대로 둡니다.
|
|
162
78
|
- 프로젝트마다 `.litcodex/lit-loop/` 아래에 로컬 기록이 생기며, Git과 패키지에서는 제외됩니다.
|
|
163
|
-
- doctor 진단은 Codex 설정, 설치 상태, 플러그인 상태를 바꾸지 않고 살펴보기만 합니다.
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
79
|
+
- doctor 진단은 Codex 설정, 설치 상태, 플러그인 상태를 바꾸지 않고 살펴보기만 합니다. 조건에 맞는 대화형 doctor
|
|
80
|
+
실행 뒤에는 캐시해 둔 새 버전 안내가 뜰 수 있고, 백그라운드 작업이 정해진 레지스트리만 조회해
|
|
81
|
+
`~/.litcodex/update-check.json`에 적어 둡니다. 이 작업은 아무것도 설치하지 않습니다. 이와 별개로, 조건에 맞는
|
|
82
|
+
대화형 관리 명령 뒤에는 업데이트 실행기가 새 전역 패키지를 설치할 수 있습니다. `LITCODEX_NO_UPDATE_CHECK=1`을
|
|
83
|
+
설정하면 둘 다 꺼집니다. 실패했거나 `--json`·`--dry-run`으로 돌렸거나, 비TTY·CI 환경이거나 이 설정으로 끈
|
|
84
|
+
doctor 실행은 부수 효과가 없습니다.
|
|
85
|
+
- 선택 기능 두 가지는 기본값이 꺼짐입니다.
|
|
86
|
+
[자동 핸드오프](https://github.com/wjgoarxiv/litcodex/blob/main/docs/auto-handoff-Ko-KR.md)와, 켜면 프롬프트가
|
|
87
|
+
외부 서비스로 가는 [Jev 스킬 힌트](https://github.com/wjgoarxiv/litcodex/blob/main/docs/jev-skill-hint-Ko-KR.md)입니다.
|
|
169
88
|
- 테스트, 픽스처, 테스트 헬퍼, Vitest 설정은 저장소에만 있습니다. npm 패키지와 설치된 마켓플레이스 플러그인에는
|
|
170
89
|
들어가지 않습니다.
|
|
171
90
|
|
|
172
|
-
선택 기능인 Jev 스킬 힌트는 평범한 요청에 맞는 번들 스킬을 제안해 주며, 기본값은 꺼짐입니다.
|
|
173
|
-
켜면(`LITCODEX_JEV=1`과 본인의 `TYPESAFE_API_KEY`) 조건에 맞는 프롬프트가 매번 TypeSafe(typesafe.ai)로 갑니다.
|
|
174
|
-
2,000자로 자르고 홈 경로, 이메일 주소, 토큰 형태의 문자열을 가린 뒤 나머지는 그대로 보냅니다. 파일, 도구 출력,
|
|
175
|
-
대화 기록은 보내지 않습니다. 켜기 전에
|
|
176
|
-
[전체 설명](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#jev-스킬-힌트-선택)(각 상태가 화면에서 어떻게 보이는지도 나옵니다)과
|
|
177
|
-
[개인정보 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)를 읽어 주세요.
|
|
178
|
-
|
|
179
|
-
선택 기능인 자동 핸드오프는 대화가 정해 둔 퍼센트에 이르면 핸드오프를 대신 써 주며, 기본값은 꺼짐입니다.
|
|
180
|
-
`lit-handoff auto on 60`(1에서 99 사이의 정수)을 프롬프트 전체로 보내면 켜지고, `lit-handoff auto off`로 끕니다.
|
|
181
|
-
Codex에서는 모델이 핸드오프를 저장하고 그 턴이 끝나면 Codex가 압축합니다(Codex CLI 0.158 이상, 신뢰한 프로젝트).
|
|
182
|
-
Codex가 압축하도록 설정되어 있지 않으면 `/compact`를 실행하라는 한 줄이 나오고, 이후 핸드오프는 저절로 다시
|
|
183
|
-
불러옵니다. 각 단계는 [전체 설명](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#자동-핸드오프-선택)을 읽어 주세요.
|
|
184
|
-
|
|
185
91
|
## 확인, 문제 해결, 제거
|
|
186
92
|
|
|
187
93
|
```sh
|
|
188
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
94
|
+
npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex doctor
|
|
189
95
|
```
|
|
190
96
|
|
|
191
97
|
`litcodex doctor`는 등록·훅·설정·호스트 기능을, `litcodex loop doctor`는 현재 프로젝트의 루프 상태를 확인합니다.
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
- **`lit`을 입력해도 반응이 없다면.** `litcodex doctor`를 실행하고 Codex에서 훅을 승인했는지 확인하세요.
|
|
195
|
-
- **명령을 찾지 못한다면.** 위의 `npm exec` 형식을 쓰거나, npm 전역 bin 경로를 `PATH`에 넣으세요.
|
|
196
|
-
- **Codex 목표가 멈췄거나(paused) 막혔다면(blocked).** `/goal resume`으로 재개하고 활성 상태인지 확인한 뒤
|
|
197
|
-
`litcodex loop run --retry-failed`로 다시 시도하세요. 미완료 목표는 지우지 말고 남겨 두세요.
|
|
198
|
-
- **아무 출력 없이 창(pane)이 닫힌다면.** 어느 단계가 문제인지부터 찾습니다. 열린 터미널에서 도움말, 설치,
|
|
199
|
-
doctor를 하나씩 실행해 각 종료 코드를 적어 두고
|
|
200
|
-
[문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)을 참고하세요.
|
|
98
|
+
`lit`을 입력해도 반응이 없다면 doctor를 실행하고 Codex에서 훅을 승인했는지 확인하세요. 다른 해결 방법은
|
|
99
|
+
[문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)에 있습니다.
|
|
201
100
|
|
|
202
101
|
```sh
|
|
203
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
102
|
+
npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex uninstall
|
|
204
103
|
```
|
|
205
104
|
|
|
206
105
|
플러그인과 LitCodex가 관리하는 설정을 지우고, 관련 없는 설정은 그대로 둡니다.
|
package/README.md
CHANGED
|
@@ -1,64 +1,46 @@
|
|
|
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.20/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.20/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.20/readme-assets/badge-version.svg" alt="1.0.20" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.20/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.20/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.20/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.20/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
13
13
|
|
|
14
14
|
**Keep the work lit.**
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
the results stay in your project, where a later session can pick them up.
|
|
16
|
+
A plugin for Codex CLI that turns a request into a goal with checks, keeps the evidence in your project,
|
|
17
|
+
and hands unfinished work to the next session.
|
|
19
18
|
|
|
20
|
-
**[Full guide
|
|
19
|
+
**[Full guide on GitHub](https://github.com/wjgoarxiv/litcodex#readme)** · [한국어](https://github.com/wjgoarxiv/litcodex/blob/main/packages/litcodex-ai/README-Ko-KR.md)
|
|
21
20
|
|
|
22
21
|
## Install
|
|
23
22
|
|
|
24
23
|
You need Node.js 22 or later and Codex CLI.
|
|
25
24
|
|
|
26
25
|
```sh
|
|
27
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
26
|
+
npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex install
|
|
28
27
|
```
|
|
29
28
|
|
|
30
|
-
The installer
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
`npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex --dry-run install`. To install without
|
|
35
|
-
any questions, add `--yes` after `install`.
|
|
36
|
-
|
|
37
|
-
For a global command:
|
|
29
|
+
The installer asks which model leads, which model helps and which output style you like, shows what it is
|
|
30
|
+
about to write, and changes only the keys it manages in `~/.codex/config.toml`. To see the plan first, run
|
|
31
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex --dry-run install`. To skip the
|
|
32
|
+
questions, add `--yes` after `install`.
|
|
38
33
|
|
|
39
34
|
```sh
|
|
40
35
|
npm install -g @litfamily/litcodex
|
|
41
36
|
litcodex install
|
|
42
37
|
```
|
|
43
38
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
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.
|
|
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.
|
|
39
|
+
A global install also gets the video skill's tools ready with a few pinned downloads. The
|
|
40
|
+
[install guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install.md#a-global-command) lists them
|
|
41
|
+
and shows how to skip them.
|
|
54
42
|
|
|
55
|
-
> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.
|
|
56
|
-
|
|
57
|
-
To try LitCodex apart from your existing settings, follow the
|
|
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`.
|
|
43
|
+
> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex <command>`.
|
|
62
44
|
|
|
63
45
|
## First task
|
|
64
46
|
|
|
@@ -68,101 +50,34 @@ Open Codex in your project, approve the LitCodex hooks in the startup review, an
|
|
|
68
50
|
lit add input validation to the signup form
|
|
69
51
|
```
|
|
70
52
|
|
|
71
|
-
The reply opens with `🔥 **LIT IGNITED · <discipline>**
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
```text
|
|
78
|
-
lit build a single-file HTML task list in this folder. Do not install dependencies.
|
|
79
|
-
Check adding and completing a task, and record anything you could not verify.
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
Then look at the result, the checks that actually ran, and what is still open. `lit recap` reads back what
|
|
83
|
-
was recorded, and sending `handoff` on its own before you leave gives the next session a place to start.
|
|
84
|
-
|
|
85
|
-
## Routes people use most
|
|
53
|
+
The reply opens with `🔥 **LIT IGNITED · <discipline>** 🔥`. A goal is complete once every check has
|
|
54
|
+
passing evidence, and the records live under `.litcodex/lit-loop/` in your project; `lit recap` reads them
|
|
55
|
+
back. Send exact bare `handoff` before you leave, and the next session gets a continuation packet to start
|
|
56
|
+
from. The exact bare `lit-scientific-visualization` hook route loads the plotting adapter;
|
|
57
|
+
it does not install Python dependencies.
|
|
86
58
|
|
|
87
|
-
|
|
88
|
-
| --- | --- |
|
|
89
|
-
| `lit` | Starts a bounded task, with goals and checks kept in the project. |
|
|
90
|
-
| `handoff` or `/lit-handoff` | Carries the checked result and the next step into another session. |
|
|
91
|
-
| `lit-plan` | Writes a plan and success criteria before anything is edited. |
|
|
92
|
-
| `lit start work <approved-plan>` | Runs a plan you have approved. |
|
|
93
|
-
| `review-work` | Reviews the change and its evidence. |
|
|
94
|
-
| `litresearch` | Researches with sources and keeps track of what is still uncertain. |
|
|
59
|
+
## Skills
|
|
95
60
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
61
|
+
Pick any skill in the Codex skill picker or mention it by scoped name, such as `$litcodex:lit-humanizer`,
|
|
62
|
+
`$litcodex:lit-fetch`, `$litcodex:lit-handoff` or `$litcodex:lit-scientific-visualization`. The
|
|
63
|
+
[skills page](https://github.com/wjgoarxiv/litcodex/blob/main/docs/skills.md) has a picture of each one.
|
|
99
64
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
- `
|
|
109
|
-
- `
|
|
110
|
-
|
|
111
|
-
- Start Work (`lit start work <approved-plan>`): runs an approved plan through five gates.
|
|
112
|
-
- `litgoal`: binds one goal with observable criteria to the loop.
|
|
113
|
-
- `deep-interview`: one question at a time until the idea is clear enough to build.
|
|
114
|
-
- `lit-crucible`: pressure-tests a brief before planning, so only surviving risks reach the plan.
|
|
115
|
-
- `lit-team`: gives several workers separate slices, each reporting back with evidence.
|
|
116
|
-
- `lit-recap` and `lit-handoff`: a read-only summary of where things stand, and a file the next session resumes from.
|
|
117
|
-
|
|
118
|
-
**Review, research and knowledge**
|
|
119
|
-
|
|
120
|
-
- `review-work`: five separate reviews, and any one of them can hold back approval.
|
|
121
|
-
- `litresearch`: parallel evidence gathering and a cited synthesis, only when you ask for research.
|
|
122
|
-
- `autoresearch` and `autoconference`: an approved, budgeted experiment loop, and a budgeted research conference.
|
|
123
|
-
- `lit-fetch`: reads a public page with URL, DNS and text-safety checks when ordinary retrieval falls short.
|
|
124
|
-
- `wikify`: keeps reviewed project knowledge on disk and answers later questions from it, with sources.
|
|
125
|
-
- `coding-session-audit`: reads a past Codex session from its evidence and shows where it stopped.
|
|
126
|
-
- `lit-comprehend`: an explainer page for agent-written work, ending in a short quiz.
|
|
127
|
-
|
|
128
|
-
**Documents, figures and interfaces**
|
|
129
|
-
|
|
130
|
-
- `lit-docx` and `lit-pptx`: a restrained Word document in one of six directions or a dense PowerPoint deck in one of eight, each with its Markdown source. The skill names the direction it chose and two alternatives before it builds.
|
|
131
|
-
- `lit-diagram-drawer`: an editable diagram, checked and exported to PNG and Office-safe SVG.
|
|
132
|
-
- `lit-scientific-visualization`: a journal-sized figure with vector and 600 DPI exports.
|
|
133
|
-
- `lit-typographic-motion`: a short film, starting from a written treatment.
|
|
134
|
-
- `lit-humanizer`: rewrites stiff model prose in English or Korean, keeping facts and hedges.
|
|
135
|
-
- `readme-studio`: a factual README with a moving cover.
|
|
136
|
-
- `frontend-ui-ux`, `visual-qa` and `browser-drive`: builds an interface, checks a real screen at each
|
|
137
|
-
viewport, and drives a real page once the browser driver is verified.
|
|
138
|
-
|
|
139
|
-
**Code**
|
|
140
|
-
|
|
141
|
-
- `debugging`: reproduces the bug, tests at least three explanations, fixes only the confirmed cause.
|
|
142
|
-
- `refactor`: restructures code while tests pin its behavior.
|
|
143
|
-
- `lit-code`: strict implementation rules, with tests first and typed boundaries.
|
|
144
|
-
- `lit-commit`: atomic commits in the repository's own style.
|
|
145
|
-
- `lit-burnoff` and `lit-burnoff-file`: clean AI-written bloat from a change set or from one file.
|
|
146
|
-
- `structural-search`: finds code by syntax shape and previews rewrites.
|
|
147
|
-
- `lsp-setup` and `lit-init`: language-server setup checks, and sparse AGENTS.md guidance.
|
|
148
|
-
|
|
149
|
-
**Keeping LitCodex healthy**
|
|
150
|
-
|
|
151
|
-
- `litcodex-doctor`, `litcodex-report-bug` and `litcodex-contribute-bug-fix`: install health checks, a
|
|
152
|
-
source-backed bug report, and a tested bug-fix PR.
|
|
153
|
-
- `rules`, `lsp` and `comment-checker` run on their own: project rules on each prompt, LSP and comment
|
|
154
|
-
checks after edits.
|
|
65
|
+
- **Loop and planning:** `lit-loop` (`lit`), `litwork`, `lit-plan`, Start Work (`lit start work <approved-plan>`),
|
|
66
|
+
`litgoal`, `deep-interview`, `lit-crucible`, `lit-team`, `lit-recap` and `lit-handoff`.
|
|
67
|
+
- **Review and research:** `review-work`, `litresearch`, `autoresearch`, `autoconference`, `lit-fetch`,
|
|
68
|
+
`wikify`, `coding-session-audit` and `lit-comprehend`.
|
|
69
|
+
- **Documents, figures and screens:** `lit-docx`, `lit-pptx`, `lit-diagram-drawer`,
|
|
70
|
+
`lit-scientific-visualization`, `lit-typographic-motion`, `lit-humanizer`, `readme-studio`,
|
|
71
|
+
`frontend-ui-ux`, `visual-qa` and `browser-drive`.
|
|
72
|
+
- **Code:** `debugging`, `refactor`, `lit-code`, `lit-commit`, `lit-burnoff`, `lit-burnoff-file`,
|
|
73
|
+
`structural-search`, `lsp-setup` and `lit-init`.
|
|
74
|
+
- **Upkeep:** `litcodex-doctor`, `litcodex-report-bug` and `litcodex-contribute-bug-fix`. `rules`, `lsp`
|
|
75
|
+
and `comment-checker` run on their own.
|
|
155
76
|
|
|
156
77
|
## What it changes
|
|
157
78
|
|
|
158
|
-
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. LitCodex never calls Codex's goal tools
|
|
160
|
-
itself; the agent uses them when they are there. A paused or blocked goal needs the recovery step below.
|
|
161
|
-
|
|
162
79
|
- Codex gets the plugin, hooks and agents, plus the managed keys in `~/.codex/config.toml`. Your unrelated
|
|
163
|
-
Codex settings stay as they are.
|
|
164
|
-
- The model you pick is a setting in your config. Whether it is open to you, and whether it actually
|
|
165
|
-
runs, is up to Codex and your account.
|
|
80
|
+
Codex settings stay as they are.
|
|
166
81
|
- Each project gets local records under `.litcodex/lit-loop/`, kept out of Git and packages.
|
|
167
82
|
- The doctor diagnostic core never modifies Codex config, install state or plugin state. An eligible
|
|
168
83
|
interactive doctor run (a successful one you start by hand) may show a cached advisory notice about a
|
|
@@ -171,44 +86,25 @@ itself; the agent uses them when they are there. A paused or blocked goal needs
|
|
|
171
86
|
global package after an eligible interactive management command. Set `LITCODEX_NO_UPDATE_CHECK=1` to
|
|
172
87
|
turn off both. A doctor run that failed, or ran with `--json`, `--dry-run`, in a non-TTY or CI shell, or
|
|
173
88
|
with the opt-out set, stays side-effect-free.
|
|
89
|
+
- Two optional features are off by default:
|
|
90
|
+
[automatic handoff](https://github.com/wjgoarxiv/litcodex/blob/main/docs/auto-handoff.md) and the
|
|
91
|
+
[Jev skill hint](https://github.com/wjgoarxiv/litcodex/blob/main/docs/jev-skill-hint.md), which sends
|
|
92
|
+
prompts to a third party once you turn it on.
|
|
174
93
|
- Tests, fixtures, test helpers and the Vitest configuration live only in the repository. Neither the npm
|
|
175
94
|
package nor the installed marketplace plugin includes them.
|
|
176
95
|
|
|
177
|
-
The optional Jev skill hint suggests a bundled skill for a plain prompt, and it is off by default.
|
|
178
|
-
Turning it on (`LITCODEX_JEV=1` plus your own `TYPESAFE_API_KEY`) sends each eligible prompt to TypeSafe
|
|
179
|
-
(typesafe.ai). The prompt is cut to 2,000 characters and home paths, email addresses and token-shaped
|
|
180
|
-
strings are redacted; the rest of it is sent as written. Nothing else from the session goes with it:
|
|
181
|
-
no files, tool output or history.
|
|
182
|
-
Read [the full description](https://github.com/wjgoarxiv/litcodex#jev-skill-hint-optional), which shows what
|
|
183
|
-
appears on screen in each state, and the
|
|
184
|
-
[privacy notes](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)
|
|
185
|
-
before you turn it on.
|
|
186
|
-
|
|
187
|
-
The optional automatic handoff writes a handoff for you when a conversation reaches a percent you choose,
|
|
188
|
-
and is off by default. Turn it on by sending `lit-handoff auto on 60` (any whole number from 1 to 99) as your
|
|
189
|
-
whole prompt, and off with `lit-handoff auto off`. On Codex the model saves the handoff and Codex compacts
|
|
190
|
-
after that turn (Codex CLI 0.158 or newer, trusted project); when Codex is not set to compact, you get one
|
|
191
|
-
line asking you to run `/compact`. The handoff then comes back on its own. Read
|
|
192
|
-
[the full description](https://github.com/wjgoarxiv/litcodex#automatic-handoff-optional) for each step.
|
|
193
|
-
|
|
194
96
|
## Check, fix, remove
|
|
195
97
|
|
|
196
98
|
```sh
|
|
197
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
99
|
+
npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex doctor
|
|
198
100
|
```
|
|
199
101
|
|
|
200
|
-
`litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks
|
|
201
|
-
current project's loop state.
|
|
202
|
-
|
|
203
|
-
- **`lit` does nothing.** Run `litcodex doctor` and check that the hooks are approved in Codex.
|
|
204
|
-
- **The command is missing.** Use the `npm exec` form above, or put npm's global bin directory on your `PATH`.
|
|
205
|
-
- **A native goal is paused or blocked.** Run `/goal resume`, confirm the goal is active, then retry with
|
|
206
|
-
`litcodex loop run --retry-failed`. Keep the unfinished goal.
|
|
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).
|
|
102
|
+
`litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks
|
|
103
|
+
the current project's loop state. If `lit` does nothing, run doctor and check that the hooks are approved
|
|
104
|
+
in Codex. More fixes are under [troubleshooting](https://github.com/wjgoarxiv/litcodex#troubleshooting).
|
|
209
105
|
|
|
210
106
|
```sh
|
|
211
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
107
|
+
npm exec --yes --package @litfamily/litcodex@1.0.20 -- litcodex uninstall
|
|
212
108
|
```
|
|
213
109
|
|
|
214
110
|
This removes the plugin and the config LitCodex manages, and leaves your other settings alone.
|
package/dist/auto-update.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type CheckGate } from "./update-check.js";
|
|
2
|
-
|
|
2
|
+
/** Longer than the helper's worst case (three probes and four install steps), so it is never cut mid-rollback. */
|
|
3
|
+
export declare const FOREGROUND_AUTO_UPDATE_TIMEOUT_MS = 300000;
|
|
3
4
|
export interface ForegroundAutoUpdateOptions extends CheckGate {
|
|
4
5
|
readonly current: string;
|
|
5
6
|
readonly stderr: NodeJS.WritableStream;
|
package/dist/auto-update.js
CHANGED
|
@@ -3,7 +3,8 @@ import { existsSync } from "node:fs";
|
|
|
3
3
|
import { dirname, join } from "node:path";
|
|
4
4
|
import { fileURLToPath } from "node:url";
|
|
5
5
|
import { shouldCheck } from "./update-check.js";
|
|
6
|
-
|
|
6
|
+
/** Longer than the helper's worst case (three probes and four install steps), so it is never cut mid-rollback. */
|
|
7
|
+
export const FOREGROUND_AUTO_UPDATE_TIMEOUT_MS = 300_000;
|
|
7
8
|
/**
|
|
8
9
|
* Run the installed component's updater synchronously after a successful eligible command.
|
|
9
10
|
*
|
package/dist/cli.d.ts
CHANGED
|
@@ -20,4 +20,4 @@ export declare function dispatch(argv: readonly string[]): DispatchResult;
|
|
|
20
20
|
* (M13, in-process), and the bundled `@litcodex/lit-loop` runtime routes `loop`/`hook`. Returns the
|
|
21
21
|
* integer exit code; the bin owns `process.exit`. No forwarding, no exec-wrapper, no harness.
|
|
22
22
|
*/
|
|
23
|
-
export declare function runCli(
|
|
23
|
+
export declare function runCli(rawArgv: readonly string[]): Promise<number>;
|