docs: improved Quick Start, Codex screenshot, bump to v0.1.2

Author: impactjo

HomeMemoryMCP/HomeMemoryMCP.csproj

@@ -7,7 +7,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <RootNamespace>HomeMemory.MCP</RootNamespace>
     <AssemblyName>HomeMemoryMCP</AssemblyName>
-    <Version>0.1.1</Version>
+    <Version>0.1.2</Version>
   </PropertyGroup>
 
   <ItemGroup>

README.md

@@ -14,12 +14,20 @@
 
 Home Memory is an [MCP server](https://modelcontextprotocol.io/) that gives your AI assistant structured, persistent knowledge about your home — every room, every device, every pipe and cable, every item you own. It plugs into Claude, OpenAI Codex, or any MCP-compatible AI and turns natural conversation into a living, queryable documentation of your home and everything in it.
 
-No app to learn. No forms to fill out. No UI needed — the AI *is* your interface.
+No app to learn. No forms to fill out. Your home data stays in a single file on your machine — the AI *is* your interface.
 
 Tell your AI about your heat pump, your car, your power tools, or your wine collection — it extracts the relevant details and stores them as structured data in your local database. Snap a photo of a device or hand it an invoice — same thing. Ask "What's in the basement?" or "When is my car due for inspection?" and get real answers from real data, not hallucinations.
 
 <p align="center">
-  <img src="docs/demo.png" width="700" alt="Demo: One sentence creates two elements — Claude finds the right categories, creates a missing room, and documents everything.">
+  <img src="docs/demo.png" width="700" alt="Demo in Claude Desktop: One sentence creates two elements — the AI finds the right categories, creates a missing room, and documents everything.">
+  <br>
+  <em>Claude Desktop (Anthropic)</em>
+</p>
+
+<p align="center">
+  <img src="docs/demo-codex.png" width="700" alt="Demo in Codex App: Same prompt, same result — works across AI clients.">
+  <br>
+  <em>Codex App (OpenAI)</em>
 </p>
 
 ## What you can do
@@ -54,31 +62,88 @@ Cable routes, pipe runs, duct paths — documented as connections between elemen
 
 Track what's planned, what exists, and what's been removed.
 
-## Quick Start
+## Quick Start (Windows)
+
+The release ZIP is self-contained — no .NET, no Firebird, no other software to install.
 
-### Option 1: Download Release (recommended)
+### 1. Download & Extract
 
 1. Download the latest release ZIP from [GitHub Releases](../../releases)
-2. Extract to any folder
-3. Register the MCP server:
+2. Extract to a folder, e.g. `C:\HomeMemory\`
+
+### 2. Connect to your AI
+
+Choose **one** of the following clients:
+
+<details>
+<summary><strong>Codex App (OpenAI)</strong></summary>
 
-**Claude Code:**
+1. Open the Codex App
+2. Click **File > Settings**, then select **MCP servers** on the left
+3. Click **+ Add server**
+4. **Name:** `home-memory`
+5. **Command to launch:** `C:\HomeMemory\HomeMemoryMCP.exe`
+6. Leave transport on **STDIO** (default)
+7. Click **Save** — restart the app if needed
+
+Or via Codex CLI:
 ```bash
-claude mcp add home-memory --scope user -- "/path/to/HomeMemoryMCP.exe"
+codex mcp add home-memory -- "C:\HomeMemory\HomeMemoryMCP.exe"
 ```
 
-**OpenAI Codex:**
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+1. Open Claude Desktop
+2. Click the **Claude menu** → **Settings** → **Developer** → **Edit Config**
+3. Add the `home-memory` entry inside `mcpServers` (keep any existing entries):
+
+```json
+"home-memory": {
+  "command": "C:\\HomeMemory\\HomeMemoryMCP.exe"
+}
+```
+
+4. Save the file and restart Claude Desktop
+
+Home Memory is available in the Chat tab.
+
+> If you register Home Memory via Claude Code (`claude mcp add`), it may also appear in the Code tab. Avoid defining the same server in both places, as the Desktop configuration can override the Code tab in some versions.
+
+</details>
+
+<details>
+<summary><strong>Claude Code (CLI)</strong></summary>
+
 ```bash
-codex mcp add home-memory -- "/path/to/HomeMemoryMCP.exe"
+claude mcp add home-memory --scope user -- "C:\HomeMemory\HomeMemoryMCP.exe"
 ```
 
-4. Start your AI client — done.
+</details>
+
+### 3. Try it
+
+On first launch, Home Memory automatically creates a local database with over 100 categories and a default house structure (floors, rooms, garage, outdoor areas). No setup wizard needed.
+
+**Try these prompts in order:**
 
-> **Claude Desktop users:** The Code tab in Claude Desktop shares its configuration with Claude Code. If you registered the server with `claude mcp add`, it is already available in the Code tab — no additional setup needed.
+> "Show me the structure of my home."
 
-On first launch, Home Memory automatically creates a local database at `%LOCALAPPDATA%\HomeMemory\homememory.scd` with over 100 categories and a default house structure. No setup wizard, no configuration needed — just start talking, and adapt everything to your home through conversation. To change the database location, set the `HOME_MEMORY_DB_PATH` environment variable (see [Configuration](#configuration)).
+You should see your default house structure: ground floor, upper floor, basement, each with rooms. This confirms everything is working.
 
-### Option 2: Build from Source
+> "I have a Bosch washing machine in the basement."
+
+Your AI creates the element, finds the right category, and places it in the basement — all in one step. Ask "What's in the basement?" to verify.
+
+> "We're planning to install a heat pump in the utility room."
+
+Creates a planned element — so you can track what exists and what's coming.
+
+**If it works, you're done.** Everything from here is just talking to your AI. Add rooms, rename floors, document your electrical panel, upload a photo of a device — the AI handles the rest.
+
+### Build from Source (advanced)
 
 Requires [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) and [Firebird 3.0](https://firebirdsql.org/en/firebird-3-0/).
 
@@ -128,10 +193,11 @@ Electrical (circuits, PV, wallbox, home automation) &middot; HVAC &middot; Plumb
 
 | Client | Status |
 |---|---|
+| Codex App (OpenAI) | Tested, production-ready |
+| Claude Desktop (Chat tab) | Tested, production-ready |
+| Claude Desktop (Code tab) | Works via Claude Code registration; see note above |
 | Claude Code (CLI) | Tested, production-ready |
-| Claude Desktop (Code tab) | Works automatically — shares Claude Code configuration |
 | Codex CLI (OpenAI) | Tested, production-ready |
-| Codex App (OpenAI) | Tested, production-ready |
 | Any MCP-compatible client | Should work (stdio transport) |
 
 The release ZIP is a self-contained Windows build with all dependencies included (no .NET or Firebird installation required). On macOS and Linux, you can build from source with .NET 10 and Firebird 3 — see the [Setup Guide](docs/SETUP-GUIDE.md) for details.
@@ -148,7 +214,6 @@ The release ZIP is a self-contained Windows build with all dependencies included
 - **.NET 10** with [ModelContextProtocol SDK](https://github.com/modelcontextprotocol/csharp-sdk)
 - **Firebird Embedded** — zero-install database engine, single-file storage
 - **Raw SQL** with recursive CTEs — no ORM overhead, transparent and auditable
-- **Semantic Versioning** — currently `v0.1.1` (pre-release)
 
 ## Contributing
 

docs/SETUP-GUIDE.md

@@ -2,7 +2,7 @@
 
 ## Using the Release (recommended)
 
-Download the release ZIP from [GitHub Releases](../../releases) and follow the [Quick Start](../README.md#quick-start) in the README. The release is a self-contained build — no .NET SDK and no Firebird installation required.
+Download the release ZIP from [GitHub Releases](../../releases) and follow the [Quick Start](../README.md#quick-start-windows) in the README. The release is a self-contained build — no .NET SDK and no Firebird installation required.
 
 ## Configuration
 
@@ -54,36 +54,25 @@ claude mcp add home-memory --scope user --env "HOME_MEMORY_DB_PATH=/path/to/my-h
 codex mcp add home-memory --env "HOME_MEMORY_DB_PATH=/path/to/my-home.scd" -- "/path/to/HomeMemoryMCP.exe"
 ```
 
-### Claude Desktop (Chat tab)
+### Claude Desktop
 
-The Chat tab in Claude Desktop uses a separate config file from Claude Code. Edit it manually and restart Claude Desktop.
+Open the **Claude menu** → **Settings** → **Developer** → **Edit Config**. This opens the correct config file regardless of how Claude Desktop was installed (Store or direct install).
 
-**Config file location:**
-
-| Platform | Path |
-|---|---|
-| Windows (Store / direct install) | `%AppData%\Claude\claude_desktop_config.json` |
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-
-Add the `mcpServers` entry (create the file if it doesn't exist):
+Add the `home-memory` entry inside `mcpServers` (keep any existing entries):
 
 ```json
-{
-  "mcpServers": {
-    "home-memory": {
-      "command": "C:\\path\\to\\HomeMemoryMCP.exe",
-      "args": [],
-      "env": {
-        "HOME_MEMORY_DB_PATH": "C:\\path\\to\\my-home.scd"
-      }
-    }
+"home-memory": {
+  "command": "C:\\path\\to\\HomeMemoryMCP.exe",
+  "args": [],
+  "env": {
+    "HOME_MEMORY_DB_PATH": "C:\\path\\to\\my-home.scd"
   }
 }
 ```
 
 Omit the `env` block to use the default database location (`%LOCALAPPDATA%\HomeMemory\homememory.scd`).
 
-> **Note:** The Code tab in Claude Desktop shares its configuration with Claude Code (`~/.claude.json`) and does not use this file — it picks up Home Memory automatically if you registered it with `claude mcp add`.
+> **Note:** If you register Home Memory via Claude Code (`claude mcp add`), it may also appear in the Code tab. Avoid defining the same server in both the Desktop config and Claude Code, as the Desktop configuration can override the Code tab in some versions.
 
 ### Managing registrations