@samooth/open-codex 0.1.49 → 0.2.1
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.md +34 -1
- package/dist/cli.js +484 -367
- package/dist/cli.js.map +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -189,7 +189,7 @@ The hardening mechanism Codex uses depends on your OS:
|
|
|
189
189
|
| `open-codex -q "…"` | Non‑interactive "quiet mode" | `codex -q --json "explain utils.ts"` |
|
|
190
190
|
| `open-codex completion <bash\|zsh\|fish>` | Print shell completion script | `codex completion bash` |
|
|
191
191
|
|
|
192
|
-
Inside the chat, use slash commands like `/help`, `/model`, `/approval`, `/config`, `/history`, and `/clear`.
|
|
192
|
+
Inside the chat, use slash commands like `/help`, `/model`, `/approval`, `/config`, `/history`, `/history restore`, `/prompt`, `/prompts` and `/clear`.
|
|
193
193
|
|
|
194
194
|
Key flags:
|
|
195
195
|
- `--provider / -p`: AI provider to use.
|
|
@@ -200,6 +200,18 @@ Key flags:
|
|
|
200
200
|
|
|
201
201
|
---
|
|
202
202
|
|
|
203
|
+
## Session Persistence
|
|
204
|
+
|
|
205
|
+
OpenCodex automatically saves every conversation rollout to `~/.codex/sessions/`. This allows you to resume work or review past decisions.
|
|
206
|
+
|
|
207
|
+
To restore a past session within the interactive CLI, type:
|
|
208
|
+
```shell
|
|
209
|
+
/history restore
|
|
210
|
+
```
|
|
211
|
+
This opens an interactive menu where you can select a previous rollout by date and summary. Restoring a session will load all previous messages and the system instructions used at that time.
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
203
215
|
## Memory & Project Docs
|
|
204
216
|
|
|
205
217
|
Codex merges Markdown instructions in this order:
|
|
@@ -211,6 +223,25 @@ Codex merges Markdown instructions in this order:
|
|
|
211
223
|
|
|
212
224
|
Disable with `--no-project-doc` or `CODEX_DISABLE_PROJECT_DOC=1`.
|
|
213
225
|
|
|
226
|
+
### Prompt Selection
|
|
227
|
+
|
|
228
|
+
You can also maintain a collection of system prompt files and switch between them in-session using the `/prompts` command. Codex will look for `.md` or `.txt` files in:
|
|
229
|
+
|
|
230
|
+
- `./prompts/` (local project prompts)
|
|
231
|
+
- `./.codex/prompts/` (hidden local prompts)
|
|
232
|
+
- `~/.codex/prompts/` (global user prompts)
|
|
233
|
+
|
|
234
|
+
### Ignoring Files (`.codexignore`)
|
|
235
|
+
|
|
236
|
+
You can prevent OpenCodex from seeing or modifying specific files or directories by creating a `.codexignore` file. This file uses standard glob patterns (similar to `.gitignore`). OpenCodex will respect patterns from:
|
|
237
|
+
|
|
238
|
+
1. `.codexignore` in the current directory.
|
|
239
|
+
2. `.gitignore` in the current directory.
|
|
240
|
+
3. `.codexignore` in the Git root directory.
|
|
241
|
+
4. `~/.codex/.codexignore` (global ignore rules).
|
|
242
|
+
|
|
243
|
+
By default, OpenCodex always ignores common directories like `node_modules`, `.git`, `dist`, `build`, and various cache folders to preserve context and improve performance.
|
|
244
|
+
|
|
214
245
|
---
|
|
215
246
|
|
|
216
247
|
## Non‑interactive / CI mode
|
|
@@ -303,6 +334,8 @@ Codex looks for config files in **`~/.codex/`** (either YAML or JSON format). Th
|
|
|
303
334
|
"provider": "openai", // Default provider
|
|
304
335
|
"approvalMode": "suggest", // or auto-edit, full-auto
|
|
305
336
|
"fullAutoErrorMode": "ask-user", // or ignore-and-continue
|
|
337
|
+
"enableWebSearch": true, // Toggle web search tools (requires Lynx)
|
|
338
|
+
"enableDeepThinking": false, // Toggle default "Deep Thinking" prefix
|
|
306
339
|
"memory": {
|
|
307
340
|
"enabled": true
|
|
308
341
|
}
|