cxs is a local-first CLI for searching Codex session logs. It is designed for progressive retrieval: find the right session first, then read
docs(skill): 精简 cxs skill 安装说明
+5
-45
+4
-38
.agents/skills/cxs/SKILL.md
+4
-38
.agents/skills/cxs/SKILL.md
···
9
9
10
10
## 安装
11
11
12
-
推荐用 `npx skills add` 安装这个 skill：
13
-
14
-
```bash
15
-
npx skills add catoncat/cxs --skill cxs -g -a codex -y
16
-
```
17
-
18
-
也可以先预览仓库里的 skill：
19
-
20
-
```bash
21
-
npx skills add catoncat/cxs --list
22
-
```
23
-
24
-
## CLI 前置安装
25
-
26
-
这个 skill 依赖 `cxs` CLI。本生态里的常见做法是：
27
-
28
-
- `npx skills add ...` 负责安装 skill 本身
29
-
- 外部 CLI / SDK / 凭证 / 本地工具 由 skill 自己说明前置安装流程
30
-
31
-
也就是说，这个 skill 应该包含 `cxs` CLI 的安装说明，但不会由 `skills` CLI 代替你安装 `cxs`。
32
-
33
-
当前最稳的安装方式：
34
-
35
-
1. clone 仓库
36
-
2. 安装依赖
37
-
3. 让 `cxs` 可执行
38
-
4. 再安装 skill
39
-
40
-
示例：
12
+
先准备 `cxs` CLI，再装 skill：
41
13
42
14
```bash
43
15
git clone https://github.com/catoncat/cxs.git
44
16
cd cxs
45
17
bun install
46
-
47
-
# 方式 A：直接配置环境变量
48
18
export CXS_BIN="$PWD/bin/cxs"
49
-
50
-
# 方式 B：放进 PATH（按你的 shell 自己处理）
51
-
chmod +x "$PWD/bin/cxs"
19
+
npx skills add catoncat/cxs --skill cxs -g -a codex -y
52
20
```
53
21
54
-
然后再装 skill：
22
+
只想看仓库里的 skill 时：
55
23
56
24
```bash
57
-
npx skills add catoncat/cxs --skill cxs -g -a codex -y
25
+
npx skills add catoncat/cxs --list
58
26
```
59
-
60
-
如果后续这个仓库再提供独立 npm/bun 发布形态，可以把上面这段替换成更短的 CLI 安装命令；在那之前，这就是公开仓库里最清晰、最不误导的做法。
61
27
62
28
## 路径前提
63
29
+1
-7
README.md
+1
-7
README.md
···
200
200
npx skills add catoncat/cxs --list
201
201
```
202
202
203
-
推荐顺序：
204
-
205
-
1. 先安装 / 配置 `cxs` CLI
206
-
2. 再用 `npx skills add` 安装 skill
207
-
208
-
最稳的本地方式：
203
+
先准备 `cxs` CLI，再安装 skill：
209
204
210
205
```bash
211
206
git clone https://github.com/catoncat/cxs.git
···
217
212
218
213
注意：
219
214
220
-
- `npx skills add` 只安装 skill，不负责安装外部 CLI
221
215
- 最稳的做法是先让 `cxs` 命令可执行，或设置 `CXS_BIN=/absolute/path/to/bin/cxs`