Skip to content

Document CLI and UI coexistence for version alignment#519

Open
samuv wants to merge 7 commits intomainfrom
cli-alignment
Open

Document CLI and UI coexistence for version alignment#519
samuv wants to merge 7 commits intomainfrom
cli-alignment

Conversation

@samuv
Copy link
Contributor

@samuv samuv commented Feb 4, 2026

Description

Document the CLI and UI version alignment feature, explaining how ToolHive UI
manages CLI installation automatically and what happens when a standalone CLI
conflicts with a UI-managed installation.

Changes include:

  • New guide: "Access the CLI from ToolHive UI" covering CLI management, the
    Settings > CLI page, and troubleshooting
  • New section in CLI install guide explaining conflict detection and resolution
  • Updated tips in UI and CLI index pages
  • New FAQ entry about CLI/UI coexistence

Type of change

  • New documentation
  • Documentation update
  • Navigation/structure change

Related issues/PRs

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Navigation

  • New pages include a frontmatter section with title and description at a minimum
  • Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files

@samuv samuv self-assigned this Feb 4, 2026
@vercel
Copy link

vercel bot commented Feb 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment Feb 5, 2026 2:05pm

Request Review

samuv added 5 commits February 5, 2026 12:05
Document how ToolHive UI manages CLI installation, the Settings > CLI
page, and troubleshooting for CLI access issues.
Revise tips in UI and CLI index pages to reflect that ToolHive UI
manages CLI installation automatically.
Document conflict detection when standalone CLI runs alongside
ToolHive UI, including error message and resolution options.
Link to new CLI access guide in the Next steps section.
Explain that ToolHive UI and standalone CLI cannot be used together.
@samuv samuv marked this pull request as ready for review February 5, 2026 12:47
Copilot AI review requested due to automatic review settings February 5, 2026 12:47
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request documents the CLI and UI version alignment feature, which ensures that ToolHive UI automatically manages a compatible CLI installation. The documentation explains how the UI manages the CLI, what happens when conflicts occur with standalone CLI installations, and how users can access CLI functionality from the UI.

Changes:

  • New guide explaining CLI access from ToolHive UI, including management, settings, and troubleshooting
  • Updated CLI install guide with a new section on CLI/UI coexistence and conflict resolution
  • Added tips and information boxes across UI and CLI guides to inform users about the relationship between the two
  • New FAQ entry clarifying that ToolHive UI and standalone CLI cannot coexist

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
sidebars.ts Adds navigation entry for the new CLI access guide in the UI guides section
docs/toolhive/guides-ui/cli-access.mdx New comprehensive guide covering CLI management by ToolHive UI, Settings page details, usage instructions, and troubleshooting
docs/toolhive/guides-ui/install.mdx Adds tip directing advanced users to the CLI access guide after installation
docs/toolhive/guides-ui/index.mdx Updates tip to clarify that UI includes and manages CLI automatically
docs/toolhive/guides-cli/install.mdx Adds new section explaining conflict detection, resolution steps, and debugging override
docs/toolhive/guides-cli/index.mdx Updates tip to inform users that UI automatically manages CLI if installed
docs/toolhive/faq.mdx Adds FAQ entry explaining CLI/UI coexistence behavior and linking to relevant guides

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant