v0.5.0

What's Changed

Interactive CLI (gh-shaped, stdlib only)

• Hybrid invocation: flags always win; missing pieces prompt on a TTY
• Bare hc: convert wizard (from → session → to → preview → confirm write)
• hc list on a TTY: arrow/jk (or numbered) pick a session, then convert
• -y / --yes: write without asking
• --no-interactive and HC_NO_INTERACTIVE=1: force scriptable path
• Pipes stay plain tables (no prompts)
• Still zero runtime dependencies (termios pickers on macOS/Linux)

Docs

• README and landing updated for the interactive flow
• Changelog entry for 0.5.0

Install / upgrade

pipx upgrade harness-convert
# or:
pipx install harness-convert

npm i -g @theharshitsingh/hc
brew upgrade harness-convert   # after tap updates

Examples

hc                                 # wizard
hc list --from claude -n 5         # pick → convert
hc --from claude --to grok         # preview; confirm on TTY
hc --from claude --to grok -y      # write now
hc list --from claude | cat        # plain table

Full Changelog: v0.4.0...v0.5.0

v0.4.0

What's Changed

Grok Build adapter (full R/W)

• New --from grok / --to grok harness against ~/.grok/sessions (or $GROK_HOME)
• Reads chat_history.jsonl + summary.json; writes summary.json, chat_history.jsonl, and updates.jsonl so resume works natively
• Resume hint: grok --resume <id>
• Non-UUID source ids map to a deterministic UUID (safe re-runs)
• Title enrichment to/from Claude, Codex, OpenCode, and Cursor
• Format notes: docs/grok-format.md

Multi-session list

• hc list --from <harness> -n 5 shows the newest N sessions for the cwd
• Default is 10; output is id, UTC time, and title (when available)
• Implemented for Claude, Codex, OpenCode, Grok, and Cursor

Other

• Landing page and README updated for Grok + Cursor (source-only) + list -n
• Hermetic tests for Grok write/round-trip/locate and multi-session list

Install

pipx install harness-convert
# or upgrade:
pipx upgrade harness-convert

npm i -g @theharshitsingh/hc
brew install harshitsinghbhandari/tap/harness-convert

Examples

hc list --from claude -n 5
hc --from claude --to grok --write
hc --from grok --to codex <session-id> --write

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Full Changelog: v0.2.2...v0.3.0

v0.2.2

Full Changelog: v0.2.1...v0.2.2

v0.2.1

Full Changelog: v0.2.0...v0.2.1

v0.2.0

harness-convert 0.2.0.

• OpenCode as a third harness: convert any direction between Codex, Claude Code, and OpenCode. Converting into OpenCode writes a canonical import file; resume with opencode import <file> && opencode -s <id>.
• npm distribution (Node shim over the stdlib-only Python core) and a Homebrew formula (brew install harshitsinghbhandari/tap/harness-convert).
• Landing page at https://hc.theharshitsingh.com.

v0.1.0

First release of harness-convert (hc): Codex ↔ Claude Code session conversion, native resume, rendered scrollback with tool cards, title transfer, and ragged-tail handling.