@propel-code/codex-mover 0.1.0 → 0.1.1

package/README.md

@@ -1,12 +1,12 @@
 # codex-mover
 
-`codex-mover` packages portable Codex and Claude Code history/context into a tarball and merges that tarball into another machine's local data.
+`codex-mover` packages portable Codex and Claude Code history into a tarball and merges it into another machine's local data.
 
-The package installs a primary `codex-mover` CLI and a `codeport` alias for compatibility with the old `codegraph`-embedded command.
+It is meant for moving useful context between machines without copying machine-local or account-local state.
 
 ## Install
 
-Use without installing:
+Run without installing:
 
 ```bash
 npx @propel-code/codex-mover --help
@@ -17,10 +17,9 @@ Install globally:
 ```bash
 npm install -g @propel-code/codex-mover
 codex-mover --help
-codeport --help
 ```
 
-Use with Bun:
+Run with Bun:
 
 ```bash
 bunx @propel-code/codex-mover --help
@@ -33,56 +32,52 @@ codex-mover pack [--output ./codex-mover-archive.tar.gz] [--provider codex|claud
 codex-mover merge --input ./codex-mover-archive.tar.gz [--provider codex|claude|all] [--path-map /old=/new]
 ```
 
-Examples:
+Commands print a JSON summary to stdout.
+
+### Examples
 
 ```bash
-codex-mover pack --output ./tony-context.tar.gz
-codex-mover merge --input ./tony-context.tar.gz
-codex-mover merge --input ./tony-context.tar.gz --path-map /Users/tony/dev=/Users/alice/dev
+codex-mover pack --output ./context.tar.gz
+codex-mover merge --input ./context.tar.gz
+codex-mover merge --input ./context.tar.gz --provider codex
+codex-mover merge --input ./context.tar.gz --path-map /old/workspace=/new/workspace
 ```
 
-Options:
-
-- `--input`
-  Archive path to merge in `merge` mode.
-- `--output`
-  Archive path to create in `pack` mode. Defaults to `./codex-mover-<timestamp>.tar.gz`.
-- `--provider codex|claude|all`
-  Package or merge a single provider or both. Default is `all`.
-- `--codex-home PATH`
-  Override the Codex home directory.
-- `--claude-config-dir PATH`
-  Override the Claude config directory.
-- `--path-map OLD=NEW`
-  Rewrite stored project paths during merge. Repeat this flag when multiple roots moved.
-- `--help`
-  Print usage information.
-
-## What It Copies
+### Options
+
+- `--input` Archive path to merge in `merge` mode.
+- `--output`, `-o` Archive path to create in `pack` mode. Defaults to `./codex-mover-<timestamp>.tar.gz`.
+- `--provider codex|claude|all` Package or merge a single provider or both. Default is `all`.
+- `--codex-home PATH` Override the Codex home directory. Otherwise `codex-mover` uses `$CODEX_HOME` or `~/.codex`.
+- `--claude-config-dir PATH` Override the Claude config directory. Otherwise `codex-mover` uses `$CLAUDE_CONFIG_DIR`, `~/.claude`, or `~/.config/claude`.
+- `--path-map OLD=NEW` Rewrite stored project paths during merge. Repeat this flag when multiple roots moved.
+- `--help`, `-h` Print usage information.
+
+## What Gets Moved
 
 By default, `codex-mover` includes portable history and context:
 
-- Codex: `sessions/`, `archived_sessions/`, `history.jsonl`, `session_index.jsonl`
+- Codex history: `sessions/`, `archived_sessions/`, `history.jsonl`, `session_index.jsonl`
 - Codex context: `memories/`, `automations/`, `AGENTS.md`, `rules/`, `policy/`, `skills/`
 - Claude Code: `projects/`, `history.jsonl`, `todos/`
 
-## What It Excludes
+## What Stays Local
 
-By default, `codex-mover` excludes machine- and account-local state:
+By default, `codex-mover` excludes machine-local and account-local state:
 
 - Codex: `auth.json`, `config.toml`, caches, logs, sqlite state, shell snapshots, temp files, vendor imports, worktrees
 - Claude Code: backups, caches, debug logs, plugins, `settings.json`, shell snapshots, stats caches
 
 ## Merge Behavior
 
-- JSONL history files are merged by unique line content. Session JSONL files prefer the imported copy when both sides identify the same session.
-- Claude project roots can be rewritten with `--path-map`, which updates both file paths and stored `cwd` and `project` references.
-- Non-appendable conflicting files are preserved as `*.imported-<bundle>` siblings instead of overwriting local data.
+- JSONL history files are merged by unique line content.
+- Session JSONL files prefer the imported copy when both sides identify the same session.
+- `--path-map` rewrites Claude project paths and stored `cwd` and `project` references during merge.
+- Conflicting non-appendable files are preserved as `*.imported-<bundle>` siblings instead of overwriting local data.
 
 ## Development
 
 ```bash
-cd /Users/tony/dev/codex-mover
 bun install
 bun test
 bun run typecheck

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@propel-code/codex-mover",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Package and merge portable Codex and Claude Code history/context between machines.",
   "type": "module",
   "packageManager": "bun@1.3.9",
@@ -11,8 +11,8 @@
     "package.json"
   ],
   "bin": {
-    "codex-mover": "./dist/bin.js",
-    "codeport": "./dist/bin.js"
+    "codex-mover": "dist/bin.js",
+    "codeport": "dist/bin.js"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",