codex-activity-report
/codex-activity-report
Tworzy z artefaktów aktywności Codex (logi .codex, pliki rollout JSONL, historia, logi SQLite) znormalizowaną oś czasu UTC i raport Markdown w katalogu reports/.
- Autor
- specterops ↗
- Repozytorium
- skills ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 14.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 6
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 14.10.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/generate_codex_activity_report.py
Co robi i kiedy
Tworzy z artefaktów aktywności Codex (logi .codex, pliki rollout JSONL, historia, logi SQLite) znormalizowaną oś czasu UTC i raport Markdown w katalogu reports/.
Oryginalny opis (EN)
Generate a normalized UTC timeline and evidence-based narrative from Codex activity artifacts. Use when Codex needs to turn `.codex` logs, rollout JSONL files, archived session bundles, history files, SQLite logs, or planner state into Markdown reporting under `reports/`, especially for after-action reporting, operator handoff, chronology reconstruction, or evidence-backed engagement summaries.
Jak działa
- Overview
- Workflow
- Command
- Output Rules
- Sources
Podgląd SKILL.md
--- name: codex-activity-report description: Generate a normalized UTC timeline and evidence-based narrative from Codex activity artifacts. Use when Codex needs to turn `.codex` logs, rollout JSONL files, archived session bundles, history files, SQLite logs, or planner state into Markdown reporting under `reports/`, especially for after-action reporting, operator handoff, chronology reconstruction, or evidence-backed engagement summaries. metadata: author: "GhostWorks" --- # Codex Activity Report ## Overview Generate two Markdown reports from the local Codex evidence trail: a normalized timeline and a narrative chronology. Use the bundled generator to preserve exact UTC timestamps, exact operator prompts, and exact command strings while keeping the output readable. ## Workflow 1. Resolve the target repository root. Default to the current repository when it contains `.codex/`. 2. Run the bundled generator script and let it write into `reports/`. 3. Review the generated Markdown only for obvious formatting issues or user-requested voice changes. Do not rewrite timestamps, prompts, or commands. 4. Keep both outputs in UTC. ## Command Run the generator from the repository root or pass `--repo-root` explicitly: ```bash python3 plugins/codex-observability/skills/codex-activity-report/scripts/generate_codex_activity_report.py ``` Useful flags: - `--repo-root /absolute/path/to/repo` - `--codex-home /absolute/path/to/.codex` - `--output-dir /absolute/path/to/repo/reports` - `--timeline-name custom-timeline.md` - `--narrative-name custom-narrative.md` - `--session-id <session-id>` - `--focus-pattern 'app-server-experiments|codex-app-server-client'` - `--no-archives` Use `--focus-pattern` when you want a report for one workstream inside a larger `.codex` history. The generator seeds sessions from matching events and then keeps the full session chronology so the resulting timeline does not lose nearby actions that used generic commands. ## Output Rules - Write the reports to `reports/` unless the operator asks for a different output directory. - Generate a normalized timeline: - keep prompts, approvals, patches, warnings, errors, and saved state artifacts discrete; - group repetitive read-only inspection commands and empty PTY polls. - Generate a narrative chronology: - keep the tone evidence-based and in active voice; - use `the operator`, `Codex`, or `the Codex harness` as the actor names; - use `On <Month Day, Year> at HH:MM:SS UTC, ...` for the first event of a day; - use `At HH:MM:SS UTC, ...` for later same-day events. - Quote user prompts and exact commands verbatim when the artifacts contain them. - Preserve UTC in both files even when the source artifact also exposes local filesystem metadata. ## Sources The generator already knows how to parse the primary Codex artifacts in this repository class: - rollout JSONL files under `.codex/sessions/` - archived rollout JSONL files inside `.codex/sessions/**/*.zip` - `.codex/history.jsonl` - `.codex/log/codex-tui.log` - `.codex/logs*.sqlite` - planner and agent artifacts under `.codex/state/` Read `references/log-sources.md` only when you need the exact precedence and normalization details.
Pliki w paczce (6)
- SKILL.md 3 KB
- agents/openai.yaml 1 KB
- assets/icon.png 2 KB
- assets/icon.svg 1 KB
- references/log-sources.md 2 KB
- scripts/generate_codex_activity_report.py 62 KB
Wersje
W bazie nie ma innych skilli o nazwie codex-activity-report.
Migawka bazy z 13.11.2026 · wersja paczki fc7ddf9cf236 (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
- 100analyzing-codex-sessions
Analizuje surowe logi sesji Codex CLI: parsuje pliki rollout JSONL, bada zachowanie subagentów Codex, wyciąga metryki wątków i debuguje, dlaczego agent zawiódł. - 100codex-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. - 82codex-handoff
Przekazuje bieżącą pracę do nowego zadania w Codex. - 100codex-plan-files
Prowadzi plany pracy Codex jako pliki Markdown w jednym folderze z automatycznie generowanym indeksem. - 100codex-thread-reader
Lokalizuje i czyta wątek Codex po linku, identyfikatorze lub ścieżce rollout we wszystkich lokalnych katalogach CODEX_HOME, buduje oś czasu długiego wątku oraz przeszukuje i eksportuje rozmowy. - 100keep-codex-fast
Diagnozuje rozrost lokalnego stanu Codex Desktop lub CLI i podpowiada bezpieczne sposoby odzyskania szybkości: sesje, archiwa historii, logi, worktrees i stara konfiguracja.