Local analysis · Codex compaction only after confirmation
Which Codex task is actually large?
Codex Task Overview compares local sessions by file size, cumulative token types, latest context, context share, workspace size and last activity.
Tasks by sizeLive
Last activitytoday · local
Windows 10/11 · 64-bit
Download · Version 0.9.3
The signed setup is recommended. It installs the GUI and CLI for the current user under %LOCALAPPDATA%\AmrumSoftware\CodexUebersicht and supports silent installation.
Current local data
Task overview
Loading local data …
Requesting local website data0 %
ETA calculating · Finish calculatingAll 0 tasks remain individual table rows. Identical paths are merged only for folder count, folder size and file totals: 0 root folders, 0 duplicate paths and 0 already-contained subfolders.
Latest context utilization
High means 75 to below 90%. At 90% and above, the level is very high.
Session-size distribution
File size describes the local log, not the current context.
Session size and context share
Each point is one task. The X-axis starts at the smallest visible value, avoiding an unused left half.
Only the occupied measurement range
Small session files are on the left, large ones on the right. Latest context is low at the bottom and high at the top. Point size shows cumulative tokens.
- Smallest visible session
- —
- Largest visible session
- —
- Tasks remain complete
- 0 individual rows
All three charts use the same 0 visible tasks as the table and total row.
Click heading: sort · drag: reorder · drag edge: resize · right-click: show/hide columns and control wrapping
| No. | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| — | Live 0 · Archive 0 | Σ 0 tasks | 0 B | 0 | 0 | 0 | 0 | 0 | 0 | Avg 0.0% · low | — | Σ 0 root folders | 0 B | 0 |
Understanding columns
Three sizes, three different statements
Session bytes, cumulative token types and current context do not measure the same thing. Workspace values belong to the project on disk.
Click heading: sort · drag: reorder · drag edge: resize · right-click: column menu
| No. | Current table order | Sequential number of the visible row; not a persistent task ID. | Reassigned after filtering or sorting; not summed. |
| Status | Local Codex archive state | The second column shows Live or Archive. The GUI can change it through Codex after confirmation. | Total row shows Live and Archive counts. Archiving shrinks neither context nor session data. |
| Task | Local Codex title index | Most recently saved task title. | Used for finding and matching; not summed. |
| Size | Associated JSONL session files | Disk space for conversation events, tool calls and outputs; not the project-folder size. | Added for all visible tasks. |
| Total tokens | Cumulative local total | All model work recorded so far. Tokens are not bytes. | Added for visible tasks; can grow while the latest context remains small. |
| Input | Cumulative input measurement | Instructions, history and tool results sent to the model. | Summed separately. Cache may already be part of input depending on the log. |
| Cache | Cumulative prompt cache | Reused input tokens from a processed prefix. | Summed separately to show reuse. |
| Output | Cumulative output measurement | Generated answers and tool instructions. | Summed separately. |
| Reasoning | Cumulative reasoning measurement | Internally recorded model work; not visible answer text. | Summed separately. |
| Latest context | Latest recorded model call | Approximate number of tokens considered together in the latest call. | Basis for Context %. Values are added to show current context volume. |
| Context % | Latest context ÷ context window | Low <50%, elevated 50–<75%, high 75–<90%, very high ≥90%. | Percentages are averaged, not added. |
| Last activity | Newest session timestamp | Most recent local event for the task. | Does not prove completion and has no total. |
| Workspace | Latest command working directory | The real project directory. | Exact duplicates count once; contained subfolders do not add another root folder. |
| Folder size | Recursive file-system measurement | All files in the folder and its subfolders; junctions are not followed. | Duplicates and already-contained subfolders are not added twice. |
| Files | Recursive file-system measurement | Number of all files in the folder and subfolders. | Uses the same duplicate/subfolder rule as folder size. |
Width optimization: enabled columns only are fitted to the available width; hidden columns keep their widths. Text wraps only at existing whitespace. Words, paths, codes and numbers are never split, and numeric columns always stay on one line. Numeric headings and values are right-aligned; every heading and value is top-aligned.
Reduce a task
Compact or restart with a verified hand-off
Consumed tokens cannot be removed retroactively. The GUI can ask Codex to summarize the active context or prepare a controlled hand-off to a new task.
Compact directly
The app checks runtime status directly through Codex. A stale local start marker alone no longer blocks the action, while an active Codex response still does. An Archive task must be returned to Live with Unarchive first; both hover and click explain this. Intermediate percentage, ETA and finish time are explicitly estimated from prior durations.
New task with hand-off
Best for very large, confusing or changing work. The new task starts with the smallest verified context.
→
→
- Choose a safe stopping point.Finish current edits and tests.
- Select exactly one task.Open “Reduce task” in the GUI.
- Prepare the hand-off.The app never overwrites an existing hand-off file.
- Verify and restart.Use the same E: workspace in the new task.
- Archive only after verification.Archiving does not erase the old session.
Direct actions: after confirmation, compaction, Archive and Unarchive use the official Codex interface. Compaction waits for both the compaction item and its enclosing turn to complete. Archiving first checks that the task is not running. The main window cannot close while any of these actions is still running. Exactly the changed task is reread immediately, and the local website snapshot and current exports are updated.
Features
Your Codex workload at a glance
Real local data
Reads the title index and session logs without modifying Codex databases.
Separate token types
Input, cache, output, reasoning and latest context remain distinct.
Reliable progress
Initial load and refresh show phases, percentage, ETA and finish time.
Safe compaction
Checks task activity and refreshes exactly the affected task afterward.
Flexible tables
Sortable, movable, hideable columns with saved widths and careful wrapping.
Open exports
CSV, TXT, JSON, XML, ODS and XLS without proprietary storage.
Direct archive control
Archive and Unarchive use the official Codex interface after confirmation; archiving first checks task activity.
CLI parameters
Automatable, traceable, local
Use --help or -h for all current options.
Click heading: sort · drag: reorder · drag edge: resize · right-click: column menu
| no command / gui | --refresh fully refreshes the cache; default: use cache | Starts the GUI. Data remains local. | CodexUebersichtCLI.exe |
| --help / -h | no values | Shows commands and options; changes no data. | CodexUebersichtCLI.exe --help |
| --version | no values | Shows the program version. | CodexUebersichtCLI.exe --version |
| scan | --sort size|tokens|context|activity|title|folder-size|files; --ascending; --limit N; --json; --refresh | Prints the complete overview as a table or JSON. --limit limits output only. | CodexUebersichtCLI.exe scan --sort activity --limit 10 |
| export | --format csv|txt|json|xml|ods|xls; --output PATH; --timestamp; --refresh | Writes local export files. | CodexUebersichtCLI.exe export --format csv --format ods |
| daily | --output PATH; --refresh | Writes a complete daily report into year/month folders. | CodexUebersichtCLI.exe daily |
| schedule | status by default; --install; --remove; --time HH:MM | Manages the local daily Windows task only when explicitly requested. | CodexUebersichtCLI.exe schedule --install --time 07:00 |
| website | --open; --serve; --port N; --refresh | Updates website data. The server binds only to 127.0.0.1/localhost. | CodexUebersichtCLI.exe website --open |
| paths | no values | Shows project, Codex, cache and website paths. | CodexUebersichtCLI.exe paths |
| self-test | no values | Runs embedded runtime checks. | CodexUebersichtCLI.exe self-test |
FAQ
Common questions
How can a new task already have a high context share?
Large instructions, memory guidance, tool outputs and many model calls can fill context quickly. The overview always shows the latest recorded model call.
Are tasks sharing one workspace hidden?
No. Every task remains one row. Duplicate paths affect only the three workspace totals.
Can the app detect a running task?
Yes. It checks the runtime status directly through Codex. An active response blocks compaction, but a stale local start marker alone no longer causes a permanent false alarm.
Are compaction percentages exact?
Start and completion are exact. Codex does not expose intermediate percentages, so percentage, ETA and finish time between those events are clearly estimated from observed durations.
Does compaction shrink the session file?
No. It frees active context but preserves stored history and cumulative counters.
Does the app upload task data?
No. Scans, workspace measurement, website and exports stay local. At startup, the app checks the public version file at most once per calendar day and sends only the random installation UUID, never task names, paths, sizes or token values. A 90-day deadline starts only after a newer version was successfully detected; a failed request alone starts no deadline. Explicitly confirmed compaction separately uses the installed Codex connection.
Versions
Change history
0.9.3 · 2026-08-04 — Compaction now waits for both the completed compaction item and the enclosing Codex turn before closing its helper process. Runtime status is checked directly through Codex, so stale local start markers no longer cause permanent false alarms. The main window cannot close while compaction, Archive or Unarchive is running.
0.9.2 · 2026-08-01 — Status is now the second column with Live or Archive values. Confirmed Archive and Unarchive actions use the official Codex interface, check task activity before archiving and immediately refresh only the changed task. Archived-task compaction now explains that Unarchive is required first.
0.9.1 · 2026-07-31 — Width optimization now changes enabled columns only. Text wraps exclusively at existing whitespace, while numeric columns always stay on one line. Added a signed setup, silent per-user installation, public download page and daily pseudonymous update check with a 90-day deadline that begins only after successful detection.
0.9.0 · 2026-07-31 — Multi-line GUI headings now receive sufficient dynamic height; explicit Wrap on, Wrap off and Reset columns commands were added to every table.
0.8.0 · 2026-07-31 — Fixed width optimization, right/top alignment, German/English UI, task-activity checks, estimated compaction progress and immediate single-task refresh.
0.7.0 · 2026-07-31 — Direct Codex compaction, load progress and resizable detail area.
0.6.0 · 2026-07-31 — Full-width website, chart correction and complete table controls.
0.5.0 and earlier — Separate token types, workspace totals, exports, CLI and local website.
Help
Using the overview
Start the GUI with CodexUebersicht.exe. Click headings to sort, drag them to reorder, drag the right edge to resize, and right-click for visibility, wrapping and one-time width optimization.
Width optimization uses every visible row but changes enabled columns only; hidden columns keep their widths. Text wraps only at existing whitespace, and numeric columns never wrap. Multi-line headings automatically receive enough height. Wrap on, Wrap off and Reset columns are available as explicit commands.
Refresh or Ctrl+R performs a new local measurement with percentage, ETA and finish time. The horizontal divider changes the detail-area height.
Archive and Unarchive change the selected task through the official Codex interface after confirmation. Before archiving, the app checks runtime status directly through Codex. For compaction, select exactly one Live task. Hover and click explain that an Archive task must be unarchived first. Intermediate progress is estimated, and the app waits for the full turn completion before refreshing exactly that task. The main window cannot close while compaction, Archive or Unarchive runs.
Contact: CodexUebersicht@jostjahn.de
About
About the program
Codex Task Overview 0.9.3 is a local Windows application with GUI, CLI and embedded product website.
The start language follows the operating system: German only for a German locale, otherwise English. The saved language choice can be changed in the app or website.
Platform: Windows. Author and provider: Jost Jahn · CodexUebersicht@jostjahn.de
Legal notice
Provider information
Jost Jahn
Smaeswai 4
25946 Nebel
Germany
Email: CodexUebersicht@jostjahn.de
Amrum Software is a project and collective name for the software offerings of Jost Jahn and is not a separate legal entity.
For legal interpretation, the German version takes precedence.
Privacy
Your tasks stay here
Controller: Jost Jahn, Smaeswai 4, 25946 Nebel, Germany, CodexUebersicht@jostjahn.de.
Local processing: The app reads local titles, session logs, workspace paths, file sizes and token measurements. Cache, reports and exports remain in the project folder.
Version check: At most once per calendar day, the app sends only its random UUID4 installation ID to the public version file. The ID is not derived from hardware, account or license data. No task names, paths, sizes or token values are sent. A 90-day deadline begins only after successful detection of a newer version; a failed request alone starts no deadline.
Compaction: Only after explicit confirmation does the app use the installed Codex interface and its normal Codex service connection. No analytics or advertising connection is created.
Local server: The website binds only to 127.0.0.1. Task data does not leave the computer.
Deletion: You can delete cache, exports and reports in the project folder. This app does not delete original Codex sessions.
For legal interpretation, the German privacy text takes precedence.