Menu
Use when historical Codex JSONL sessions from `<codex-history-root>` need to be discovered, dry-run checked, and sequentially imported into `.aoa` archives.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when a `.aoa` session-memory root must be created, installed, checked, repaired, or prepared for Codex hook-based session archiving.
Use when an indexed `.aoa` session needs provisional first-pass distillation into lessons, decisions, failures, and automation candidates without promoting them to reviewed truth.
Use when an agent needs evidence from prior `.aoa` sessions about how a skill, MCP, hook, tool, API, goal, eval, test, validator, script, decision, error, receipt, or other recurring operational entity was used, what happened nearby, and which raw or segment refs prove it.
Use in any Codex session when the user mentions `.aoa`, session memory, Codex transcripts, compaction, prior session rehydration, hook failures, or AoA session-memory validation.
Use when an agent needs to build or query the portable `.aoa` SQLite search index for archived Codex sessions, with evidence refs and freshness checks.
Use when the live Codex PreCompact and PostCompact hook path must be proven through `.aoa` using the Codex app-server compact probe.
| name | aoa-session-history-import |
| description | Use when historical Codex JSONL sessions from `<codex-history-root>` need to be discovered, dry-run checked, and sequentially imported into `.aoa` archives. |
| license | Apache-2.0 |
| metadata | {"aoa_scope":"session-memory","aoa_invocation_mode":"manual"} |
Use this when older Codex sessions need to be laid out into the .aoa
archive without manually calling sync for each transcript.
raw_unavailable archives may be repairable from existing JSONL transcripts.Stop hook receipt, leaving
a missing, stale, deferred, or hook-only .aoa archive.Start with a dry run:
python3 scripts/aoa_session_memory.py import-codex-sessions \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--since-days 21 \
--dry-run \
--write-report
If the dry-run count is coherent, run the import:
python3 scripts/aoa_session_memory.py import-codex-sessions \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--since-days 21 \
--write-report
Use --force only when an already indexed archive must be rebuilt.
For recent missed close/no-hook recovery, prefer the narrower sweeper before a broad import:
python3 scripts/aoa_session_memory.py sweep-codex-sessions \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--since-days 7 \
--min-age-sec 60 \
--dry-run \
--write-report
The sweeper is dry-run by default and uses indexed_archive_freshness to plan
only missing, stale, deferred, hook-only, or raw-unavailable transcripts. Add
--apply after the plan is coherent.
.aoa/diagnostics/counts.error is absent or zero--force was used--applydoctor and audit remain green after the runDo not open every raw transcript in context. Use the import report, registry, manifests, and segment indexes as the navigation layer.