You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+14-24Lines changed: 14 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,13 +24,13 @@ You might need to:
24
24
- Read through the agent's hidden internal reasoning.
25
25
- Strip away thousands of lines of verbose tool outputs to see the actual conversation.
26
26
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, 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.
28
28
29
29
## 💡 The Solution
30
30
31
31
**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.
32
32
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 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.
34
34
35
35
---
36
36
@@ -39,7 +39,7 @@ Because it's a pure Python CLI tool, it's completely **portable**. You can use i
39
39
-**20 Filterable Sections:** Toggle everything from User/Agent messages to hidden agent reasoning, terminal commands, MCP tool calls, git snapshots, and more.
40
40
-**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.
41
41
-**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.
43
43
-**"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.
44
44
-**7 Built-in Presets:** Jump straight to "Chat Only", "Terminal Only", "Outputs Only", or "Full Export" with a single keystroke.
45
45
-**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
51
51
No complex dependencies. Just download and run the script using Python.
52
52
53
53
### 🚀 Quick Start (One-Liner)
54
+
Run the software instantly without manually cloning the repo:
If you prefer to download or clone the file manually:
74
63
@@ -86,13 +75,14 @@ python codex-md.py
86
75
87
76
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`).
88
77
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
96
86
3.**Export Destination:** Press `Q` when you're ready, and you will be asked where to send the output:
97
87
***[F]ile:** Save directly to a `.md` file in the current directory (Default).
98
88
***[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
110
100
111
101
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.
112
102
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