harness-exchange 0.1.0__tar.gz

harness_exchange-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SessionExchange
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

harness_exchange-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: harness-exchange
+Version: 0.1.0
+Summary: Exchange agent/chat sessions between codex, opencode, and claude-code
+Author: harness-exchange contributors
+License: MIT
+Project-URL: Source, https://github.com/cnmoro/harness-exchange
+Project-URL: Tracker, https://github.com/cnmoro/harness-exchange/issues
+Keywords: codex,opencode,claude,harness,session,exchange,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: questionary>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# harness-exchange
+
+Exchange sessions between **codex**, **opencode**, and **claude-code**.
+
+Rate-limited on one tool but still have context you need? Port your session to another harness and keep going.
+
+```text
+harness-exchange --from codex --to opencode
+```
+
+## Installation
+
+```bash
+pip install harness-exchange
+```
+
+Requires Python 3.11+.
+
+## Usage
+
+### Interactive (arrow-key selection)
+
+```bash
+harness-exchange --from codex --to opencode
+```
+
+Lists the 15 most recent sessions from the source harness, each with a preview of the first and last message. Use arrow keys to select, Enter to transfer.
+
+### Non-interactive (session ID)
+
+```bash
+harness-exchange --from claude --to codex --session-id <session-uuid>
+```
+
+Combine with `--non-interactive` for scripting:
+
+```bash
+harness-exchange --from codex --to opencode --session-id <id> --non-interactive
+```
+
+### All combinations
+
+| From | To |
+|------|----|
+| `codex` | `opencode` |
+| `codex` | `claude` |
+| `opencode` | `codex` |
+| `opencode` | `claude` |
+| `claude` | `codex` |
+| `claude` | `opencode` |
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--from` | Source harness (`codex`, `opencode`, `claude`) |
+| `--to` | Target harness (`codex`, `opencode`, `claude`) |
+| `--session-id` | Transfer a specific session by ID (skips selection) |
+| `--limit` | Number of recent sessions to show (default: 15) |
+| `--non-interactive` | Skip interactive prompts (requires `--session-id`) |
+
+## Storage locations
+
+Each tool stores sessions in a different format:
+
+| Tool | Format | Location |
+|------|--------|----------|
+| **codex** | JSONL rollouts | `~/.codex/sessions/YYYY/MM/DD/*.jsonl` |
+| **opencode** | SQLite | `~/.local/share/opencode/opencode.db` |
+| **claude-code** | JSONL transcript | `~/.claude/projects/<cwd>/<sessionId>.jsonl` (+ `sessions/<pid>.json` and `history.jsonl`) |
+
+The tool detects these paths automatically (uses `$HOME`). Writing to opencode
+uses opencode's own `import` command so the schema stays valid; writing to
+claude-code produces a real `projects/` transcript so the session is resumable
+with `claude --resume`.
+
+## What gets transferred
+
+- All conversation messages, with **user and assistant roles preserved**
+- Tool calls and their outputs (where the target format supports them)
+- Session title, working directory (`cwd`), and timestamps
+- Agent and model information (where available)
+
+Codex injects system prompts and context (`AGENTS.md`, `<environment_context>`,
+permissions/personality specs) as hidden turns; these are filtered out so only
+the real conversation is carried over.
+
+## How it works
+
+1. **Lists** the most recent sessions from the source harness (default: 15)
+2. **Shows** a preview of the first and last real user message for each session
+3. **Reads** the full session (metadata + all messages) from source storage
+4. **Writes** the session into the target harness's storage format
+
+The interactive selector uses `questionary` with a plain-text fallback if the library isn't available.
+
+## Development
+
+```bash
+git clone https://github.com/cnmoro/harness-exchange.git
+cd harness-exchange
+
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT

harness_exchange-0.1.0/README.md

@@ -0,0 +1,112 @@
+# harness-exchange
+
+Exchange sessions between **codex**, **opencode**, and **claude-code**.
+
+Rate-limited on one tool but still have context you need? Port your session to another harness and keep going.
+
+```text
+harness-exchange --from codex --to opencode
+```
+
+## Installation
+
+```bash
+pip install harness-exchange
+```
+
+Requires Python 3.11+.
+
+## Usage
+
+### Interactive (arrow-key selection)
+
+```bash
+harness-exchange --from codex --to opencode
+```
+
+Lists the 15 most recent sessions from the source harness, each with a preview of the first and last message. Use arrow keys to select, Enter to transfer.
+
+### Non-interactive (session ID)
+
+```bash
+harness-exchange --from claude --to codex --session-id <session-uuid>
+```
+
+Combine with `--non-interactive` for scripting:
+
+```bash
+harness-exchange --from codex --to opencode --session-id <id> --non-interactive
+```
+
+### All combinations
+
+| From | To |
+|------|----|
+| `codex` | `opencode` |
+| `codex` | `claude` |
+| `opencode` | `codex` |
+| `opencode` | `claude` |
+| `claude` | `codex` |
+| `claude` | `opencode` |
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--from` | Source harness (`codex`, `opencode`, `claude`) |
+| `--to` | Target harness (`codex`, `opencode`, `claude`) |
+| `--session-id` | Transfer a specific session by ID (skips selection) |
+| `--limit` | Number of recent sessions to show (default: 15) |
+| `--non-interactive` | Skip interactive prompts (requires `--session-id`) |
+
+## Storage locations
+
+Each tool stores sessions in a different format:
+
+| Tool | Format | Location |
+|------|--------|----------|
+| **codex** | JSONL rollouts | `~/.codex/sessions/YYYY/MM/DD/*.jsonl` |
+| **opencode** | SQLite | `~/.local/share/opencode/opencode.db` |
+| **claude-code** | JSONL transcript | `~/.claude/projects/<cwd>/<sessionId>.jsonl` (+ `sessions/<pid>.json` and `history.jsonl`) |
+
+The tool detects these paths automatically (uses `$HOME`). Writing to opencode
+uses opencode's own `import` command so the schema stays valid; writing to
+claude-code produces a real `projects/` transcript so the session is resumable
+with `claude --resume`.
+
+## What gets transferred
+
+- All conversation messages, with **user and assistant roles preserved**
+- Tool calls and their outputs (where the target format supports them)
+- Session title, working directory (`cwd`), and timestamps
+- Agent and model information (where available)
+
+Codex injects system prompts and context (`AGENTS.md`, `<environment_context>`,
+permissions/personality specs) as hidden turns; these are filtered out so only
+the real conversation is carried over.
+
+## How it works
+
+1. **Lists** the most recent sessions from the source harness (default: 15)
+2. **Shows** a preview of the first and last real user message for each session
+3. **Reads** the full session (metadata + all messages) from source storage
+4. **Writes** the session into the target harness's storage format
+
+The interactive selector uses `questionary` with a plain-text fallback if the library isn't available.
+
+## Development
+
+```bash
+git clone https://github.com/cnmoro/harness-exchange.git
+cd harness-exchange
+
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT

harness_exchange-0.1.0/harness_exchange.egg-info/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: harness-exchange
+Version: 0.1.0
+Summary: Exchange agent/chat sessions between codex, opencode, and claude-code
+Author: harness-exchange contributors
+License: MIT
+Project-URL: Source, https://github.com/cnmoro/harness-exchange
+Project-URL: Tracker, https://github.com/cnmoro/harness-exchange/issues
+Keywords: codex,opencode,claude,harness,session,exchange,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: questionary>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# harness-exchange
+
+Exchange sessions between **codex**, **opencode**, and **claude-code**.
+
+Rate-limited on one tool but still have context you need? Port your session to another harness and keep going.
+
+```text
+harness-exchange --from codex --to opencode
+```
+
+## Installation
+
+```bash
+pip install harness-exchange
+```
+
+Requires Python 3.11+.
+
+## Usage
+
+### Interactive (arrow-key selection)
+
+```bash
+harness-exchange --from codex --to opencode
+```
+
+Lists the 15 most recent sessions from the source harness, each with a preview of the first and last message. Use arrow keys to select, Enter to transfer.
+
+### Non-interactive (session ID)
+
+```bash
+harness-exchange --from claude --to codex --session-id <session-uuid>
+```
+
+Combine with `--non-interactive` for scripting:
+
+```bash
+harness-exchange --from codex --to opencode --session-id <id> --non-interactive
+```
+
+### All combinations
+
+| From | To |
+|------|----|
+| `codex` | `opencode` |
+| `codex` | `claude` |
+| `opencode` | `codex` |
+| `opencode` | `claude` |
+| `claude` | `codex` |
+| `claude` | `opencode` |
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--from` | Source harness (`codex`, `opencode`, `claude`) |
+| `--to` | Target harness (`codex`, `opencode`, `claude`) |
+| `--session-id` | Transfer a specific session by ID (skips selection) |
+| `--limit` | Number of recent sessions to show (default: 15) |
+| `--non-interactive` | Skip interactive prompts (requires `--session-id`) |
+
+## Storage locations
+
+Each tool stores sessions in a different format:
+
+| Tool | Format | Location |
+|------|--------|----------|
+| **codex** | JSONL rollouts | `~/.codex/sessions/YYYY/MM/DD/*.jsonl` |
+| **opencode** | SQLite | `~/.local/share/opencode/opencode.db` |
+| **claude-code** | JSONL transcript | `~/.claude/projects/<cwd>/<sessionId>.jsonl` (+ `sessions/<pid>.json` and `history.jsonl`) |
+
+The tool detects these paths automatically (uses `$HOME`). Writing to opencode
+uses opencode's own `import` command so the schema stays valid; writing to
+claude-code produces a real `projects/` transcript so the session is resumable
+with `claude --resume`.
+
+## What gets transferred
+
+- All conversation messages, with **user and assistant roles preserved**
+- Tool calls and their outputs (where the target format supports them)
+- Session title, working directory (`cwd`), and timestamps
+- Agent and model information (where available)
+
+Codex injects system prompts and context (`AGENTS.md`, `<environment_context>`,
+permissions/personality specs) as hidden turns; these are filtered out so only
+the real conversation is carried over.
+
+## How it works
+
+1. **Lists** the most recent sessions from the source harness (default: 15)
+2. **Shows** a preview of the first and last real user message for each session
+3. **Reads** the full session (metadata + all messages) from source storage
+4. **Writes** the session into the target harness's storage format
+
+The interactive selector uses `questionary` with a plain-text fallback if the library isn't available.
+
+## Development
+
+```bash
+git clone https://github.com/cnmoro/harness-exchange.git
+cd harness-exchange
+
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT

harness_exchange-0.1.0/harness_exchange.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+LICENSE
+README.md
+pyproject.toml
+harness_exchange.egg-info/PKG-INFO
+harness_exchange.egg-info/SOURCES.txt
+harness_exchange.egg-info/dependency_links.txt
+harness_exchange.egg-info/entry_points.txt
+harness_exchange.egg-info/requires.txt
+harness_exchange.egg-info/top_level.txt
+harnessexchange/__init__.py
+harnessexchange/__main__.py
+harnessexchange/models.py
+harnessexchange/ui.py
+harnessexchange/harness/__init__.py
+harnessexchange/harness/base.py
+harnessexchange/harness/claude.py
+harnessexchange/harness/codex.py
+harnessexchange/harness/opencode.py
+tests/test_cli.py
+tests/test_harness_claude.py
+tests/test_harness_codex.py
+tests/test_harness_opencode.py
+tests/test_integration.py

harness_exchange-0.1.0/harness_exchange.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

harness_exchange-0.1.0/harness_exchange.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+harness-exchange = harnessexchange.__main__:main

harness_exchange-0.1.0/harness_exchange.egg-info/requires.txt

@@ -0,0 +1,6 @@
+questionary>=2.0
+
+[dev]
+pytest>=8
+build>=1.0
+twine>=5.0

harness_exchange-0.1.0/harness_exchange.egg-info/top_level.txt

@@ -0,0 +1 @@
+harnessexchange

harness_exchange-0.1.0/harnessexchange/__main__.py

@@ -0,0 +1,85 @@
+import argparse
+import sys
+
+from harnessexchange import ui
+from harnessexchange.harness import get_harness, HARNESS_MAP
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Exchange sessions between codex, opencode, and claude-code"
+    )
+    parser.add_argument(
+        "--from",
+        dest="from_",
+        required=True,
+        choices=list(HARNESS_MAP.keys()),
+        help="Source harness",
+    )
+    parser.add_argument(
+        "--to",
+        required=True,
+        choices=list(HARNESS_MAP.keys()),
+        help="Target harness",
+    )
+    parser.add_argument(
+        "--session-id",
+        help="Session ID to exchange (skip interactive selection)",
+    )
+    parser.add_argument(
+        "--limit",
+        type=int,
+        default=15,
+        help="Number of recent sessions to show (default: 15)",
+    )
+    parser.add_argument(
+        "--non-interactive",
+        action="store_true",
+        help="Skip interactive selection (requires --session-id)",
+    )
+
+    args = parser.parse_args()
+
+    if args.non_interactive and not args.session_id:
+        parser.error("--non-interactive requires --session-id")
+
+    if args.from_ == args.to:
+        print(f"Source and target are the same: {args.from_}. Nothing to do.")
+        sys.exit(0)
+
+    source = get_harness(args.from_)
+    target = get_harness(args.to)
+
+    if args.session_id:
+        result = source.read_session(args.session_id)
+        if result is None:
+            print(f"Session '{args.session_id}' not found in {args.from_}.", file=sys.stderr)
+            sys.exit(1)
+        session, messages = result
+    elif args.non_interactive:
+        print("Session not found.", file=sys.stderr)
+        sys.exit(1)
+    else:
+        sessions = source.list_sessions(limit=args.limit)
+        if not sessions:
+            print(f"No sessions found in {args.from_}.", file=sys.stderr)
+            sys.exit(1)
+
+        selected = ui.interactive_select(sessions, source.name)
+        if selected is None:
+            print("No session selected.", file=sys.stderr)
+            sys.exit(1)
+
+        result = source.read_session(selected.id)
+        if result is None:
+            print(f"Failed to read session '{selected.id}'.", file=sys.stderr)
+            sys.exit(1)
+        session, messages = result
+
+    target.write_session(session, messages)
+    print(f"Session '{session.title}' transferred from {args.from_} to {args.to}.")
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

harness_exchange-0.1.0/harnessexchange/harness/__init__.py

@@ -0,0 +1,17 @@
+from harnessexchange.harness.base import Harness
+from harnessexchange.harness.codex import CodexHarness
+from harnessexchange.harness.claude import ClaudeHarness
+from harnessexchange.harness.opencode import OpenCodeHarness
+
+HARNESS_MAP: dict[str, type[Harness]] = {
+    "codex": CodexHarness,
+    "claude": ClaudeHarness,
+    "opencode": OpenCodeHarness,
+}
+
+def get_harness(name: str) -> Harness:
+    cls = HARNESS_MAP.get(name.lower())
+    if cls is None:
+        valid = ", ".join(HARNESS_MAP)
+        raise ValueError(f"Unknown harness '{name}'. Valid: {valid}")
+    return cls()

harness_exchange-0.1.0/harnessexchange/harness/base.py

@@ -0,0 +1,29 @@
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import Optional
+
+from harnessexchange.models import Message, Session
+
+
+class Harness(ABC):
+    @property
+    @abstractmethod
+    def name(self) -> str:
+        ...
+
+    @property
+    @abstractmethod
+    def session_dir(self) -> Path:
+        ...
+
+    @abstractmethod
+    def list_sessions(self, limit: int = 15) -> list[Session]:
+        ...
+
+    @abstractmethod
+    def read_session(self, session_id: str) -> Optional[tuple[Session, list[Message]]]:
+        ...
+
+    @abstractmethod
+    def write_session(self, session: Session, messages: list[Message]) -> str:
+        ...