Function chatThreadAppend

chatThreadAppend(
vault: Vault,
args: ChatThreadAppendArgs,
): Promise<{ line_end: number; line_start: number; note_path: string }>
Append a message to a note's chat thread — note-tethered AI conversations persisted as markdown.

Creates the note (and the ## Chat: <title> parent heading) if absent. Messages are stored as third-level headings with role + ISO timestamp (### user · 2026-05-08T10:00Z). The format is human-readable, version- controllable via git, and feeds back into the vault's retrieval index — agents can search past threads by content like any other note.

Appending always creates a fresh ### <role> · <timestamp> block, never mutates existing messages. Safe to call concurrently if note writes don't collide (last-write-wins on simultaneous appends to same note).
Parameters
- vault: Vault
  The vault. Must allow writes (i.e. the server was started with --enable-writes).
- args: ChatThreadAppendArgs
  note_path, role, content are required. thread_title is used only when creating a brand-new note from scratch.
Returns Promise<{ line_end: number; line_start: number; note_path: string }>
The note's vault-relative path plus the 1-based line range of the appended message (for jumping the UI to it).
Throws
If note_path or content is empty, or role is not a valid value.
Example
```
await chatThreadAppend(vault, {
  note_path: "Threads/Research-2026-05-08.md",
  role: "user",
  content: "What did I write last week about RLHF?",
  thread_title: "RLHF research session"
});
```
- Defined in tools/read.ts:834

Function chatThreadAppend

Parameters

Returns Promise<{ line_end: number; line_start: number; note_path: string }>

Throws

Example

Settings