context-forge-cli 0.1.0__tar.gz → 0.2.1__tar.gz

{context_forge_cli-0.1.0 → context_forge_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: context-forge-cli
-Version: 0.1.0
+Version: 0.2.1
 Summary: Session manager and context bridge for agentic CLI tools
 Project-URL: Homepage, https://github.com/emmver/contextforge
 Project-URL: Repository, https://github.com/emmver/contextforge
@@ -30,14 +30,14 @@ Description-Content-Type: text/markdown
 
 **Session manager and context bridge for agentic CLI tools.**
 
-ContextForge (`cf`) tracks sessions from Claude Code, Codex, altimate-code, and other
+ContextForge (`cf`) tracks sessions from Claude Code, Claude Desktop, Codex, Gemini, altimate-code, and other
 agentic CLI tools. It generates plain-English summaries of each session and can compact
 and transfer context from one or more sessions into a new session — within the same tool
 or across different tools.
 
 ## What it does
 
-- **Discovers sessions** from Claude Code (`~/.claude/projects/`), Codex (`~/.codex/state_5.sqlite`), and altimate-code (`~/.local/share/altimate-code/`)
+- **Discovers sessions** from Claude Code (`~/.claude/projects/`), Claude Desktop, Codex (`~/.codex/state_5.sqlite`), Gemini (`~/.gemini/tmp/<project_hash>/chats/`), and altimate-code (`~/.local/share/altimate-code/`)
 - **Generates summaries** of what each session accomplished (with optional Claude API integration)
 - **Compacts context** intelligently, reducing multi-turn conversations to a token-efficient ContextBundle
 - **Transfers context** across tools and sessions (Claude Code → Codex, Codex → altimate-code, etc.)
@@ -47,7 +47,7 @@ or across different tools.
 
 - **Python 3.13+** (ContextForge requires Python 3.13 or later)
 - **uv** or **pipx** (for installation as a tool)
-- At least one of: Claude Code, Codex, or altimate-code installed and with session history
+- At least one of: Claude Code, Claude Desktop, Codex, Gemini, or altimate-code installed and with session history
 
 ## Install
 
@@ -167,6 +167,7 @@ The method is chosen automatically based on token count and whether a target ses
 | Claude Code (CLI) | `~/.claude/projects/` JSONL | `--system-prompt` / `--resume` |
 | Claude Desktop | `~/Library/Application Support/Claude/local-agent-mode-sessions/` | `--system-prompt` |
 | Codex | `~/.codex/state_5.sqlite` | `resume` / `fork` |
+| Gemini | `~/.gemini/tmp/<project_hash>/chats/` JSON | New session / `/resume` |
 | altimate-code | `~/.local/share/altimate-code/opencode.db` | `run -s` / `import` |
 
 ## Session Summaries
@@ -261,7 +262,7 @@ A full-screen Textual dashboard with live session browsing, filtering, and analy
 │                          │ Worked on UTASTAR ensemble      │
 │                          │ pruning framework...            │
 └──────────────────────────┴─────────────────────────────────┘
- Sessions — CC:12 │ Codex:4 │ Alt:3 │ Total:19 │ 129M tok   14:32:01
+ Sessions — CC:12 │ Codex:4 │ Gemini:2 │ Alt:3 │ Total:21 │ 129M tok   14:32:01
 ```
 
 ### Key bindings
@@ -298,7 +299,7 @@ Press `/` to open the filter bar above the session list:
 ### Transfer modal (`t`)
 
 Press `t` on any session to open the transfer panel. Choose:
-- **Target tool** — Claude Code, Codex, or altimate-code
+- **Target tool** — Claude Code, Claude Desktop, Codex, Gemini, or altimate-code
 - **Strategy** — `summary_only`, `key_messages`, or `full_recent`
 - **Preview** — shows the exact shell command (no side effects)
 - **Execute** — builds the bundle and launches the target tool

{context_forge_cli-0.1.0 → context_forge_cli-0.2.1}/README.md

@@ -2,14 +2,14 @@
 
 **Session manager and context bridge for agentic CLI tools.**
 
-ContextForge (`cf`) tracks sessions from Claude Code, Codex, altimate-code, and other
+ContextForge (`cf`) tracks sessions from Claude Code, Claude Desktop, Codex, Gemini, altimate-code, and other
 agentic CLI tools. It generates plain-English summaries of each session and can compact
 and transfer context from one or more sessions into a new session — within the same tool
 or across different tools.
 
 ## What it does
 
-- **Discovers sessions** from Claude Code (`~/.claude/projects/`), Codex (`~/.codex/state_5.sqlite`), and altimate-code (`~/.local/share/altimate-code/`)
+- **Discovers sessions** from Claude Code (`~/.claude/projects/`), Claude Desktop, Codex (`~/.codex/state_5.sqlite`), Gemini (`~/.gemini/tmp/<project_hash>/chats/`), and altimate-code (`~/.local/share/altimate-code/`)
 - **Generates summaries** of what each session accomplished (with optional Claude API integration)
 - **Compacts context** intelligently, reducing multi-turn conversations to a token-efficient ContextBundle
 - **Transfers context** across tools and sessions (Claude Code → Codex, Codex → altimate-code, etc.)
@@ -19,7 +19,7 @@ or across different tools.
 
 - **Python 3.13+** (ContextForge requires Python 3.13 or later)
 - **uv** or **pipx** (for installation as a tool)
-- At least one of: Claude Code, Codex, or altimate-code installed and with session history
+- At least one of: Claude Code, Claude Desktop, Codex, Gemini, or altimate-code installed and with session history
 
 ## Install
 
@@ -139,6 +139,7 @@ The method is chosen automatically based on token count and whether a target ses
 | Claude Code (CLI) | `~/.claude/projects/` JSONL | `--system-prompt` / `--resume` |
 | Claude Desktop | `~/Library/Application Support/Claude/local-agent-mode-sessions/` | `--system-prompt` |
 | Codex | `~/.codex/state_5.sqlite` | `resume` / `fork` |
+| Gemini | `~/.gemini/tmp/<project_hash>/chats/` JSON | New session / `/resume` |
 | altimate-code | `~/.local/share/altimate-code/opencode.db` | `run -s` / `import` |
 
 ## Session Summaries
@@ -233,7 +234,7 @@ A full-screen Textual dashboard with live session browsing, filtering, and analy
 │                          │ Worked on UTASTAR ensemble      │
 │                          │ pruning framework...            │
 └──────────────────────────┴─────────────────────────────────┘
- Sessions — CC:12 │ Codex:4 │ Alt:3 │ Total:19 │ 129M tok   14:32:01
+ Sessions — CC:12 │ Codex:4 │ Gemini:2 │ Alt:3 │ Total:21 │ 129M tok   14:32:01
 ```
 
 ### Key bindings
@@ -270,7 +271,7 @@ Press `/` to open the filter bar above the session list:
 ### Transfer modal (`t`)
 
 Press `t` on any session to open the transfer panel. Choose:
-- **Target tool** — Claude Code, Codex, or altimate-code
+- **Target tool** — Claude Code, Claude Desktop, Codex, Gemini, or altimate-code
 - **Strategy** — `summary_only`, `key_messages`, or `full_recent`
 - **Preview** — shows the exact shell command (no side effects)
 - **Execute** — builds the bundle and launches the target tool

context_forge_cli-0.2.1/contextforge/adapters/gemini.py

@@ -0,0 +1,188 @@
+"""Adapter for Google Gemini CLI sessions."""
+from __future__ import annotations
+
+import json
+import shlex
+from datetime import datetime, timezone
+from pathlib import Path
+
+from contextforge.adapters.base import ToolAdapter
+from contextforge.models.session import Message, Session
+
+_GEMINI_TMP_BASE = Path.home() / ".gemini" / "tmp"
+
+
+class GeminiAdapter(ToolAdapter):
+    tool_name = "gemini"
+    default_paths = [_GEMINI_TMP_BASE]
+
+    def discover_sessions(self) -> list[Session]:
+        """Discover Gemini sessions from ~/.gemini/tmp/<project_hash>/chats/."""
+        sessions: list[Session] = []
+
+        if not _GEMINI_TMP_BASE.exists():
+            return sessions
+
+        # Scan all project hash directories
+        for project_dir in _GEMINI_TMP_BASE.iterdir():
+            if not project_dir.is_dir():
+                continue
+
+            chats_dir = project_dir / "chats"
+            if not chats_dir.exists():
+                continue
+
+            # Scan for session JSON files in format: session-<timestamp>-<hash>.json
+            for session_file in sorted(chats_dir.glob("session-*.json")):
+                try:
+                    with session_file.open() as f:
+                        data = json.load(f)
+                except (json.JSONDecodeError, OSError):
+                    continue
+
+                session_id = data.get("sessionId")
+                if not session_id:
+                    continue
+
+                # Extract timestamps
+                start_time_str = data.get("startTime")
+                last_updated_str = data.get("lastUpdated")
+
+                created_at = None
+                updated_at = None
+
+                if start_time_str:
+                    try:
+                        created_at = datetime.fromisoformat(
+                            start_time_str.replace("Z", "+00:00")
+                        )
+                    except (ValueError, AttributeError):
+                        pass
+
+                if last_updated_str:
+                    try:
+                        updated_at = datetime.fromisoformat(
+                            last_updated_str.replace("Z", "+00:00")
+                        )
+                    except (ValueError, AttributeError):
+                        pass
+
+                if created_at is None:
+                    created_at = datetime.now(timezone.utc)
+                if updated_at is None:
+                    updated_at = created_at
+
+                # Extract title from first user message
+                title = None
+                messages = data.get("messages", [])
+                for msg in messages:
+                    if msg.get("type") == "user":
+                        content = msg.get("content", [])
+                        if isinstance(content, list) and content:
+                            text = content[0].get("text", "")
+                            if text:
+                                title = text[:100]
+                                break
+
+                sessions.append(
+                    Session(
+                        id=session_id,
+                        tool=self.tool_name,
+                        title=title,
+                        cwd=None,
+                        created_at=created_at,
+                        updated_at=updated_at,
+                        raw_path=str(session_file),
+                        status="unknown",
+                    )
+                )
+
+        return sessions
+
+    def load_messages(self, session_id: str) -> list[Message]:
+        """Load messages for a given session ID by scanning all projects."""
+        if not _GEMINI_TMP_BASE.exists():
+            return []
+
+        # Brute-force search across all projects to find the session
+        for project_dir in _GEMINI_TMP_BASE.iterdir():
+            if not project_dir.is_dir():
+                continue
+
+            chats_dir = project_dir / "chats"
+            if not chats_dir.exists():
+                continue
+
+            for session_file in chats_dir.glob("session-*.json"):
+                try:
+                    with session_file.open() as f:
+                        data = json.load(f)
+                except (json.JSONDecodeError, OSError):
+                    continue
+
+                if data.get("sessionId") == session_id:
+                    return self._parse_session_data(data)
+
+        return []
+
+    def _parse_session_data(self, data: dict) -> list[Message]:
+        """Parse Gemini session JSON object into Message list."""
+        messages: list[Message] = []
+
+        for msg in data.get("messages", []):
+            msg_type = msg.get("type", "")
+            if msg_type not in ("user", "gemini"):
+                continue
+
+            # Extract content
+            content_raw = msg.get("content", "")
+            if isinstance(content_raw, list):
+                # User messages: content is list of {text: ...}
+                parts = []
+                for item in content_raw:
+                    if isinstance(item, dict) and "text" in item:
+                        parts.append(item["text"])
+                content = " ".join(parts)
+            else:
+                # Gemini messages: content is a string
+                content = str(content_raw)
+
+            if not content or not content.strip():
+                continue
+
+            ts_str = msg.get("timestamp")
+            ts = None
+            if ts_str:
+                try:
+                    ts = datetime.fromisoformat(ts_str.replace("Z", "+00:00"))
+                except (ValueError, AttributeError):
+                    pass
+
+            messages.append(
+                Message(
+                    role="user" if msg_type == "user" else "assistant",
+                    content=content,
+                    timestamp=ts,
+                )
+            )
+
+        return messages
+
+    def build_inject_command(
+        self,
+        context: str,
+        target_session_id: str | None = None,
+        cwd: str | None = None,
+        method: str = "system_prompt",
+    ) -> str:
+        """Build a shell command to start/resume a Gemini session with context."""
+        safe_ctx = shlex.quote(context)
+
+        if method == "resume" and target_session_id:
+            return f"gemini /resume {target_session_id}"
+
+        # Default: new session with context injected via system prompt
+        cmd = f"gemini {safe_ctx}"
+        if cwd:
+            cmd = f"cd {shlex.quote(cwd)} && {cmd}"
+        return cmd

{context_forge_cli-0.1.0 → context_forge_cli-0.2.1}/contextforge/adapters/registry.py

@@ -6,12 +6,14 @@ from contextforge.adapters.base import ToolAdapter
 from contextforge.adapters.claude_code import ClaudeCodeAdapter
 from contextforge.adapters.claude_desktop import ClaudeDesktopAdapter
 from contextforge.adapters.codex import CodexAdapter
+from contextforge.adapters.gemini import GeminiAdapter
 
 ADAPTERS: dict[str, type[ToolAdapter]] = {
     "claude_code": ClaudeCodeAdapter,
     "claude_desktop": ClaudeDesktopAdapter,
     "codex": CodexAdapter,
     "altimate_code": AltimateCodeAdapter,
+    "gemini": GeminiAdapter,
 }
 
 

{context_forge_cli-0.1.0 → context_forge_cli-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "context-forge-cli"
-version = "0.1.0"
+version = "0.2.1"
 description = "Session manager and context bridge for agentic CLI tools"
 readme = "README.md"
 license = { text = "MIT" }