claudechic 0.2.2__py3-none-any.whl → 0.3.1__py3-none-any.whl

claudechic/__init__.py

@@ -1,5 +1,7 @@
 """Claude Chic - A stylish terminal UI for Claude Code."""
 
+from importlib.metadata import version
+
 from claudechic.app import ChatApp
 from claudechic.theme import CHIC_THEME
 from claudechic.protocols import AgentManagerObserver, AgentObserver, PermissionHandler
@@ -11,4 +13,4 @@ __all__ = [
     "AgentObserver",
     "PermissionHandler",
 ]
-__version__ = "0.1.0"
+__version__ = version("claudechic")

claudechic/__main__.py

@@ -1,6 +1,7 @@
 """Entry point for claudechic CLI."""
 
 import argparse
+import os
 from importlib.metadata import version
 
 from claudechic.app import ChatApp
@@ -24,6 +25,12 @@ def main():
     parser.add_argument(
         "--session", "-s", type=str, help="Resume a specific session ID"
     )
+    parser.add_argument(
+        "--remote-port",
+        type=int,
+        default=int(os.environ.get("CLAUDECHIC_REMOTE_PORT", "0")),
+        help="Start HTTP server for remote control on this port",
+    )
     parser.add_argument("prompt", nargs="*", help="Initial prompt to send")
     args = parser.parse_args()
 
@@ -42,7 +49,11 @@ def main():
     Console().control(Control.title(f"Claude Chic · {Path.cwd().name}"))
 
     try:
-        app = ChatApp(resume_session_id=resume_id, initial_prompt=initial_prompt)
+        app = ChatApp(
+            resume_session_id=resume_id,
+            initial_prompt=initial_prompt,
+            remote_port=args.remote_port,
+        )
         app.run()
     except (KeyboardInterrupt, SystemExit):
         pass

claudechic/agent.py

@@ -75,12 +75,22 @@ class ToolUse:
     is_error: bool = False
 
 
+@dataclass
+class TextBlock:
+    """A text block within an assistant turn."""
+
+    text: str
+
+
 @dataclass
 class AssistantContent:
-    """An assistant message in chat history."""
+    """An assistant message in chat history.
 
-    text: str = ""
-    tool_uses: list[ToolUse] = field(default_factory=list)
+    Contains an ordered list of blocks (TextBlock or ToolUse) to preserve
+    the original interleaving of text and tool uses.
+    """
+
+    blocks: list[TextBlock | ToolUse] = field(default_factory=list)
 
 
 @dataclass
@@ -159,6 +169,7 @@ class Agent:
         self.auto_approve_edits: bool = False
         self.session_allowed_tools: set[str] = set()  # Tools allowed for this session
         self._pending_followup: str | None = None  # Auto-send after current response
+        self.model: str | None = None  # Model override (None = SDK default)
 
         # Worktree finish state (for /worktree finish flow)
         self.finish_state: Any = None
@@ -173,6 +184,9 @@ class Agent:
         self.observer: AgentObserver | None = None
         self.permission_handler: PermissionHandler | None = None
 
+        # Background process tracking (PID of claude binary)
+        self._claude_pid: int | None = None
+
     # -----------------------------------------------------------------------
     # Lifecycle
     # -----------------------------------------------------------------------
@@ -194,6 +208,11 @@ class Agent:
         self.client = ClaudeSDKClient(options)
         await self.client.connect()
 
+        # Capture the claude process PID for background process tracking
+        from claudechic.processes import get_claude_pid_from_client
+
+        self._claude_pid = get_claude_pid_from_client(self.client)
+
         if resume:
             self.session_id = resume
 
@@ -217,7 +236,7 @@ class Agent:
                 pass
             self.client = None
 
-    async def load_history(self, limit: int = 50, cwd: Path | None = None) -> None:
+    async def load_history(self, cwd: Path | None = None) -> None:
         """Load message history from session file into self.messages.
 
         This populates Agent.messages from the persisted session,
@@ -225,7 +244,6 @@ class Agent:
         Call ChatView._render_full() after this to update UI.
 
         Args:
-            limit: Maximum number of messages to load
             cwd: Working directory for session lookup (defaults to self.cwd)
         """
         from claudechic.sessions import load_session_messages
@@ -234,9 +252,7 @@ class Agent:
             return
 
         self.messages.clear()
-        raw_messages = await load_session_messages(
-            self.session_id, limit=limit, cwd=cwd or self.cwd
-        )
+        raw_messages = await load_session_messages(self.session_id, cwd=cwd or self.cwd)
 
         current_assistant: AssistantContent | None = None
 
@@ -253,17 +269,15 @@ class Agent:
                     ChatItem(role="user", content=UserContent(text=m["content"]))
                 )
             elif m["type"] == "assistant":
-                # Start or continue assistant content
+                # Add text block to current assistant content (preserving order)
                 if current_assistant is None:
-                    current_assistant = AssistantContent(text=m["content"])
-                else:
-                    # Append to existing (shouldn't happen often with current parser)
-                    current_assistant.text += "\n" + m["content"]
+                    current_assistant = AssistantContent()
+                current_assistant.blocks.append(TextBlock(text=m["content"]))
             elif m["type"] == "tool_use":
-                # Add tool use to current assistant content
+                # Add tool use to current assistant content (preserving order)
                 if current_assistant is None:
                     current_assistant = AssistantContent()
-                current_assistant.tool_uses.append(
+                current_assistant.blocks.append(
                     ToolUse(
                         id=m.get("id", ""),
                         name=m["name"],
@@ -475,7 +489,8 @@ class Agent:
             )
 
         self._current_text_buffer += text
-        self._current_assistant.text = self._current_text_buffer
+        # Update the current TextBlock in-place for live streaming display
+        self._update_current_text_block()
         if self.observer:
             self.observer.on_message_updated(self)
             self.observer.on_text_chunk(self, text, new_message, parent_tool_use_id)
@@ -496,10 +511,24 @@ class Agent:
                     self._needs_new_message = False
                     self._handle_text_chunk(text, new_msg, parent_id)
 
+    def _update_current_text_block(self) -> None:
+        """Update the current TextBlock with accumulated text (for streaming)."""
+        if not self._current_assistant or not self._current_text_buffer:
+            return
+        # Find or create the trailing TextBlock
+        if self._current_assistant.blocks and isinstance(
+            self._current_assistant.blocks[-1], TextBlock
+        ):
+            self._current_assistant.blocks[-1].text = self._current_text_buffer
+        else:
+            self._current_assistant.blocks.append(
+                TextBlock(text=self._current_text_buffer)
+            )
+
     def _flush_current_text(self) -> None:
-        """Flush accumulated text to current assistant message."""
+        """Flush accumulated text to current assistant message and reset buffer."""
         if self._current_assistant and self._current_text_buffer:
-            self._current_assistant.text = self._current_text_buffer
+            self._update_current_text_block()
             self._current_text_buffer = ""
             if self.observer:
                 self.observer.on_message_updated(self)
@@ -544,7 +573,7 @@ class Agent:
             self.messages.append(
                 ChatItem(role="assistant", content=self._current_assistant)
             )
-        self._current_assistant.tool_uses.append(tool)
+        self._current_assistant.blocks.append(tool)
         if self.observer:
             self.observer.on_message_updated(self)
             self.observer.on_tool_use(self, tool)
@@ -710,3 +739,15 @@ class Agent:
             "message": {"role": "user", "content": content},
             "parent_tool_use_id": None,
         }
+
+    def get_background_processes(self) -> list:
+        """Get list of background processes for this agent.
+
+        Returns:
+            List of BackgroundProcess objects
+        """
+        if not self._claude_pid:
+            return []
+        from claudechic.processes import get_child_processes
+
+        return get_child_processes(self._claude_pid)

claudechic/agent_manager.py

@@ -115,6 +115,7 @@ class AgentManager:
         worktree: str | None = None,
         resume: str | None = None,
         switch_to: bool = True,
+        model: str | None = None,
     ) -> Agent:
         """Create and connect a new agent.
 
@@ -124,17 +125,21 @@ class AgentManager:
             worktree: Git worktree branch name if applicable
             resume: Session ID to resume
             switch_to: Whether to make this the active agent
+            model: Model override (None = SDK default)
 
         Returns:
             The created agent (connected and ready)
         """
         agent = Agent(name=name, cwd=cwd, worktree=worktree)
+        agent.model = model
 
         # Wire callbacks
         self._wire_agent_callbacks(agent)
 
         # Create options and connect
-        options = self._options_factory(cwd=cwd, resume=resume, agent_name=agent.name)
+        options = self._options_factory(
+            cwd=cwd, resume=resume, agent_name=agent.name, model=model
+        )
         await agent.connect(options, resume=resume)
 
         # Register agent
@@ -192,13 +197,14 @@ class AgentManager:
 
         name = agent.name
         was_active = agent_id == self.active_id
+        message_count = len(agent.messages)
 
         # Disconnect
         await agent.disconnect()
         log.info(f"Closed agent '{name}' (id={agent_id})")
 
         if self.manager_observer:
-            self.manager_observer.on_agent_closed(agent_id)
+            self.manager_observer.on_agent_closed(agent_id, message_count)
 
         # Switch to another agent if we closed the active one
         if was_active and self.agents:

claudechic/analytics.py

@@ -0,0 +1,62 @@
+"""PostHog analytics for claudechic - fire-and-forget event tracking."""
+
+import os
+import platform
+import shutil
+import uuid as uuid_mod
+from datetime import datetime, timezone
+
+import httpx
+
+from claudechic.config import get_analytics_enabled, get_analytics_id
+
+VERSION = "0.1.0"  # Keep in sync with __init__.py
+SESSION_ID = str(uuid_mod.uuid4())  # Unique per process
+
+POSTHOG_HOST = "https://us.i.posthog.com"
+POSTHOG_API_KEY = "phc_M0LMkbSaDsaXi5LeYE5A95Kz8hTHgsJ4POlqucehsse"
+
+
+async def capture(event: str, **properties: str | int | float | bool) -> None:
+    """Capture an analytics event to PostHog.
+
+    Fire-and-forget: failures are silently ignored.
+    Respects analytics opt-out setting.
+    """
+    if not get_analytics_enabled():
+        return
+
+    # Build properties - session_id on all events, context only on app_started
+    props: dict = {"$session_id": SESSION_ID, **properties}
+
+    if event in ("app_started", "app_installed"):
+        # Include version and environment context on session start and install
+        props["claudechic_version"] = VERSION
+        try:
+            term_size = os.get_terminal_size()
+            props["term_width"] = term_size.columns
+            props["term_height"] = term_size.lines
+        except OSError:
+            pass
+        props["term_program"] = os.environ.get("TERM_PROGRAM", "unknown")
+        props["os"] = platform.system()
+        props["has_uv"] = shutil.which("uv") is not None
+        props["has_conda"] = shutil.which("conda") is not None
+
+    payload = {
+        "api_key": POSTHOG_API_KEY,
+        "event": event,
+        "distinct_id": get_analytics_id(),
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "properties": props,
+    }
+
+    try:
+        async with httpx.AsyncClient() as client:
+            await client.post(
+                f"{POSTHOG_HOST}/capture/",
+                json=payload,
+                timeout=5.0,
+            )
+    except Exception:
+        pass  # Silent failure - analytics should never impact user experience