cross-session-handoff

name	cross-session-handoff
description	Read, write, snapshot, and lock .arcgentic/state.yaml across planner, dev, audit, and optional test sessions.

cross-session-handoff

Manages .arcgentic/state.yaml as the shared state medium across multiple AI sessions.

Commands

arcgentic cross-session-handoff read
arcgentic cross-session-handoff write --session-id dev-session --updates '{"current_phase":"dev"}'
arcgentic cross-session-handoff snapshot --session-id audit-session
arcgentic cross-session-handoff acquire-lock --session-id dev-session --ttl 600
arcgentic cross-session-handoff release-lock --session-id dev-session

Rules

• Reads do not acquire a lock.
• Writes acquire a TTL lock, write through a temp file, then rename atomically.
• Snapshots go to .arcgentic/state-history/.
• A session must not overwrite another non-expired lock.

See also

• toolkit/src/arcgentic/skills_impl/cross_session_handoff.py