fix: prevent title duplication in createNote

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Changed
+- **createNote uses body-only approach** — Title is now set exclusively via `<h1>` prefix in the note body instead of setting both the `name` property and body. This eliminates title duplication.
+
+### Fixed
+- **Title duplication in createNote** — Previously, setting both `name` and `body` caused the title to appear twice in the note. Now only `body` (with `<h1>` title prefix) is used.
+
+### Added
+- **Proper backslash and tab handling** in plaintext content encoding — Backslashes are encoded as `&#92;` and tabs are converted to `<br>` to prevent AppleScript escaping issues.
+
 ## [1.2.17] - 2025-01-01
 
 ### Security

CLAUDE.md

@@ -74,7 +74,8 @@ delete-note id="x-coredata://ABC/ICNote/p123"
 ### create-note / update-note
 - Always escape backslashes in content (see above)
 - Newlines can be sent as `\n` (this is a valid JSON escape)
-- The title becomes the first line of the note
+- **Title handling:** The `title` parameter is automatically prepended as `<h1>` in the note body. Do NOT include the title in the `content` parameter, or it will appear twice.
+- **HTML format:** When using `format: "html"`, do NOT include a `<h1>` tag in `content` — the title is prepended automatically as `<h1>`.
 - `create-note` returns the new note's ID for subsequent operations
 
 ### Whitespace Accumulation on Iterative Updates

README.md

@@ -107,10 +107,10 @@ Creates a new note in Apple Notes.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `title` | string | Yes | The title of the note (becomes first line) |
-| `content` | string | Yes | The body content of the note |
+| `title` | string | Yes | The title of the note. Automatically prepended as `<h1>` — do NOT include the title in `content` |
+| `content` | string | Yes | The body content of the note (do not repeat the title here) |
 | `tags` | string[] | No | Tags for organization (stored in metadata) |
-| `format` | string | No | Content format: `"plaintext"` (default) or `"html"`. When `"html"`, content is used as raw HTML for rich formatting |
+| `format` | string | No | Content format: `"plaintext"` (default) or `"html"`. In both formats, the title is automatically prepended as `<h1>`. In plaintext mode, newlines become `<br>`, tabs become `<br>`, and backslashes are preserved as HTML entities |
 
 **Example:**
 ```json
@@ -125,11 +125,13 @@ Creates a new note in Apple Notes.
 ```json
 {
   "title": "Status Report",
-  "content": "<h1>Status Report</h1><h2>Summary</h2><p>All tasks <b>on track</b>.</p><ul><li>Feature A: complete</li><li>Feature B: in progress</li></ul>",
+  "content": "<h2>Summary</h2><p>All tasks <b>on track</b>.</p><ul><li>Feature A: complete</li><li>Feature B: in progress</li></ul>",
   "format": "html"
 }
 ```
 
+> **Note:** The title is automatically prepended as `<h1>` in both plaintext and HTML formats. Do not include a `<h1>` title tag in the `content` parameter, or the title will appear twice.
+
 **Returns:** Confirmation message with note title and ID. Save the ID for subsequent operations like `update-note`, `delete-note`, etc.
 
 ---
@@ -293,7 +295,7 @@ Updates an existing note's content and/or title.
 ```json
 {
   "id": "x-coredata://ABC123/ICNote/p456",
-  "newContent": "<h1>Updated Report</h1><p>New findings with <b>bold</b> emphasis.</p><pre><code>console.log('hello');</code></pre>",
+  "newContent": "<p>New findings with <b>bold</b> emphasis.</p><pre><code>console.log('hello');</code></pre>",
   "format": "html"
 }
 ```

TECHNICAL_NOTES.md

@@ -249,6 +249,10 @@ Can export notes to HTML/Markdown using built-in actions, but limited programmat
 | Attachment positioning unknown | Can't recreate note layout | Accept limitation |
 | Password-protected notes | Cannot read | Skip or warn user |
 
+### Note Creation: Body-Only Approach
+
+When creating notes via AppleScript, setting both the `name` property and the `body` causes title duplication — the title appears twice in the rendered note. The fix is to set only the `body`, with the title prepended as an `<h1>` tag. Apple Notes derives the note's display title from the first element in the body HTML. This approach works for both plaintext (converted to HTML) and HTML format content.
+
 ### Database Access Issues
 
 - Launch agents cannot access Group Containers even with Full Disk Access