From 7bdb25b1dd8bdcc942416eee3c82f544cc6c296d Mon Sep 17 00:00:00 2001 From: Francesco Date: Sat, 28 Feb 2026 12:39:32 +0100 Subject: [PATCH 1/3] docs: fix heading formatting in commands.md and refine phrasing in tools-api.md --- docs/reference/commands.md | 6 ++---- docs/reference/tools-api.md | 4 ++-- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/reference/commands.md b/docs/reference/commands.md index ceb064a9bf7..8f73ea4b2f9 100644 --- a/docs/reference/commands.md +++ b/docs/reference/commands.md @@ -8,8 +8,6 @@ with a forward slash (`/`), an at symbol (`@`), or an exclamation mark (`!`). Slash commands provide meta-level control over the CLI itself. -### Built-in Commands - ### `/about` - **Description:** Show version info. Share this information when filing issues. @@ -61,9 +59,9 @@ Slash commands provide meta-level control over the CLI itself. modifications, see the [Checkpointing documentation](../cli/checkpointing.md). - **`share [filename]`** - - **Description** Writes the current conversation to a provided Markdown or + - **Description:** Writes the current conversation to a provided Markdown or JSON file. If no filename is provided, then the CLI will generate one. - - **Usage** `/chat share file.md` or `/chat share file.json`. + - **Usage:** `/chat share file.md` or `/chat share file.json`. ### `/clear` diff --git a/docs/reference/tools-api.md b/docs/reference/tools-api.md index 91fae3f720f..658216d9d7a 100644 --- a/docs/reference/tools-api.md +++ b/docs/reference/tools-api.md @@ -110,8 +110,8 @@ its specific functionality. ## Extending with custom tools While direct programmatic registration of new tools by users isn't explicitly -detailed as a primary workflow in the provided files for typical end-users, the -architecture supports extension through: +detailed as a primary workflow in this documentation, the architecture supports +extension through: - **Command-based discovery:** Advanced users or project administrators can define a `tools.discoveryCommand` in `settings.json`. This command, when run From f9f91b335628801a3f5b95b48304f6d81cb37854 Mon Sep 17 00:00:00 2001 From: Francesco Camporeale Date: Fri, 6 Mar 2026 08:14:30 +0100 Subject: [PATCH 2/3] Update commands.md Add tier 3 header back --- docs/reference/commands.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/reference/commands.md b/docs/reference/commands.md index 8f73ea4b2f9..8383db418f4 100644 --- a/docs/reference/commands.md +++ b/docs/reference/commands.md @@ -8,6 +8,8 @@ with a forward slash (`/`), an at symbol (`@`), or an exclamation mark (`!`). Slash commands provide meta-level control over the CLI itself. +### Built-in Commands + ### `/about` - **Description:** Show version info. Share this information when filing issues. From 6ed3c87a49ee9fc37cae7178977da38ae45bb944 Mon Sep 17 00:00:00 2001 From: Francesco Camporeale Date: Sat, 7 Mar 2026 09:30:32 +0100 Subject: [PATCH 3/3] Update tools-api.md Undo outdated doc changes to resolve merge conflict --- docs/reference/tools-api.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/tools-api.md b/docs/reference/tools-api.md index 658216d9d7a..91fae3f720f 100644 --- a/docs/reference/tools-api.md +++ b/docs/reference/tools-api.md @@ -110,8 +110,8 @@ its specific functionality. ## Extending with custom tools While direct programmatic registration of new tools by users isn't explicitly -detailed as a primary workflow in this documentation, the architecture supports -extension through: +detailed as a primary workflow in the provided files for typical end-users, the +architecture supports extension through: - **Command-based discovery:** Advanced users or project administrators can define a `tools.discoveryCommand` in `settings.json`. This command, when run