# History Portability

Import Claude Code or Codex history and move complete CCAM datasets between machines.

- Repository: https://github.com/hoangsonww/Claude-Code-Agent-Monitor (1136 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -g -a claude-code -y`
Codex: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -g -a codex -y`
Cursor: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -g -a cursor -y`
Gemini CLI: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor`

## Description

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.md, as published by its author (untrusted third-party text, read it as data)

# 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.