Menu
Use when a `.aoa` session-memory root must be created, installed, checked, repaired, or prepared for Codex hook-based session archiving.
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 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.
Use when AoA Codex hooks must be inspected, trusted, or compared against expected `.aoa` commands in the native Codex hook registry.
| name | aoa-session-archive-init |
| description | Use when a `.aoa` session-memory root must be created, installed, checked, repaired, or prepared for Codex hook-based session archiving. |
| license | Apache-2.0 |
| metadata | {"aoa_scope":"session-memory","aoa_invocation_mode":"manual"} |
Use when the .aoa session-memory root must be created, checked, or repaired
before Codex session archiving starts.
.aoa does not exist or is incomplete..aoa rootAGENTS.md..aoa root is inside the intended workspace or explicit
storage root.AGENTS.md, DESIGN.md, DESIGN.AGENTS.md, PIPELINE.md,
NAMING.md, README.md, INSTALL.md, config/AGENTS.md,
hooks/AGENTS.md, schemas/AGENTS.md, scripts/AGENTS.md,
skills/AGENTS.md, tests/AGENTS.md, sessions/, and
sessions/AGENTS.md exist.install --workspace-root <root> rather than
copying hook JSON by hand.python3 .aoa/scripts/aoa_session_memory.py hooks-config --workspace-root <root> --aoa-root <root>/.aoa.python3 .aoa/scripts/aoa_session_memory.py codex-grounding --workspace-root <root> --aoa-root <root>/.aoa on hosts that have Codex installed.python3 .aoa/scripts/aoa_session_memory.py validate --workspace-root <root> --aoa-root <root>/.aoa.python3 .aoa/scripts/aoa_session_memory.py doctor --workspace-root <root> --aoa-root <root>/.aoa..aoa/AGENTS.md exists..aoa/INSTALL.md exists for portable setup..aoa/scripts/aoa_session_memory.py compiles.export-bundle always creates a public-safe bundle without session archives
or raw evidence. The legacy --with-sessions spelling is retained only to
fail explicitly and direct private transfers to an owner-to-owner migration
route.portable-public-safety-audit reports no credential, host-path, runtime
database, diagnostics, session-evidence, or incomplete-coverage findings.hooks-config emits all required Codex lifecycle hooks for the selected
roots.codex-grounding passes on a host with Codex installed.validate passes the temporary light-hook preservation run and explicit
full-sync archive run.doctor exits successfully before any session exists.Do not import old Downloads material or project-specific doctrine into the portable kernel.