Update docs with Agent Setup Wizard instructions

- README: Add wizard to AI Agent Integration section with quick start guide
- AGENT_CHAT_GUIDE: Add Quick Start section with wizard steps and config format
- CLAUDE.md: Document wizard feature and supported agent types

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ozgesolidkey

CLAUDE.md

@@ -38,6 +38,14 @@ Use this pattern for interactive conversations with the LOGAN user:
 | `logan_baseline_save` / `logan_baseline_compare` | Save and compare baselines |
 | `logan_get_notes` / `logan_save_notes` | Read/write freeform notes |
 
+### Agent Setup Wizard
+
+LOGAN includes a setup wizard (gear icon in Chat tab) that:
+- Auto-detects Claude Code CLI, existing config, and built-in agent
+- Supports three agent types: Claude Code (AI), Built-in, Custom Script
+- Saves config to `~/.logan/agent-config.json`
+- Launches the agent immediately after setup
+
 ### Important
 
 - Always call `logan_status` first to check if a file is open

README.md

@@ -14,8 +14,10 @@ A fast, AI-ready log file viewer built with Electron. Handles **14 million+ line
 - **JSON auto-format** — Pretty-print JSON files on open
 
 ### AI Agent Integration
+- **Setup Wizard** — Guided setup: auto-detects Claude Code CLI and configures the agent connection
 - **MCP support** — 30+ tools auto-discovered by Claude Code, Cursor, and other MCP clients via `.mcp.json`
 - **Agent Chat tab** — Bidirectional messaging between LOGAN and AI agents with SSE real-time bridge
+- **Claude Code integration** — Launch Claude Code directly from LOGAN with full MCP tool access
 - **Built-in agent** — One-click launch from the Chat tab, handles triage/search/crash analysis/bookmarking
 - **HTTP API** — Full REST API for custom agents (bash, Node.js, Python) — see [LOGAN-AGENT.md](LOGAN-AGENT.md)
 - **Connection indicator** — Shows agent name and status, enforces single-agent connection
@@ -158,13 +160,23 @@ If LOGAN is already running, the file opens in the existing window. If not, a ne
 
 ## AI Agent Integration
 
-LOGAN exposes a full log-analysis API that AI agents can use. Three integration paths:
+LOGAN exposes a full log-analysis API that AI agents can use. Four integration paths:
 
 | Method | How |
 |--------|-----|
-| **MCP clients** (Claude Code, Cursor) | Tools auto-discovered via `.mcp.json` — just open the project |
+| **Claude Code** (recommended) | Click "Launch Agent" → Setup Wizard auto-detects CLI and configures MCP |
+| **MCP clients** (Cursor, Windsurf) | Tools auto-discovered via `.mcp.json` — just open the project |
 | **Custom scripts** | Hit the HTTP API directly or use the `logan-listen` CLI helper |
-| **Built-in agent** | Click "Launch Agent" in the Chat tab — no setup needed |
+| **Built-in agent** | Click "Launch Agent" → select "Built-in Agent" — no setup needed |
+
+### Quick Start: Agent Setup Wizard
+
+1. Open the **Chat tab** (bottom panel, chat icon)
+2. Click **Launch Agent** (or the gear icon next to it)
+3. The wizard auto-detects available tools (Claude Code CLI, etc.)
+4. Choose your agent type and click **Save & Launch**
+
+The wizard saves configuration to `~/.logan/agent-config.json`. Subsequent launches skip the wizard.
 
 See [LOGAN-AGENT.md](LOGAN-AGENT.md) for the full API reference, example scripts, and integration guide.
 

docs/AGENT_CHAT_GUIDE.md

@@ -1,6 +1,6 @@
 # LOGAN Agent Chat Integration Guide
 
-LOGAN supports real-time bidirectional chat between AI agents and the user through its built-in Chat panel. This guide covers three integration methods.
+LOGAN supports real-time bidirectional chat between AI agents and the user through its built-in Chat panel. This guide covers integration methods from simplest to most flexible.
 
 ## See Also
 
@@ -18,6 +18,32 @@ LOGAN supports real-time bidirectional chat between AI agents and the user throu
 
 ---
 
+## Quick Start: Setup Wizard
+
+The easiest way to connect an AI agent is through the built-in Setup Wizard:
+
+1. Open the **Chat tab** (bottom panel)
+2. Click **Launch Agent** or the **gear icon** next to it
+3. The wizard auto-detects available tools:
+   - **Claude Code CLI** — full AI with MCP tool access (recommended)
+   - **Built-in Agent** — basic keyword-based command handler
+   - **Custom Script** — your own agent script (Node.js, Python, Bash)
+4. Choose your agent type, configure if needed, and click **Save & Launch**
+
+Configuration is saved to `~/.logan/agent-config.json`:
+```json
+{
+  "type": "claude-code",
+  "model": ""
+}
+```
+
+Supported `type` values: `"claude-code"`, `"builtin"`, `"custom"` (requires `"scriptPath"`).
+
+For Claude Code, LOGAN automatically generates an MCP config and launches Claude with `--print --permission-mode bypassPermissions --strict-mcp-config` for seamless non-interactive operation.
+
+---
+
 ## Method 1: MCP Tools (Recommended)
 
 For agents that support [Model Context Protocol](https://modelcontextprotocol.io) (Claude Code, Cursor, Windsurf, etc.).