61 行
1.6 KiB
Markdown
61 行
1.6 KiB
Markdown
# Recovery Reference
|
|
|
|
Use this reference after bootstrap when the synced project needs inspection, conflict recovery, or server-side continuation.
|
|
|
|
## Inspect Status
|
|
|
|
Run these from the migrated project root:
|
|
|
|
```bash
|
|
cat .codex-sync/manifest.json
|
|
cat .codex-sync/runtime/status.json
|
|
cat .codex-sync/runtime/last-error.log
|
|
git status -sb
|
|
```
|
|
|
|
If `status.json` says `blocked`, the last sync hit a rebase or merge conflict and automatic sync has paused itself.
|
|
|
|
## Resolve A Conflict
|
|
|
|
1. Open the project and inspect `git status`.
|
|
2. Resolve the conflict or decide which side to keep.
|
|
3. Finish the git operation or abort it explicitly.
|
|
4. Remove `.codex-sync/runtime/blocked`.
|
|
5. Re-run `.codex-sync/bin/sync-once.sh`.
|
|
|
|
## Re-run Sync Manually
|
|
|
|
```bash
|
|
./.codex-sync/bin/sync-once.sh --project-dir "$PWD"
|
|
```
|
|
|
|
Pass `--host-label local-manual` or `--host-label remote-manual` when you want the autosave commit to identify where it was triggered.
|
|
|
|
## Continue The Task On The Server
|
|
|
|
```bash
|
|
cd /root/continue/<project>
|
|
./.codex-sync/bin/continue-task.sh
|
|
```
|
|
|
|
That command starts Codex with a prompt that tells it to read `.codex-sync/handoff.md`, inspect sync status, and continue work from the server checkout.
|
|
|
|
## Service Control
|
|
|
|
The exact service names are written into `.codex-sync/manifest.json` and `.codex-sync/README.md`.
|
|
|
|
Local macOS:
|
|
|
|
```bash
|
|
launchctl print "gui/$(id -u)/<launchd-label>"
|
|
launchctl kickstart -k "gui/$(id -u)/<launchd-label>"
|
|
```
|
|
|
|
Remote Linux:
|
|
|
|
```bash
|
|
systemctl status <systemd-service> <systemd-timer>
|
|
systemctl restart <systemd-service>
|
|
systemctl restart <systemd-timer>
|
|
```
|