Przejdź do treści
Biblioteka skilli
AI i agenci · Konwersja i formaty

codex-session-manager

/codex-session-manager

Zarządza lokalnymi transkrypcjami sesji Codex: wyświetla sesje, eksportuje je do uporządkowanego Markdown, przegląda archiwa i streszcza historię wywołań narzędzi.

Licencja
MIT
Ostatnia zmiana repozytorium
20.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/manage_codex_sessions.py

Co robi i kiedy

Zarządza lokalnymi transkrypcjami sesji Codex: wyświetla sesje, eksportuje je do uporządkowanego Markdown, przegląda archiwa i streszcza historię wywołań narzędzi.

Oryginalny opis (EN)

Manage local Codex session transcripts, including listing candidate sessions, exporting full or selected sessions to organized Markdown, inspecting archived sessions, and summarizing tool-call history. Use when the user asks to scan, parse, archive, inspect, recover, summarize, manage, or convert Codex sessions, `~/.codex/sessions` data, `~/.codex/archived_sessions` data, `.jsonl` transcripts, tool-call history, or hard-to-read Codex conversation logs.

Jak działa

  1. Overview
  2. Quick Start
  3. Specific Mode Candidate Flow
  4. Output Layout
  5. Workflow
  6. Notes
Sekcje z nagłówków SKILL.md, w oryginale · 99 linii, 632 słów
Podgląd SKILL.md
---
name: codex-session-manager
description: Manage local Codex session transcripts, including listing candidate sessions, exporting full or selected sessions to organized Markdown, inspecting archived sessions, and summarizing tool-call history. Use when the user asks to scan, parse, archive, inspect, recover, summarize, manage, or convert Codex sessions, `~/.codex/sessions` data, `~/.codex/archived_sessions` data, `.jsonl` transcripts, tool-call history, or hard-to-read Codex conversation logs.
---

# Codex Session Manager

## Overview

Codex stores session transcripts as JSONL files under `~/.codex/sessions/YYYY/MM/DD/*.jsonl`. Archived sessions may also exist under `~/.codex/archived_sessions/*.jsonl`. Use the bundled manager to list candidates or export sessions into Markdown transcripts with a digest, timeline, message text, and linked tool-call details.

Default output folder: `~/.codex/session-markdown`. Tell the user before exporting there, and mention any custom output folder they requested.

## Quick Start

Let the user's wording choose the mode when it is clear; otherwise ask them to choose before exporting:

- Full mode: export all matching sessions. Use this for archive, backup, broad search, or "convert all sessions" requests.
- Specific mode: list candidate sessions first, ask the user to pick one, then export only that session.

Run from any directory:

```bash
python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py
```

Useful options:

- `--mode full`: export all matching sessions. This is the default.
- `--mode specific --list-candidates`: print a numbered candidate table and do not export.
- `--mode specific --pick N`: export the Nth candidate from the same filtered candidate list.
- `--include-archived`: also scan `~/.codex/archived_sessions`.
- `--project <text>`: only export date/project keys containing this text.
- `--session <text>`: only export sessions whose id or filename contains this text.
- `--since YYYY-MM-DD`: only export sessions modified on or after this date.
- `--limit N`: export the N most recently modified matching sessions.
- `--include-tool-details-inline`: embed full tool payloads in the main session Markdown instead of sidecar files.

## Specific Mode Candidate Flow

Use this flow when the user wants one Codex session, is unsure which session they need, or asks to inspect recent sessions before converting.

1. Run a candidate list command. Use `--limit 20` by default unless the user asks for a different count.

```bash
python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py \
  --mode specific \
  --list-candidates \
  --limit 20
```

2. If the user gave a date, session id fragment, or archive hint, pass it through the same filters:

```bash
python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py \
  --mode specific \
  --list-candidates \
  --since 2026-06-01 \
  --include-archived \
  --limit 20
```

3. Present the numbered candidate rows to the user. The candidate table includes modified time, date/project key, short session id, cwd, and first user prompt excerpt.
4. After the user chooses a number, rerun with the exact same filters and `--pick N`.

If the user already gives an exact session id or unique fragment, use `--mode specific --session <id-or-fragment> --list-candidates` first when there is any ambiguity. Export with `--pick 1` only when the candidate list has exactly one match.

## Output Layout

The exporter writes:

```text
~/.codex/session-markdown/
├── index.md
└── <date-or-archive-key>/
    ├── index.md
    ├── <session-id>.md
    └── tool-details/
        └── <session-id>.tools.md
```

Each session Markdown includes:

- Digest: source path, key, session id, cwd, timestamps, event/message/tool counts, and first user prompt excerpt.
- Linked tool details file when tool calls or results exist.
- Timeline: session metadata, user/assistant/developer messages, reasoning summaries, tool calls, and tool outputs.
- Short tool summaries inline, with full JSON payloads in the sidecar file by default.

## Workflow

1. Confirm the source folder. Default to `~/.codex/sessions`; add `--include-archived` when the user asks about archived sessions.
2. Ask the user to choose full mode or specific mode if they did not already make the choice.
3. Confirm or announce the output folder. Default to `~/.codex/session-markdown`.
4. For full mode, run the manager script with any needed filters.
5. For specific mode, list candidates, get the user's chosen number, then export with `--pick`.
6. Report the number of sessions exported, output index path, and any parse warnings.

## Notes

- Treat transcript data as private. It can contain prompts, file contents, command output, secrets accidentally pasted into chat, and tool results.
- Do not delete or modify original `.jsonl` files.
- Prefer sidecar tool details for large sessions. Inline tool payloads can make Markdown hard to search and load.
Pliki w paczce (3)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB
  • scripts/manage_codex_sessions.py 23 KB

Wersje

W bazie nie ma innych skilli o nazwie codex-session-manager.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 5a07d501ffb0 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100claude-session-manager
    Zarządza transkryptami sesji Claude Code z lokalnego JSONL: listuje sesje, eksportuje do uporządkowanego Markdown, sprawdza archiwa i streszcza historię wywołań narzędzi.
  • 100codex-session-parsing
    Lokalizuje, parsuje i podsumowuje transkrypty sesji Codex: prompty, wywołania narzędzi, czasy i zużycie tokenów.
  • 100session-history
    Przeszukuje i streszcza historię sesji Claude Code, Codex i opencode: dawne rozmowy, sesje na dany temat i odtwarzanie narracji debugowania.
  • 100codex-tracker-suite
    Wyszukuje, przegląda, wylicza i odzyskuje lokalne sesje Codex przez natywne API App Server, w tym tworzy bezpieczne polecenie wznowienia sesji.
  • 90export-transcripts
    Eksportuje rozmowę z agentem kodującym, Claude Code lub Codex, do Markdown, HTML albo JSON, z opcją pełnego zapisu narzędzi.
  • 100sessions
    Przegląda i czyta zapisy rozmów agentów z Claude, Codex, Gemini i OpenCode, by odzyskać kontekst albo sprawdzić, co agenci zrobili.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.