feat: add logger

Author: damassi

Makefile

@@ -1,10 +1,13 @@
-.PHONY: chat logs
+.PHONY: chat dev console
 
 install:
 	uv sync && uv run pre-commit install
 
 chat:
 	uv run chat
 
-logs:
+console:
 	uv run textual console -x SYSTEM -x EVENT -x DEBUG -x INFO
+
+dev:
+	uv run textual run --dev -c chat

README.md

@@ -27,3 +27,19 @@ Additional MCP servers are configured in `agent-chat-cli.config.yaml` and prompt
 - Typechecking is via [MyPy](https://github.com/python/mypy):
   - `uv run mypy src`
 - Linting and formatting is via [Ruff](https://docs.astral.sh/ruff/)
+
+Textual has an integrated logging console which one can boot separately from the app to receive logs.
+
+In one terminal pane boot the console:
+
+```bash
+make console
+```
+
+> Note: this command intentionally filters out more verbose notifications. See the Makefile to configure.
+
+And then in a second, start the textual dev server:
+
+```bash
+make dev
+```

agent-chat-cli.config.yaml

@@ -4,7 +4,7 @@
 system_prompt: system.md
 
 # Model to use (e.g., sonnet, opus, haiku)
-model: sonnet
+model: haiku
 
 # Enable streaming responses
 include_partial_messages: true

src/agent_chat_cli/app.py

@@ -1,26 +1,21 @@
-import logging
 import asyncio
 
 from textual.app import App, ComposeResult
 from textual.containers import VerticalScroll
 from textual.binding import Binding
-from textual.logging import TextualHandler
 
 from agent_chat_cli.components.header import Header
 from agent_chat_cli.components.chat_history import ChatHistory, MessagePosted
 from agent_chat_cli.components.thinking_indicator import ThinkingIndicator
 from agent_chat_cli.components.user_input import UserInput
 from agent_chat_cli.utils import AgentLoop
 from agent_chat_cli.utils.message_bus import MessageBus
+from agent_chat_cli.utils.logger import setup_logging
 
 from dotenv import load_dotenv
 
 load_dotenv()
-
-logging.basicConfig(
-    level="NOTSET",
-    handlers=[TextualHandler()],
-)
+setup_logging()
 
 
 class AgentChatCLIApp(App):
@@ -45,7 +40,6 @@ def compose(self) -> ComposeResult:
             yield UserInput(query=self.agent_loop.query)
 
     async def on_mount(self) -> None:
-        logging.debug("Starting agent loop...")
         asyncio.create_task(self.agent_loop.start())
 
     async def on_message_posted(self, event: MessagePosted) -> None:

src/agent_chat_cli/docs/architecture.md

@@ -4,28 +4,6 @@
 
 Agent Chat CLI is a Python TUI application built with Textual that provides an interactive chat interface for Claude AI with MCP (Model Context Protocol) server support.
 
-## Directory Structure
-
-```
-src/agent_chat_cli/
-├── app.py                      # Main application entry point
-├── components/                 # UI components (Textual widgets)
-│   ├── chat_history.py        # Container for chat messages
-│   ├── messages.py            # Message widgets and UI Message type
-│   ├── user_input.py          # User input component
-│   ├── thinking_indicator.py # Loading indicator
-│   └── header.py              # App header with config info
-├── utils/                     # Business logic and utilities
-│   ├── agent_loop.py          # Claude SDK conversation loop
-│   ├── message_bus.py         # Routes messages between agent and UI
-│   ├── config.py              # Configuration loading and validation
-│   ├── enums.py               # All enum types
-│   ├── system_prompt.py       # System prompt assembly
-│   ├── format_tool_input.py   # Tool input formatting
-│   └── tool_info.py           # MCP tool name parsing
-└── utils/styles.tcss          # Textual CSS styles
-```
-
 ## Core Components
 
 ### App Layer (`app.py`)

src/agent_chat_cli/utils/logger.py

@@ -0,0 +1,20 @@
+import json
+import logging
+from typing import Any
+
+from textual.logging import TextualHandler
+
+
+def setup_logging():
+    logging.basicConfig(
+        level="NOTSET",
+        handlers=[TextualHandler()],
+    )
+
+
+def log(message: str):
+    logging.info(message)
+
+
+def log_json(message: Any):
+    logging.info(json.dumps(message, indent=2))

src/agent_chat_cli/utils/message_bus.py

@@ -23,12 +23,6 @@ def __init__(self, app: "App") -> None:
         self.current_agent_message: AgentMessageWidget | None = None
         self.current_response_text = ""
 
-    async def _scroll_to_bottom(self) -> None:
-        """Scroll the container to the bottom after a slight pause."""
-        await asyncio.sleep(0.1)
-        container = self.app.query_one("#container")
-        container.scroll_end(animate=False, immediate=True)
-
     async def handle_agent_message(self, message: AgentMessage) -> None:
         match message.type:
             case AgentMessageType.STREAM_EVENT:
@@ -38,6 +32,12 @@ async def handle_agent_message(self, message: AgentMessage) -> None:
             case AgentMessageType.RESULT:
                 await self._handle_result()
 
+    async def _scroll_to_bottom(self) -> None:
+        """Scroll the container to the bottom after a slight pause."""
+        await asyncio.sleep(0.1)
+        container = self.app.query_one("#container")
+        container.scroll_end(animate=False, immediate=True)
+
     async def _handle_stream_event(self, message: AgentMessage) -> None:
         text_chunk = message.data.get("text", "")