contexthop 0.1.0__py3-none-any.whl

context_hop.py

@@ -0,0 +1,118 @@
+#!/usr/bin/env python3
+"""
+ContextHop - Carry an AI chat to any other model without starting over.
+
+Usage:
+    python context_hop.py sample_chat.txt
+    python context_hop.py sample_chat.txt -o HANDOFF.md
+    python context_hop.py sample_chat.txt --goal "Build a resume website"
+
+Input: a plain .txt / .md chat transcript. Works best if lines start with
+       "User:" / "You:" / "Assistant:" / "ChatGPT:" / "Claude:" / "Gemini:"
+       If no labels are found, the whole file is treated as raw transcript.
+
+Output: a HANDOFF.md file containing
+  1. A ready-to-paste starter prompt for the NEW model
+  2. A structured context section (goal, transcript cleaned up)
+  3. The full original transcript (so nothing is lost)
+
+No API key. No internet. 100% local.
+"""
+import argparse
+import re
+import sys
+from datetime import date
+from pathlib import Path
+
+SPEAKERS = r"(User|You|Human|Assistant|ChatGPT|Claude|Gemini|DeepSeek|Perplexity|AI)"
+LINE_RE = re.compile(rf"^\s*{SPEAKERS}\s*:\s*", re.IGNORECASE)
+
+
+def parse_transcript(text: str):
+    """Split a transcript into (speaker, message) turns."""
+    turns = []
+    current_speaker, current_lines = None, []
+    for line in text.splitlines():
+        m = LINE_RE.match(line)
+        if m:
+            if current_speaker is not None:
+                turns.append((current_speaker, "\n".join(current_lines).strip()))
+            current_speaker = m.group(1).title()
+            current_lines = [line[m.end():]]
+        else:
+            if current_speaker is None:
+                current_speaker, current_lines = "User", []
+            current_lines.append(line)
+    if current_speaker is not None and current_lines:
+        turns.append((current_speaker, "\n".join(current_lines).strip()))
+    return [(s, msg) for s, msg in turns if msg]
+
+
+def first_user_goal(turns):
+    for speaker, msg in turns:
+        if speaker.lower() in ("user", "you", "human"):
+            first_line = msg.strip().splitlines()[0].strip()
+            return (first_line[:180] + "...") if len(first_line) > 180 else first_line
+    return "Not detected - edit this line in HANDOFF.md"
+
+
+def build_handoff(turns, source_name: str, goal_override: str | None):
+    goal = goal_override or first_user_goal(turns)
+    today = date.today().isoformat()
+    clean = "\n\n".join(f"**{s}:** {msg}" for s, msg in turns)
+
+    return f"""# ContextHop Handoff
+*Created {today} from `{source_name}` - {len(turns)} messages*
+
+---
+
+## 1. Paste this first in the NEW model
+
+> You are continuing a conversation that started on another AI model.
+> Read the context below carefully. Do NOT restart the task and do NOT
+> re-ask questions that are already answered below.
+> First reply with: (1) a 3-line summary of where we are, (2) what you
+> think the next step is. Then wait for my instruction.
+
+## 2. Context
+
+**Original goal:** {goal}
+
+**Where we left off:** [EDIT ME - 1 line: what was just done / what broke]
+
+**Decisions already made:** [EDIT ME - or delete if none]
+
+**Next step I want:** [EDIT ME - what the new model should do first]
+
+## 3. Conversation so far
+
+{clean}
+
+---
+*Made with ContextHop - https://github.com/aryancodes-dev/contexthop*
+"""
+
+
+def main():
+    ap = argparse.ArgumentParser(description="Turn an AI chat transcript into a portable HANDOFF.md")
+    ap.add_argument("input", help="Transcript file (.txt or .md)")
+    ap.add_argument("-o", "--output", default="HANDOFF.md", help="Output file (default: HANDOFF.md)")
+    ap.add_argument("--goal", default=None, help="Override the detected goal line")
+    args = ap.parse_args()
+
+    src = Path(args.input)
+    if not src.exists():
+        sys.exit(f"File not found: {src}")
+
+    turns = parse_transcript(src.read_text(encoding="utf-8", errors="ignore"))
+    if not turns:
+        sys.exit("No messages found in that file.")
+
+    out = Path(args.output)
+    out.write_text(build_handoff(turns, src.name, args.goal), encoding="utf-8")
+    print(f"Done: {len(turns)} messages -> {out} ({out.stat().st_size} bytes)")
+    print("Next: open HANDOFF.md, fill the 3 [EDIT ME] lines, paste/upload it in the new model.")
+
+
+if __name__ == "__main__":
+    main()

contexthop-0.1.0.dist-info/METADATA

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: contexthop
+Version: 0.1.0
+Summary: Carry an AI chat to any other model without starting over — portable HANDOFF.md generator for ChatGPT, Claude & Gemini. No API key, no server.
+Author: Aryan Kumar Shah
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aryancodes-dev/contexthop
+Project-URL: Repository, https://github.com/aryancodes-dev/contexthop
+Keywords: ai,chatgpt,claude,gemini,llm,context,productivity,developer-tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ContextHop
+
+**Hit your limit on Claude? Continue the same work on ChatGPT, Gemini, or any other model - without explaining everything from the beginning.**
+
+ContextHop turns a finished (or interrupted) AI conversation into one portable `HANDOFF.md` file: a starter prompt for the new model + a clean, structured copy of your context. Paste it, and the new model picks up where the old one stopped.
+
+No API key. No account. No server. 100% local and free.
+
+## The problem
+
+You spend an hour building something with one AI. Then: *"You've reached your limit."*
+You open another model and waste 20 minutes re-explaining the goal, the decisions, the code, and what already failed.
+
+Your context should travel with **you**, not stay locked inside one app.
+
+## Two ways to use it
+
+### Way 1 - The Magic Prompt (zero install, works on mobile)
+
+Before your limit runs out, paste the prompt in [`prompts/magic_handoff_prompt.md`](prompts/magic_handoff_prompt.md) as your last message on the old model. It writes its own handoff summary. Paste that summary into the new model. Done.
+
+### Way 2 - The Python tool
+
+```bash
+git clone https://github.com/aryancodes-dev/contexthop.git
+cd contexthop
+python context_hop.py your_chat.txt
+# creates HANDOFF.md - fill the 3 [EDIT ME] lines, then paste/upload it in the new model
+```
+
+Works with transcripts exported or copied from ChatGPT, Claude, Gemini, DeepSeek and Perplexity (lines starting with `User:` / `Claude:` / etc.).
+
+Try the example:
+
+```bash
+python context_hop.py examples/sample_chat.txt
+```
+
+## Why not just copy-paste the whole chat?
+
+| | Full copy-paste | ContextHop handoff |
+|---|---|---|
+| Tokens on new model | 20,000+ | ~500-1,500 (Magic Prompt) |
+| New model understands state | Has to dig through chat | Goal / decisions / next step up top |
+| Works when limit already hit | Yes, but messy | Yes - transcript mode |
+
+## Roadmap
+
+- [x] v0.1 - Python CLI + Magic Prompt
+- [ ] v0.2 - Auto-detect ChatGPT / Claude JSON exports
+- [ ] v0.3 - Simple web page version (paste chat -> download HANDOFF.md)
+- [ ] v0.4 - Browser extension (one-click export)
+
+## Contributing
+
+Issues and PRs welcome. Especially: export parsers for new platforms, and translations of the Magic Prompt.
+
+## License
+
+MIT - see [LICENSE](LICENSE).

contexthop-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+context_hop.py,sha256=OWNFezSwZ1b6cqN5qcb_0hCVU7bmkikJBmoRoI1R8FM,4129
+contexthop-0.1.0.dist-info/licenses/LICENSE,sha256=DFcOAMEFO4h--sDOcdzv0PAecGnGzBKJEwL-FyfbNko,1073
+contexthop-0.1.0.dist-info/METADATA,sha256=IFt40vq3TnTJzIl4n8yca-MhXccMy5tdE95LxJevU1g,2979
+contexthop-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+contexthop-0.1.0.dist-info/entry_points.txt,sha256=RjrENKXT-Ap71hEtfWa90_ZENOQfhF_7jw_4WLNajQc,48
+contexthop-0.1.0.dist-info/top_level.txt,sha256=93KkM4El4bvVV0dmy3lijpRx2lmDgYZ8SuBjDmcq69I,12
+contexthop-0.1.0.dist-info/RECORD,,

contexthop-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

contexthop-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+contexthop = context_hop:main

contexthop-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aryan Kumar Shah
+
+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.

contexthop-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+context_hop