docs: overhaul auto-setup instructions — add Log Hub, fix tool counts (v1.16.2)

Complete rewrite of CLAUDE_MD_BLOCK in setup.ts:
- Add Log Hub section (init, query, HTTP API, Viewer integration)
- Add missing query params (modified_before, file_filter, type_filter)
- Add task/note summary fields, global_init show_progress
- Update tool count 28 → 30, Viewer description includes Logs tab
- README: add aidex_log to Available Tools table

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

Author: CSCSoftware

.claude/CLAUDE.md

@@ -2,7 +2,7 @@
 
 MCP Server für persistentes Code-Indexing. Ermöglicht Claude Code schnelle, präzise Suchen statt Grep/Glob.
 
-**Version:** 1.16.1 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
+**Version:** 1.16.2 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
 
 ## Build & Run
 
@@ -36,7 +36,7 @@ Registriert als MCP Server `aidex` (Prefix: `mcp__aidex__aidex_*`).
 **Nach Änderungen:** Build ausführen, dann Claude Code neu starten.
 **MCP-Name:** Server muss als `"aidex"` registriert sein → Prefix wird `mcp__aidex__aidex_*`.
 
-## Tools (28)
+## Tools (30)
 
 ### Suche & Index
 | Tool | Beschreibung |

CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to AiDex will be documented in this file.
 
 ## [Unreleased]
 
+## [1.16.2] - 2026-03-20
+
+### Changed
+- **Auto-setup instructions overhaul**: Complete rewrite of the CLAUDE.md/GEMINI.md block installed by `aidex setup`
+  - Added **Log Hub** section with full usage guide (init, query, HTTP API, Viewer integration)
+  - Added missing query parameters: `modified_before`, `file_filter`, `type_filter`
+  - Added `show_progress` for `global_init`
+  - Added task `summary` field documentation
+  - Added note `summary` field documentation
+  - Updated tool count from 28 → 30
+  - Updated Viewer description to include Logs tab
+  - Added "Debug my app" to Question → Right Tool table
+- **README**: Added `aidex_log` to Available Tools table, updated tool counts to 30
+- **Projekt-CLAUDE.md**: Updated tool count to 30
+
 ## [1.16.1] - 2026-03-20
 
 ### Added

README.md

@@ -303,7 +303,7 @@ Do I want to search code?
 - **`contains`**: Finds identifiers containing the term — `render` matches `preRenderSetup`
 - **`starts_with`**: Finds identifiers starting with the term — `Update` matches `UpdatePlayer`, `UpdateUI`
 
-### All Tools (29)
+### All Tools (30)
 
 | Category | Tools | Purpose |
 |----------|-------|---------|
@@ -314,9 +314,10 @@ Do I want to search code?
 | Global Search | `aidex_global_init`, `aidex_global_query`, `aidex_global_signatures`, `aidex_global_status`, `aidex_global_refresh` | Search across ALL projects |
 | Guidelines | `aidex_global_guideline` | Persistent AI instructions & conventions (key-value, global) |
 | Sessions | `aidex_session`, `aidex_note` | Track sessions, leave notes (with searchable history) |
-| Tasks | `aidex_task`, `aidex_tasks` | Built-in backlog with priorities, tags, auto-logged history |
+| Tasks | `aidex_task`, `aidex_tasks` | Built-in backlog with priorities, tags, summaries, auto-logged history |
+| Log Hub | `aidex_log` | Universal log receiver — any program sends logs via HTTP, AI queries them, live in Viewer |
 | Screenshots | `aidex_screenshot`, `aidex_windows` | Screen capture with LLM optimization (scale + color reduction, no index needed) |
-| Viewer | `aidex_viewer` | Interactive browser UI with file tree, signatures, tasks |
+| Viewer | `aidex_viewer` | Interactive browser UI with file tree, signatures, tasks, and live logs |
 
 **11 languages:** C#, TypeScript, JavaScript, Rust, Python, C, C++, Java, Go, PHP, Ruby
 
@@ -414,6 +415,7 @@ aidex_init({ path: "/path/to/your/project" })
 | `aidex_global_signatures` | Search methods/types by name across all projects |
 | `aidex_global_refresh` | Update stats and remove stale projects from global DB |
 | `aidex_global_guideline` | Store/retrieve AI guidelines and coding conventions (key-value, global) |
+| `aidex_log` | Universal log receiver — start HTTP server, query logs, live stream in Viewer |
 
 ## Time-based Filtering
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidex-mcp",
-  "version": "1.16.1",
+  "version": "1.16.2",
   "mcpName": "io.github.CSCSoftware/aidex",
   "description": "MCP Server for persistent code indexing. Gives AI assistants (Claude, Gemini, Copilot, Cursor) instant access to your codebase. 50x less context than grep.",
   "main": "build/index.js",

src/commands/setup.ts

@@ -98,20 +98,24 @@ Do I want to search code?
 | "Explore all files in src/" | \`aidex_signatures pattern="src/**"\` |
 | "Project overview" | \`aidex_summary\` + \`aidex_tree\` |
 | "What changed recently?" | \`aidex_query term="X" modified_since="2h"\` |
+| "What changed before yesterday?" | \`aidex_query term="X" modified_before="1d"\` |
 | "What files changed today?" | \`aidex_files path="." modified_since="8h"\` |
+| "Only search in src/server/" | \`aidex_query term="X" file_filter="src/server/**"\` |
+| "Only method definitions" | \`aidex_query term="X" type_filter=["method"]\` |
 | "Have I ever written X?" | \`aidex_global_query term="X" mode="contains"\` |
 | "Which project has class Y?" | \`aidex_global_signatures term="Y" kind="class"\` |
 | "All indexed projects?" | \`aidex_global_status\` |
 | "Store coding convention" | \`aidex_global_guideline action="set"\` |
 | "Load review checklist" | \`aidex_global_guideline action="get"\` |
+| "Debug my app — see logs" | \`aidex_log action="init"\` + \`aidex_viewer\` |
 
 ### Search Modes
 
 - **\`exact\`** (default): Finds only the exact identifier — \`log\` won't match \`catalog\`
 - **\`contains\`**: Finds identifiers containing the term — \`render\` matches \`preRenderSetup\`
 - **\`starts_with\`**: Finds identifiers starting with the term — \`Update\` matches \`UpdatePlayer\`, \`UpdateUI\`
 
-### All Tools (28)
+### All Tools (30)
 
 | Category | Tools | Purpose |
 |----------|-------|---------|
@@ -121,10 +125,11 @@ Do I want to search code?
 | Cross-Project | \`aidex_link\`, \`aidex_unlink\`, \`aidex_links\`, \`aidex_scan\` | Link dependencies, discover projects |
 | Global Search | \`aidex_global_init\`, \`aidex_global_query\`, \`aidex_global_signatures\`, \`aidex_global_status\`, \`aidex_global_refresh\` | Search across ALL projects |
 | Guidelines | \`aidex_global_guideline\` | Persistent AI instructions & conventions (key-value, global) |
-| Sessions | \`aidex_session\`, \`aidex_note\` | Track sessions, leave notes (with searchable history) |
-| Tasks | \`aidex_task\`, \`aidex_tasks\` | Built-in backlog with priorities, tags, auto-logged history |
-| Screenshots | \`aidex_screenshot\`, \`aidex_windows\` | Cross-platform screen capture (no index needed) |
-| Viewer | \`aidex_viewer\` | Interactive browser UI with file tree, signatures, tasks |
+| Sessions | \`aidex_session\`, \`aidex_note\` | Track sessions, leave notes (with searchable history & summaries) |
+| Tasks | \`aidex_task\`, \`aidex_tasks\` | Built-in backlog with priorities, tags, summaries, auto-logged history |
+| Log Hub | \`aidex_log\` | Universal log receiver — any program sends logs via HTTP, AI queries them, live in Viewer |
+| Screenshots | \`aidex_screenshot\`, \`aidex_windows\` | Cross-platform screen capture with LLM optimization (scale + color reduction) |
+| Viewer | \`aidex_viewer\` | Interactive browser UI with file tree, signatures, tasks, and live logs |
 
 ### Session Notes
 
@@ -138,26 +143,56 @@ aidex_note({ path: ".", clear: true })                                 # Clear
 \`\`\`
 - **Before ending a session:** automatically leave a note about next steps
 - **User says "remember for next session: ..."** → write it immediately
+- Provide \`summary\` when writing/clearing — the archived note gets a one-sentence description
 
 ### Task Backlog
 
 Track TODOs, bugs, and features right next to your code index:
 \`\`\`
-aidex_task({ path: ".", action: "create", title: "Fix bug", priority: 1, tags: "bug" })
+aidex_task({ path: ".", action: "create", title: "Fix bug", priority: 1, tags: "bug", summary: "Short description for backlog overview" })
 aidex_task({ path: ".", action: "update", id: 1, status: "done" })
 aidex_task({ path: ".", action: "log", id: 1, note: "Root cause found" })
 aidex_tasks({ path: ".", status: "active" })
 \`\`\`
 Priority: 1=high, 2=medium, 3=low | Status: \`backlog → active → done | cancelled\`
+Summaries: One-sentence table-of-contents per task — scan the backlog without reading full details.
+
+### Log Hub — Universal Logging
+
+Any program (C#, Python, Node, C++, etc.) can send logs via HTTP POST. The AI queries them, and the user sees them live in the Viewer.
+
+**When to use:** Whenever working on a program that needs debugging, testing, or logging — **proactively offer Log Hub + Viewer**.
+
+\`\`\`
+aidex_log({ action: "init" })                                         # Start server (port 3335)
+aidex_log({ action: "init", persist: true, path: "." })               # With DB persistence
+aidex_log({ action: "query" })                                        # Last 50 entries
+aidex_log({ action: "query", since: "10m", level: "error" })          # Errors last 10 min
+aidex_log({ action: "query", source: "MyApp", contains: "crash" })    # Filtered
+aidex_log({ action: "query", consume: true })                         # Poll & remove (no duplicates)
+aidex_log({ action: "write", message: "Debug started" })              # AI writes entry
+aidex_log({ action: "status" })                                       # Stats
+aidex_log({ action: "clear" })                                        # Clear buffer
+aidex_log({ action: "free" })                                         # Stop server
+\`\`\`
+
+**HTTP API** for external programs — just POST to \`http://localhost:3335/log\`:
+\`\`\`json
+{ "level": "info", "source": "MyApp", "message": "Player spawned", "data": { "x": 10 } }
+\`\`\`
+Levels: \`debug\`, \`info\`, \`warn\`, \`error\` | Batch: POST array to \`/logs\` | Health: GET \`/health\`
+
+**Viewer integration:** Open \`aidex_viewer({ path: "." })\` — the Logs tab shows a live WebSocket stream with level/source/text filters.
 
 ### Global Search (across all projects)
 
 \`\`\`
 aidex_global_init({ path: "/path/to/all/repos" })                     # Scan & register
-aidex_global_init({ path: "...", index_unindexed: true })              # + auto-index small projects
+aidex_global_init({ path: "...", index_unindexed: true, show_progress: true }) # Auto-index + browser progress UI
 aidex_global_query({ term: "TransparentWindow", mode: "contains" })   # Search everywhere
 aidex_global_signatures({ term: "Render", kind: "method" })           # Find methods everywhere
 aidex_global_status({ sort: "recent" })                                # List all projects
+aidex_global_refresh()                                                 # Update stats, remove stale
 \`\`\`
 
 ### Screenshots