What happened?
On Windows, custom command descriptions defined in Markdown frontmatter are not displayed correctly.
Instead of showing the description value from the YAML frontmatter, the UI displays the generic message: 'Custom command from {{filename}}.md' For example: 'Custom command from deploy.md'
The same .md file works correctly on macOS, where the description field is properly parsed and displayed.
Observed behavior
When creating a custom command file such as:
~/.qwen/commands/deploy.md
With the following content:
---
description: Deploy the app to staging
---
Run the deployment script with {{args}}.
On Windows:
The description is not shown.
The UI falls back to the default message.
Likely cause
There appear to be two Windows-specific issues:
CRLF line endings (\r\n)
The frontmatter regex in
packages/cli/src/services/markdown-command-parser.ts
It seems to match only LF (\n) line endings.
On Windows, files typically use CRLF (\r\n), causing the regex to fail and preventing frontmatter parsing.
UTF-8 BOM
If the file is saved with a UTF-8 BOM, the content begins with \uFEFF.
Since the parser expects ^---, the BOM prevents the pattern from matching.
As a result, frontmatter (including description) is not recognized.
What did you expect to happen?
The CLI should correctly parse YAML frontmatter on Windows, regardless of:
Line ending style (LF or CRLF)
Presence of a UTF-8 BOM
The description value from frontmatter should be displayed in the UI exactly as it is on macOS.
Client information
OS: Windows 11
File encoding: UTF-8 (with BOM in some cases)
Line endings: CRLF (\r\n)
Version: (please fill in your CLI/app version here)
Login information
No response
Anything else we need to know?
No response
What happened?
On Windows, custom command descriptions defined in Markdown frontmatter are not displayed correctly.
Instead of showing the description value from the YAML frontmatter, the UI displays the generic message: 'Custom command from {{filename}}.md' For example: 'Custom command from deploy.md'
The same .md file works correctly on macOS, where the description field is properly parsed and displayed.
Observed behavior
When creating a custom command file such as:
~/.qwen/commands/deploy.md
With the following content:
On Windows:
The description is not shown.
The UI falls back to the default message.
Likely cause
There appear to be two Windows-specific issues:
CRLF line endings (\r\n)
The frontmatter regex in
packages/cli/src/services/markdown-command-parser.ts
It seems to match only LF (\n) line endings.
On Windows, files typically use CRLF (\r\n), causing the regex to fail and preventing frontmatter parsing.
UTF-8 BOM
If the file is saved with a UTF-8 BOM, the content begins with \uFEFF.
Since the parser expects ^---, the BOM prevents the pattern from matching.
As a result, frontmatter (including description) is not recognized.
What did you expect to happen?
The CLI should correctly parse YAML frontmatter on Windows, regardless of:
Line ending style (LF or CRLF)
Presence of a UTF-8 BOM
The description value from frontmatter should be displayed in the UI exactly as it is on macOS.
Client information
OS: Windows 11
File encoding: UTF-8 (with BOM in some cases)
Line endings: CRLF (\r\n)
Version: (please fill in your CLI/app version here)
Login information
No response
Anything else we need to know?
No response