apx-sessions

Find, summarize, and resume coding sessions across Claude, Codex, OpenCode, and APX engines.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-sessions-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-sessions
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-sessions
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-sessions-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coding sessions are scattered across multiple AI engines (Claude, Codex, OpenCode, APX) with different storage formats and locations, making it hard to find a past conversation, recall what was decided, or continue work where you left off. ## Core Features & Use Cases - Cross-engine discovery: Find sessions by title or transcript content across every detected engine with apx session find, without knowing which engine owns the session. - Summarize and ask: Generate LLM summaries of any session or ask questions about large transcripts via map-reduced RAG-style Q&A. - Resume and migrate: Re-open sessions in their native CLI, or convert a Codex/Claude session into a new APX session with --into apx:slug to continue work under a different agent. - Use Case: You remember discussing sidebar changes last week but not which tool you used. Run apx session find "sidebar", then apx session ask <id> "what sidebar changes were left pending?" to recover the context instantly. ## Quick Start Ask the agent to find the session about improving the web UI and summarize what was left pending.

Frequently Asked Questions about apx-sessions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a past Claude or Codex session by topic?▼

Use apx session find with a text query to search session titles across all detected engines, newest first. Add --deep to also grep transcript content, or --engine and --dir to narrow the scope.

How do I resume a Codex session inside APX?▼

Run apx session resume <id> --summary --into apx:slug to create a new APX session whose body is a summary of the original. The new session records parent_session with the source engine and id.

Does apx session summary work without the daemon?▼

No. summary, ask, and resume --summary require the APX daemon plus super_agent.enabled in ~/.apx/config.json. Metadata reads, --tail, --full, and --continue work without the daemon.

Why is a Claude session missing from apx sessions list?▼

Claude sessions are only listed for folders that map to a registered APX project, because encoded folder names are lossy. Scope the search with --dir /path/to/repo to reach unregistered Claude projects.

What happens when a session id exists in multiple engines?▼

The command prints all matches with their engine, path, and cwd, then exits with code 2. Re-run with --engine claude or --engine codex to disambiguate.

What are the limits of apx session ask on large transcripts?▼

Ask caps coverage at --max-chunks (default 20, roughly 960 KB) and prints a truncation warning beyond that. Raise --max-chunks for full coverage at the cost of more sequential model calls.