# History Portability

> Import Claude Code or Codex history and move complete CCAM datasets between machines. Use when rescanning provider history, importing a copied directory, uploading JSONL or archives, exporting a backup, restoring it idempotently, or verifying that tokens, workflows, runs, rules, and pricing survived.

- Skill: `majiayu000/history-portability` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/history-portability`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/history-portability/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/history-portability

---


# History Portability

## Provider History

1. Read provider-specific paths and limits:
   `ccam import guide --provider claude|codex`.
2. Rescan the configured provider home:
   `ccam import rescan --provider <provider>`.
3. Scan an existing directory:
   `ccam import path /absolute/path --provider <provider>`.
4. For file or archive upload, use the app or MCP
   `dashboard_upload_history_files`.

## Full Dashboard Backup

```bash
ccam export ccam-export.json
ccam import-data ccam-export.json
```

Restore is idempotent and non-destructive. Existing sessions are skipped as a
whole. New sessions bring agents, events, token usage, and workflows. Independent
run, rule, and pricing rows are inserted only when absent.

Verify session counts, representative transcripts, token totals, cost, workflow
runs, alert rules, and both Claude and GPT pricing after restore.