Skip to content

Conversation

@simplesagar
Copy link
Member

@simplesagar simplesagar commented Nov 11, 2025

Summary

  • Add --scope flag to gram install command to control MCP server installation location
  • Support both user (default) and project scope levels
  • Apply scope across Claude Code and Gemini CLI installations

Changes

  • New flag: --scope with values user (default) or project
    • user: Installs to ~/.claude/settings.local.json (user-level config)
    • project: Installs to .mcp.json in current directory (project-level config)
  • Claude Code: Updated to pass scope to both native claude CLI and fallback config file writer
    • Maps projectlocal for Claude CLI compatibility
  • Gemini CLI: Updated to pass scope parameter to gemini mcp add command
  • Default behavior: Changed to user scope for better portability across projects

Usage Examples

# Install to user-level config (default)
gram install claude-code --toolset my-toolset

# Install to project-level config
gram install claude-code --toolset my-toolset --scope project

# Install using Gemini CLI
gram install gemini-cli --toolset my-toolset --scope user

Test plan

  • Build succeeds: mise build:cli
  • Linting passes: mise lint:cli
  • Manual testing with Claude Code installation (both scopes)
  • Manual testing with Gemini CLI installation (both scopes)

🤖 Generated with Claude Code

Add support for configuring MCP server installation scope across all
supported clients (Claude Code, Gemini CLI). Users can now choose
between 'user' (~/.claude/settings.local.json) and 'project'
(.mcp.json in current directory) scopes.

Changes:
- Add --scope flag to install command (defaults to 'user')
- Update Claude Code installation to respect scope in both native CLI
  and config file fallback modes
- Update Gemini CLI installation to pass scope parameter
- Map 'project' scope to 'local' for Claude CLI compatibility

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@simplesagar simplesagar requested a review from a team as a code owner November 11, 2025 04:24
@changeset-bot
Copy link

changeset-bot bot commented Nov 11, 2025

🦋 Changeset detected

Latest commit: b411271

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
cli Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
Copy link

vercel bot commented Nov 11, 2025

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

Project Deployment Preview Comments Updated (UTC)
gram Ready Ready Preview Comment Nov 11, 2025 4:28am
gram-docs-redirect Ready Ready Preview Comment Nov 11, 2025 4:28am
gram-landing-redirect Building Building Preview Comment Nov 11, 2025 4:28am

@simplesagar simplesagar merged commit b8ed917 into main Nov 11, 2025
18 checks passed
@simplesagar simplesagar deleted the feat/install-command-scopes branch November 11, 2025 04:32
@github-actions github-actions bot locked and limited conversation to collaborators Nov 11, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants