stacklok / stacklok/toolhive-studio
Improve communication around CLI setup and PATH modifications
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 167
- Forks
- 24
- Avg merge
- 11h 32m
- Merged PRs (30d)
- 91
Description
Context
As discussed in #1927, ToolHive Studio currently modifies shell dotfiles (e.g., .bashrc, .zshrc) to add the thv CLI to the user's PATH — without any visible notification or user consent.
This can be surprising, especially for users who carefully manage their dotfiles (e.g., via version control).
Problem
There is currently no communication to the user about:
- What ToolHive Studio is doing to their shell configuration
- That the
thvCLI exists and is being installed - How to manage or undo the changes
What we should explore
- Better surface what's happening during CLI setup (e.g., a dialog, a notification, a first-launch message)
- Provide an option to opt out of automatic PATH modification
- Leverage the existing Settings > CLI page to give users visibility and control
- Use this as an opportunity to educate users about the
thvCLI
The exact approach is open for discussion — the key goal is that users are informed and in control.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the existing CLI setup flow and the Settings > CLI page to understand where PATH changes and user communication are handled. Done means an agreed approach informs users about the thv CLI and shell changes, provides control over automatic PATH modification, and explains how to manage or undo it.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- cli, desktop, developer-experience
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100