Skip to content

v0.1.0 — Public release

Latest
Latest

Choose a tag to compare

View all tags
@1beenlee 1beenlee released this 06 Jul 17:51
· 1 commit to main since this release
v0.1.0
536eae9

v0.1.0 — Public release

universal-context-handoff is a local-first CLI and assistant skill for moving AI coding session context between repositories and AI assistant environments.

This first public release focuses on a conservative, verifiable foundation: path-aware handoff metadata, Markdown handoff artifacts, multi-platform session extraction, assistant skill documentation, public-safe examples, and third-party attribution.

Highlights

  • Local-first context handoff workflow for AI coding sessions
  • CLI command: handoff
  • Path-aware source/target repository metadata
  • Handoff output under .handoffs/
  • Built-in support for Claude Code JSONL sessions
  • Built-in support for Codex CLI rollout-*.jsonl sessions
  • Experimental support for Antigravity legacy JSONL transcripts
  • Optional transfer of assistant skills/config/MCP-related local files
  • Markdown and JSON handoff artifacts
  • Assistant-facing SKILL.md and SKILL-ko.md
  • English and Korean README files
  • MIT license with third-party attribution notices

Support matrix

Platform / source Status Notes
Claude Code JSONL under ~/.claude/projects Supported Built-in parser extracts sessions
Codex CLI JSONL under ~/.codex/sessions Supported Built-in parser extracts rollout-*.jsonl sessions
Codex archived sessions under ~/.codex/archived_sessions Supported Built-in parser extracts archived rollout-*.jsonl sessions
Antigravity legacy JSONL transcript Experimental Extracts transcript JSONL logs under Antigravity brain paths
Antigravity IDE .db / .pb formats Not supported yet Planned / research needed
Claude.ai web Manual import only No local web transcript extraction
Claude Cowork Not supported yet / unknown No assumed local storage path

Privacy and safety

This tool is local-first and does not automatically upload generated handoff files to the cloud.

Conversation logs may contain API keys, credentials, private local paths, company information, customer data, or personal information. Built-in redaction is best-effort, not a guarantee. Always review generated Markdown, JSON, and ZIP artifacts before sharing or publishing them.

Verification

Before release, the following checks were run successfully:

  • pnpm build
  • pnpm typecheck
  • pnpm lint
  • pnpm test
  • pnpm pack --dry-run
  • node dist/cli.js --help
  • node dist/cli.js list

Not included in this release

  • npm publishing
  • Hosted service
  • Automatic cloud sync
  • Antigravity .db / .pb parsing
  • Claude.ai web transcript extraction
  • Claude Cowork support
  • Guaranteed secret removal

License

MIT. See LICENSE and THIRD_PARTY_NOTICES.md.

Assets 2
Loading