migrate

Solid

Audit a hermit-backed repo for safe migration to another machine. Classifies files, generates a migration manifest, and produces a verification checklist. Git-first, conservative by default.

AI & Automation 74 stars 15 forks Updated today MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
62
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Migrate Hermit Repo Audit the current repo for safe migration to another machine. Produce a classification of files to migrate, a manifest, bootstrap requirements, and a verification checklist. Git is the source of truth. Migration should be minimal. This skill is read-only — it does not modify files unless you explicitly ask. ## Scoping - `.claude/settings.json` — **project-scoped** (committed). Tracked in git. Migrates with git clone. - `.claude/settings.local.json` — **machine/user-scoped** (gitignored). Contains task list ID (always) and hook permissions + deny patterns (when plugin was installed at local or user scope). Must be recreated on destination — never migrated by git clone. Check `.claude-code-hermit/state/hatch-options.json` `"target"` field: if `"local"`, this file contains hermit's hook permissions and deny patterns; the operator must re-run `/hatch` or `/hermit-evolve` on the destination to restore them. - `.claude.local/` — **machine/user-scoped** (channel state dirs, local overrides). Needs recreation on destination. Never migrated. ## Rules - Do not write or modify any files unless the operator explicitly requests it - Classify conservatively: when in doubt, put a file in DO_NOT_MIGRATE or REVIEW_MANUALLY - `.claude/settings.json` migrates with git clone — never flag it for manual migration or recreation - `.claude/settings.local.json` does NOT migrate with git clone — flag for recreation on destination - `.claude.local/` must be recreated on dest...

Details

Author
gtapps
Repository
gtapps/claude-code-hermit
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

migrate

The credo procedure for migrating an existing repo into the .credo/ structure, without any loss risk. Use when migrating a repo into .credo/, onboarding a legacy project into credo, or turning scattered process docs (requirements logs, handoffs, progress notes, audits, plans, specs) and open work into credo items. It is copy-only and additive: originals are never touched until a final, user-gated tidy step. This is a long, multi-phase, subagent-heavy operation. Applies inside subagents too - any agent doing migration work follows these rules and the credo safety skill.

13 Updated 2 days ago
Marcel-Bich
AI & Automation Listed

claude-code-repo-migration

Move or rename a git repo on disk without losing its Claude Code history — remap the session dir (~/.claude/projects/<slug>/) and the ~/.claude.json projects key so every past session still resumes from the new path with trust, allowedTools and MCP servers intact, and repair the git worktrees the move breaks. Use when moving a repo to a different parent folder, renaming the org/parent directory, reorganising ~/projects, or after a move when: `claude --resume` shows no sessions / the session picker is empty at the new path, the trust dialog or project onboarding reappears, allowedTools or MCP servers were 'forgotten', auto-memory looks empty, or `git worktree list` / a worktree's git commands break. Covers the slug rule people get wrong (EVERY non-alphanumeric char becomes '-', not just '/'), which extra slug dirs a repo owns, backup-then-mutate ordering, and the fact that ~/.claude.json is live-rewritten by every running session.

3 Updated 2 weeks ago
stealth-factory
AI & Automation Featured

repo-harness-migrate

Migrates older Claude/Codex workflow repos to the current tasks-first harness while preserving or archiving user-authored docs and hooks.

431 Updated today
Ancienttwo