Fix: Escaped brackets in pip install to avoid zsh glob expansion

[hgkdzbf6]

Fixed zsh glob pattern issue by escaping square brackets in pip install command. The brackets [misc,sim,...] were being treated as glob patterns by zsh, causing installation to fail. Fixes #1404

[greptile-apps]

Greptile Summary

This PR attempts to fix zsh glob expansion in the pip install command but introduces two critical issues that break the documentation and the installation:

1. Broken code fences: All ```sh / ``` Markdown delimiters have been replaced with \`\`\`sh / \`\`\` (escaped backticks). In standard and GitHub-flavored Markdown, the backslash escapes the first backtick, so the code blocks fail to render — the entire documentation page is broken.

2. Incorrect shell escaping: The fix uses "dimos\[misc,...]". Inside double quotes in bash/zsh, \[ is not a recognized escape sequence; the backslash is passed literally to uv pip install, making the package name dimos\[misc,...] which is invalid and will fail. The correct fix is to use single quotes: 'dimos[misc,...]', or plain double quotes without the backslash: "dimos[misc,...]" — both prevent glob expansion without side effects.

The PR should not be merged as-is — the documentation page is rendered broken, and the actual install command remains non-functional.

Confidence Score: 1/5

• This PR should not be merged — it introduces two critical regressions: broken Markdown rendering (unreadable documentation) and a non-functional install command.
• The PR introduces two critical bugs. First, all code fence delimiters are escaped with backslashes, which breaks Markdown rendering and makes the entire documentation page unreadable. Second, the pip install command uses \[ inside double quotes, which passes a literal backslash to pip, resulting in an invalid package name that will cause installation to fail. The intended fix to address zsh glob expansion is correct in principle (using quotes prevents glob expansion), but the implementation is fundamentally flawed on two fronts.
• docs/installation/osx.md requires a full rework: restore plain backtick code fences (without backslashes) and use single quotes around the package name in the pip install command.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User reads installation docs] --> B{Markdown renders?}
    B -->|Original: Plain backticks| C[Code blocks render correctly]
    C --> D["✓ Readable install instructions"]
    B -->|This PR: Escaped backticks| E[Backticks treated as literal text]
    E --> F["❌ Entire page renders as raw Markdown"]
    
    G[User runs install command] --> H{Shell interprets quotes?}
    H -->|Original: unquoted| I[Brackets trigger zsh glob expansion]
    I --> J["❌ Install fails - no matching files"]
    H -->|This PR: backslash in quotes| K[Backslash passed literally to pip]
    K --> L["pip receives: dimos with backslash bracket"]
    L --> M["❌ Invalid package name"]
    H -->|Correct fix: single quotes| N[Glob expansion suppressed]
    N --> O["pip receives: dimos with brackets"]
    O --> P["✓ Valid syntax - install succeeds"]

Loading

_{Last reviewed commit: 6e5fed8}

[greptile-apps]

Broken markdown code fences throughout the file

All code fence delimiters in the file have been changed from ``` to \`\`\` (escaped backticks). In standard Markdown (and GitHub-flavored Markdown), a leading backslash escapes the first backtick character, so each block will render as literal text (\`\`\`sh) rather than a fenced code block. This completely breaks the documentation layout — none of the install commands will be displayed in formatted code blocks.

The original ```sh / ``` syntax was correct and should be restored. Only the pip install command line needs modification to fix the glob expansion issue.

[greptile-apps]

Backslash inside double quotes passes a literal \ to pip

In both bash and zsh, inside double quotes ("..."), backslash is only treated as an escape character before $, `, ", \, and newline. It is not an escape character before [. This means the shell passes the string dimos\[misc,sim,...] — with a literal backslash — to uv pip install, which is not a valid package extra syntax and will cause the install to fail.

Additionally, the # FIXED: ... inline comment is a development note that is not appropriate for end-user documentation.

The correct fix is to use single quotes (which prevent all shell expansions including glob expansion) or plain double quotes without the backslash (which also suppress glob expansion):

Suggested change

	uv pip install "dimos\[misc,sim,visualization,agents,web,perception,unitree,manipulation,cpu,dev]"
	uv pip install 'dimos[misc,sim,visualization,agents,web,perception,unitree,manipulation,cpu,dev]'

[RadientBrain]

You should not put backslash for quotes:
```

not required, other quote insertion is fine