Agent skill

History Portability

by hoangsonww in hoangsonww/Claude-Code-Agent-Monitor

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

MITAuto-check passed

Install History Portability

skills CLI
$ npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor history-portability --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ccam-platform/skills/history-portability .claude/skills/history-portability && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
history-portability
GitHub stars
1.1k
Token cost
~308 tokens
SKILL.md length
104 words
Files
2
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Read provider-specific paths and limits → Rescan the configured provider home → Scan an existing directory → …
  • Rescanning provider history
  • SKILL.md covers Provider History and Full Dashboard Backup
  • Calls codex

What it does

History Portability is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. 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.

Its SKILL.md is about 310 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

The repository describes itself as: 🚀 A real-time monitoring dashboard for Claude Code & Codex, built with SQLite3, Node.js, Express, React, Vite, TailwindCSS, & WebSockets. It tracks sessions, agent activity… The licence is MIT.

When your agent uses it

  • Rescanning provider history
  • Importing a copied directory
  • Uploading JSONL
  • Exporting a backup

Example prompts

  • “/history-portability”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read provider-specific paths and limits
  2. Rescan the configured provider home
  3. Scan an existing directory
  4. For file or archive upload, use the app or MCP

What it can do on your machine

Read from SKILL.md and the folder at commit a06db03. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

History Portability loads about 308 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 104 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~308

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hoangsonww/Claude-Code-Agent-Monitor at commit a06db03, republished under its MIT licence (© hoangsonww). 104 words, ~308 tokens.

Download SKILL.mdSave it as .claude/skills/history-portability/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
history-portability
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.

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.

© hoangsonww, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ccam-platform/skills/history-portability of hoangsonww/Claude-Code-Agent-Monitor.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit a06db03

Compare with similar skills

History Portability next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

History Portability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
History Portability this skillhoangsonww/Claude-Code-Agent-Monitor1.1k—~308Automated safety check: PassMIT
Importasgeirtj/system_prompts_leaks69k—~3.5kAutomated safety check: PassCC0-1.0
Community Import Smoke Testnexu-io/open-design100k—~211Automated safety check: PassApache-2.0
Nx Importnrwl/nx29k6 repos~3.5kAutomated safety check: PassMIT
Type Only Importsthedaviddias/Front-End-Checklist74k—~558Automated safety check: PassMIT
Import Memoryasgeirtj/system_prompts_leaks69k—~2.7kAutomated safety check: WarnCC0-1.0

Similar skills

  • Import

    asgeirtj/system_prompts_leaks

    Handle explicit /import requests for read-only transcript recovery and a resume checkpoint, or continue work from other coding agents and unnamed artifacts.

    69k GitHub stars~3.5k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Community Import Smoke Test

    nexu-io/open-design

    A portable community plugin for validating OpenDesign plugin import flows.

    100k GitHub stars~211 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Nx Import

    nrwl/nx

    Import, merge, or combine repositories into an Nx workspace using nx import.

    29k GitHub starsUsed in 6 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Type Only Imports

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing import statements in TypeScript files, setting up a new TypeScript project, or investigating unexpected bundle inclusions from type-only dependencies.

    74k GitHub stars~558 tokensUpdated 5 days ago
    Auto-check passed
  • Import Memory

    asgeirtj/system_prompts_leaks

    Import a memory export from another AI assistant into Claude's memory — conversationally, additively, and with the content treated as data.

    69k GitHub stars~2.7k tokensUpdated yesterday
    Auto-check: warnings
  • Hermes Imports

    affaan-m/ECC

    Convert local Hermes operator workflows into sanitized ECC skills and release-pack artifacts.

    277k GitHub starsUsed in 1 repo~752 tokens
    Auto-check passed

More from hoangsonww/Claude-Code-Agent-Monitor

All 78 skills in this repo
  • Version Release

    hoangsonww/Claude-Code-Agent-Monitor

    Choose and apply the correct semantic version bump for this repository.

    1.1k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Budget Set

    hoangsonww/Claude-Code-Agent-Monitor

    Define a spend budget for Claude Code and, optionally, create a cost alert rule that fires when usage crosses the limit, via POST /api/alerts/rules on the Agent Monitor dashboard.

    1.1k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Cache Efficiency

    hoangsonww/Claude-Code-Agent-Monitor

    Analyze prompt-cache effectiveness for Claude Code usage from the Agent Monitor dashboard — cache hit rate (totalcacheread / (totalcacheread + totalinput)), cachewrite vs cacheread reuse, cache-read…

    1.1k GitHub stars~966 tokensUpdated yesterday
    Auto-check passed
  • Cost Breakdown

    hoangsonww/Claude-Code-Agent-Monitor

    Break down Claude Code costs using the Agent Monitor pricing engine.

    1.1k GitHub stars~845 tokensUpdated yesterday
    Auto-check passed
  • Dag Map

    hoangsonww/Claude-Code-Agent-Monitor

    Render the multi-agent orchestration DAG for a session — parent→child subagent edges, tree depth, and fan-out — from the Agent Monitor workflow intelligence API.

    1.1k GitHub stars~564 tokensUpdated yesterday
    Auto-check passed
  • Dashboard Status

    hoangsonww/Claude-Code-Agent-Monitor

    Quick dashboard health and status overview — checks the Agent Monitor API (port 4820), reports session/agent/event counts from /api/stats, confirms WebSocket connectivity, reads the redacted hook…

    1.1k GitHub stars~600 tokensUpdated yesterday
    Auto-check passed

Questions about History Portability

What does History Portability do?

Import Claude Code or Codex history and move complete CCAM datasets between machines. History Portability is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Import Claude Code or Codex history and move complete CCAM datasets between machines.

When should I use History Portability?

History Portability fits situations like: rescanning provider history; importing a copied directory; uploading JSONL; exporting a backup.

How do I install History Portability in Claude Code?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -a claude-code`. Or copy the skill folder (plugins/ccam-platform/skills/history-portability in hoangsonww/Claude-Code-Agent-Monitor) into .claude/skills/history-portability in your project. Claude Code loads it when a task matches its description.

How do I install History Portability in Codex?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -a codex`. Or copy the skill folder (plugins/ccam-platform/skills/history-portability in hoangsonww/Claude-Code-Agent-Monitor) into .agents/skills/history-portability in your project. Codex loads it when a task matches its description.

Can I use History Portability in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill history-portability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/history-portability, .gemini/skills/history-portability, .github/skills/history-portability and .opencode/skills/history-portability in your project.

What does History Portability need to run?

Going by SKILL.md and its folder, History Portability needs the command-line tools its instructions call (codex).

Does History Portability access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is History Portability safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does History Portability use?

History Portability is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does History Portability use?

About 308 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to History Portability?

Skills that share tags, products or a category with History Portability: Import (asgeirtj/system_prompts_leaks, 69k stars), Community Import Smoke Test (nexu-io/open-design, 100k stars), Nx Import (nrwl/nx, 29k stars) and Type Only Imports (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains History Portability?

hoangsonww (a GitHub user) maintains it in hoangsonww/Claude-Code-Agent-Monitor, which has 1,058 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 10, 2026.

Source: hoangsonww/Claude-Code-Agent-Monitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.