Skip to content

Commit 3c1e77e

Browse files
committed
docs: add internal reasoning cap to features
1 parent 9ea73dc commit 3c1e77e

1 file changed

Lines changed: 14 additions & 24 deletions

File tree

README.md

Lines changed: 14 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -24,13 +24,13 @@ You might need to:
2424
- Read through the agent's hidden internal reasoning.
2525
- Strip away thousands of lines of verbose tool outputs to see the actual conversation.
2626

27-
Currently, there's no official feature built for this granular level of control. If you just export raw logs, you get a massive, unreadable wall of text.
27+
Currently, theres no official feature built for this granular level of control. If you just export raw logs, you get a massive, unreadable wall of text.
2828

2929
## 💡 The Solution
3030

3131
**Codex Session Manager** (`codex-md.py`) is designed for maximum flexibility. It parses your local `.jsonl` session logs and provides a beautiful, interactive, fullscreen terminal UI (TUI) to dynamically filter exactly what you want to export into clean Markdown.
3232

33-
Because it's a pure Python CLI tool, it's completely **portable**. You can use it locally on your laptop, or run it headlessly on a remote VPS. It is 100% compatible with the Codex CLI extension and app.
33+
Because its a pure Python CLI tool, it's completely **portable**. You can use it locally on your laptop, or run it headlessly on a remote VPS. It is 100% compatible with the Codex CLI extension and app.
3434

3535
---
3636

@@ -39,7 +39,7 @@ Because it's a pure Python CLI tool, it's completely **portable**. You can use i
3939
- **20 Filterable Sections:** Toggle everything from User/Agent messages to hidden agent reasoning, terminal commands, MCP tool calls, git snapshots, and more.
4040
- **Parallel Exports:** Select and process multiple sessions at the same time. The filter will show you the combined line counts and will export them simultaneously in one batch.
4141
- **Dynamic Output Capping:** Terminal payloads can be hundreds of thousands of lines long. Instantly cap output blocks to exactly 1, 5, 8, 10, or up to 500 lines to keep your context windows lean.
42-
- **Granular Message Filtering *(New in v2.1)*:** Independently control how many of the **last N** blocks you want from each message type — 👤 User, 🤖 Agent, and 🧠 Reasoning — all separately adjustable via ``/``. Each defaults to ALL, so you only cut what you need.
42+
- **Granular Message Filtering *(New in v2.1)*:** Independently control how many of the last N blocks you want from each message type — 👤 User, 🤖 Agent, 🧠 Agent Reasoning, and 🔒 Internal Reasoning — all separately adjustable with ``/``. Each defaults to showing all, so you only cut what you need.
4343
- **"Clean Chat" Mode:** Instantly strips messy IDE background data, active-file streams, and open-tab XML that the agent silently attaches to your prompt, leaving just your actual words.
4444
- **7 Built-in Presets:** Jump straight to "Chat Only", "Terminal Only", "Outputs Only", or "Full Export" with a single keystroke.
4545
- **Real-Time Context Math:** See exactly how many lines you are selecting *before* you export, complete with a live progress bar.
@@ -51,24 +51,13 @@ Because it's a pure Python CLI tool, it's completely **portable**. You can use i
5151
No complex dependencies. Just download and run the script using Python.
5252

5353
### 🚀 Quick Start (One-Liner)
54+
Run the software instantly without manually cloning the repo:
5455

55-
Run the software instantly — no cloning needed.
56-
57-
**🐧 Linux / 🍎 macOS:**
56+
**Linux / macOS:**
5857
```bash
5958
curl -sO https://raw.githubusercontent.com/MeXenon/codex-session-export/main/codex-md.py && python3 codex-md.py
6059
```
6160

62-
**🪟 Windows — Command Prompt (cmd.exe):**
63-
```cmd
64-
curl -sO https://raw.githubusercontent.com/MeXenon/codex-session-export/main/codex-md.py && python codex-md.py
65-
```
66-
67-
**🪟 Windows — PowerShell 7:**
68-
```powershell
69-
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MeXenon/codex-session-export/main/codex-md.py" -OutFile "codex-md.py"; python codex-md.py
70-
```
71-
7261
### 💻 Manual Run
7362
If you prefer to download or clone the file manually:
7463

@@ -86,13 +75,14 @@ python codex-md.py
8675

8776
1. **Select a session:** The script automatically scans `~/.codex/sessions` and presents a chronological list of your recent threads. Type the ID of the session (e.g., `1`) or select multiple (e.g., `1,2,3`).
8877
2. **Filter & Refine:**
89-
* `` / `` — Navigate the filter list
90-
* `Enter` / `Space` — Toggle a section ON/OFF
91-
* `` / `` on **💻 Terminal Output Cap** — Adjust max lines per terminal/tool output block
92-
* `` / `` on **👤 User Message Cap** — Keep only the last N user messages
93-
* `` / `` on **🤖 Agent Message Cap** — Keep only the last N agent responses
94-
* `` / `` on **🧠 Agent Reasoning Cap** — Keep only the last N reasoning blocks
95-
* `1``7` — Load presets
78+
* `` / `` - Navigate the filter list
79+
* `Enter` / `Space` - Toggle a section ON/OFF
80+
* `` / `` on **💻 Terminal Output Cap** - Adjust max lines per terminal/tool output block
81+
* `` / `` on **👤 User Message Cap** - Keep only the last N user messages
82+
* `` / `` on **🤖 Agent Message Cap** - Keep only the last N agent responses
83+
* `` / `` on **🧠 Agent Reasoning Cap** - Keep only the last N agent reasoning blocks
84+
* `` / `` on **🔒 Internal Reasoning Cap** - Keep only the last N internal reasoning blocks
85+
* `1`-`7` - Load presets
9686
3. **Export Destination:** Press `Q` when you're ready, and you will be asked where to send the output:
9787
* **[F]ile:** Save directly to a `.md` file in the current directory (Default).
9888
* **[C]lipboard:** Instantly copy the raw Markdown so you can paste it straight into ChatGPT or Claude.
@@ -110,4 +100,4 @@ python codex-md.py
110100

111101
When pushing AI to its limits, the conversation log becomes your most valuable codebase asset. This tool guarantees you have complete ownership, visibility, and control over that data.
112102

113-
*If this tool saved your context window (or your sanity), **please give it a ⭐️!***
103+
*If this tool saved your context window (or your sanity), **please give it a ⭐️!***

0 commit comments

Comments
 (0)