{% extends "docs/base.html" %} {% block docs_content %}
Guide: solve a workflow problem
Recover interrupted work from pushed Git state, durable replies, and an explicit takeover record.
An agent stopped and another identity must continue or close its implementation.
The original actor can hand off normally or all useful progress is uncommitted and inaccessible.
| Record | What it contributes | What it cannot recover |
|---|---|---|
| Git | Preserves pushed branches and commits for inspection and continuation. | Uncommitted or unpushed work. |
| Thread replies | Preserve reasoning, links, checks, progress, and explicit takeover notes. | Files that were never committed or uploaded. |
| Activity | Communicates one user's current intent to collaborators. | Durable recovery state or exclusive ownership. |
| Target system | Can enforce idempotency or native ownership for external side effects. | Pearing-local code and reasoning. |
main, and find the last pushed checkpoint.pearing-cli get-thread-tree teams/platform/website 42
git fetch origin alex/release-banner
git switch -c codex/thread-42-handoff origin/alex/release-banner
git log -1 --oneline
pearing-cli update-user-activity self \
--activity "Taking over thread #42 from the last pushed checkpoint."
pearing-cli update-reply teams/platform/website 42 7 \
--body "Takeover: recovered commit a12bc34; no uncommitted files were available. Revalidating before continuing." \
--link branch:codex/thread-42-handoff \
--link commit:a12bc34
pearing-cli update-user-activity self --clear
Load the thread and repository rules before changing code:
Tool: get_thread_context
Arguments:
{
"repo": "teams/platform/website",
"thread_number": 42
}
Tool: get_repo_rules
Arguments:
{
"repo": "teams/platform/website"
}
Activity is not durable state or exclusive ownership. Uncommitted local changes are not recoverable through Pearing; push checkpoints and write progress replies.