https://github.com/perlinson/codex-session-restore
used to restore session when you switch between custom providers
https://github.com/perlinson/codex-session-restore
codex codex-app codex-cli session
Last synced: 20 days ago
JSON representation
used to restore session when you switch between custom providers
- Host: GitHub
- URL: https://github.com/perlinson/codex-session-restore
- Owner: perlinson
- Created: 2026-06-17T06:18:13.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-21T11:32:11.000Z (27 days ago)
- Last Synced: 2026-06-21T14:15:46.039Z (26 days ago)
- Topics: codex, codex-app, codex-cli, session
- Language: Go
- Homepage:
- Size: 60.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# codex-session-restore
`codex-session-restore` 是一个 Go 编写的 Codex Desktop 会话 provider 修复工具。
它会读取当前用户的 `.codex/config.toml`，获取当前 `model_provider`，然后把 `state_5.sqlite` 中不属于当前 provider 的 sessions 批量切换到当前 provider，并同步修复对应 rollout JSONL 和 `session_index.jsonl`。
## 默认行为
双击可执行文件，或无参数运行时，默认执行：
```bash
codex-session-restore switch-current-provider
```
执行结果会写入可执行文件旁边的 `codex-session-restore.log`。如果该目录不可写，则写入用户主目录。
## 命令
```bash
codex-session-restore
codex-session-restore switch-current-provider
codex-session-restore switch-current-provider --dry-run
codex-session-restore switch-current-provider --include-archived
codex-session-restore inspect --limit 20
codex-session-restore search --keyword project
```
## 安全策略
- 修改前会备份 `state_5.sqlite`、`session_index.jsonl` 和目标 rollout JSONL。
- `--dry-run` 只预览，不写入文件。
- 默认只处理未归档 sessions。
- `--include-archived` 会同时处理已归档 sessions，并将它们恢复为未归档。
## 构建
```bash
go test ./...
go build ./cmd/codex-session-restore
```
多平台构建：
```bash
mkdir -p dist
GOOS=darwin GOARCH=amd64 go build -o dist/codex-session-restore-darwin-amd64 ./cmd/codex-session-restore
GOOS=darwin GOARCH=arm64 go build -o dist/codex-session-restore-darwin-arm64 ./cmd/codex-session-restore
GOOS=windows GOARCH=amd64 go build -o dist/codex-session-restore-windows-amd64.exe ./cmd/codex-session-restore
GOOS=windows GOARCH=arm64 go build -o dist/codex-session-restore-windows-arm64.exe ./cmd/codex-session-restore
GOOS=linux GOARCH=amd64 go build -o dist/codex-session-restore-linux-amd64 ./cmd/codex-session-restore
GOOS=linux GOARCH=arm64 go build -o dist/codex-session-restore-linux-arm64 ./cmd/codex-session-restore
```