ClaudeMods
☰
EN
● — online · Views — times
SponsorsSubmit a project
GitHub repositories · by shimo4228

harness-scope

# harness-scope The Claude Code Mod itself: the folder Claude Code installs. It turns your global skills, agents, instruction files (CLAUDE.md and rules) and tools on or off per repo, using named profiles you keep in `~/.claude/harness-scope/profiles/`. A repo picks one profile with a one-line `.claude/harness-scope.json`; the repo's own skills, agents and CLAUDE.md always stay.

shimo4228@shimo4228

shimo4228/harness-scope/tree/main/plugin

Translated

About this mod

harness-scope is a Claude Code plugin that turns global skills, agents, instruction files and tools on or off per repository using named profiles stored in ~/.claude/harness-scope/profiles/. A repo selects a profile via a one-line .claude/harness-scope.json; the repo's own skills, agents and CLAUDE.md are always preserved. Hooks handle SessionStart, session.start (registers /harness-scope), command.run, prompt.context, prompt.attachment, agent.offer, tool.describe and tool.call. With no config file or an unreadable profile, every hook passes through unchanged.

Installation

Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.

claude plugin marketplace add shimo4228/harness-scope
claude plugin install harness-scope
Original text / README

harness-scope

The Claude Code Mod itself: the folder Claude Code installs. It turns your global skills, agents, instruction files (CLAUDE.md and rules) and tools on or off per repo, using named profiles you keep in ~/.claude/harness-scope/profiles/. A repo picks one profile with a one-line .claude/harness-scope.json; the repo's own skills, agents and CLAUDE.md always stay.

You decide what is hidden. Nothing changes in a repo until you put that file there, and the file can only name one of your profiles. Run /harness-scope to see what the profile turned off.

Examples

  1. A writing repo that sees only its own skills. Put { "profile": "writing" } in the repo's .claude/harness-scope.json. The bundled writing profile keeps the repo's own skills, the Explore and general-purpose agents, and turns off LSP, NotebookEdit, EnterWorktree and ExitWorktree.
  2. Keep a few global skills in a docs repo. Save ~/.claude/harness-scope/profiles/docs.json as { "skills": { "allow": ["prose-translation", "anthropic-skills:docx"] } } and select docs in the repo. Every other global, plugin and built-in skill drops out of the listing there.
  3. Hide coding rules and an MCP server's tools in a research repo. Save { "instructions": { "deny": ["~/.claude/rules/common/testing.md"] }, "tools": { "deny": ["mcp__github__*"] } } as a profile and select it. That rule file is not loaded, and the matching tools are refused when called.

What each hook does

| Hook | What it changes | |---|---| | classic.SessionStart | Nothing in the session. On /clear and resume it forgets the loaded profile so the next request reads it again. | | session.start | Registers the /harness-scope command. | | command.run | Answers /harness-scope with the list of what the profile turned off. Other commands pass through untouched. | | prompt.context | Removes your own instruction files (kind user) that the profile turns off. Project, local, managed and memory files are never removed. | | prompt.attachment | Removes turned-off skills from the skill listing and turned-off tools from the deferred tool list. Reminders from hooks and other plugins pass through untouched. | | agent.offer | Stops offering agent types the profile turns off. The repo's own agents are always offered. | | tool.describe | Moves turned-off tools behind ToolSearch. | | tool.call | Refuses calls to turned-off tools, and Skill calls to skills it removed from the listing, with the reason. |

With no .claude/harness-scope.json, or with a profile it cannot read, every hook passes everything through unchanged.

Data

The Mod reads the profile files in ~/.claude/harness-scope/profiles/, the repo's .claude/harness-scope.json, and Claude Code's session usage (only to tell the repo's own skills apart). It reads no environment variables: it finds ~/.claude from where the plugin is installed, or from the optional configDir setting. It writes nothing, sends nothing over the network, starts no processes and calls no model.

Usage, the profile format, measurements and limitations are in the README of the shimo4228/harness-scope repository on GitHub.

Get a badge

Is this your project? Add this badge to your README or website. It links back to this page.

Featured on ClaudeMods
Size
Theme
Markdown
HTML

Similar projects