# Cross Session Handoff

> Read, write, snapshot, and lock .arcgentic/state.yaml across planner, dev, audit, and optional test sessions.

- Skill: `arch1esun/cross-session-handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add arch1esun/cross-session-handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arch1esun/cross-session-handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: Arch1eSUN (https://skillmd.com/u/arch1esun)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/arch1esun/cross-session-handoff

---


# cross-session-handoff

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

## Commands

```bash
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`