BoxClaude

Box your Claude Code. Pick exactly which files and folders your AI coding agent can see — nothing more. Scope is saved to your chosen agent file and remembered between sessions.

Install

From the VSCode Marketplace

Search BoxClaude in the Extensions panel, or open the Command Palette and run:

ext install RockieYang.BoxClaude

From a VSIX file

1. Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Run Extensions: Install from VSIX...
3. Select the .vsix file

Or via the terminal:

code --install-extension BoxClaude-<version>.vsix

The Problem

Claude Code roams your entire project by default. It touches files far outside your intent, introduces scope creep, silently alters unrelated code, and runs out of context mid-feature. BoxClaude puts you back in control.

Features

Box by folder or file — Set your scope at any granularity: an entire module, a handful of files, or one single source file.

Multi-agent support — Write scope to any agent file: AGENTS.md (Claude Code, Continue, Devin, OpenHands), CLAUDE.local.md (Claude Code private), .cursorrules (Cursor), or .github/copilot-instructions.md (Copilot). Configure which files to write in the Target Agents panel.

Folder dependency graph — Visualize folder-level import relationships as an interactive graph. See the big picture before scoping Claude.

File dependency graph — Drill into individual file dependencies for fine-grained exploration. Pan, zoom, and explore before you decide what Claude sees.

Call hierarchy — Inspect function-level call chains within your codebase. Understand who calls what before Claude starts editing.

Cyclic dependency detection — Cycles are highlighted in red using DFS coloring. Understand your architecture before Claude starts editing.

Locate in Graph — Right-click any file in the Explorer and jump straight to its node in the open graph panel. The viewport pans and the node is selected.

Smart folder exclusion — Common system and package directories (node_modules, .venv, __pycache__, venv, target, vendor, Pods, coverage, etc.) are excluded from graph analysis by default. Add more via the boxclaude.excludeFolders setting.

Context menu integration — Right-click any file or folder in the VSCode Explorer. Add, remove, or reset your Box in one click.

Visual Box badges — Files in your Box are marked with a ◆ badge in the Explorer — always know what's in scope at a glance.

Clickable scope notifications — After saving scope, a notification appears with an Open button that opens the scope file directly.

How It Works

1. Right-click in the Explorer

Select a file or folder → Set as Claude Box. Claude is now scoped to exactly there.

2. Scope is saved to your agent file

BoxClaude writes your selection to the configured agent file(s). Default is AGENTS.md — supported by Claude Code, Continue, Devin, and OpenHands. You can also enable CLAUDE.local.md (gitignored, Claude Code only) in the Target Agents panel.

3. Add more folders as needed

One folder too narrow? Add more to your Box as the feature grows.

4. Surgical precision — one file at a time

Add individual files to your Box. Claude sees only what you have explicitly allowed.

5. Claude becomes oriented to your work

With your Box defined, Claude's context is sharp and focused. It knows exactly where it is and where it can work.

6. Open the dependency graph

Visualize your codebase, then set your Box from there with full context.

7. Click to scope from the graph

Click any node in the dependency graph to add it to your Box.

8. Catch cycles before Claude does

BoxClaude detects and highlights cyclic dependencies in red. Fix your architecture first — then let Claude in.

9. Configure BoxClaude

Tune BoxClaude settings to match your workflow.

Target Agents

Open the welcome panel (BoxClaude: Show Welcome) and scroll to Target Agents to choose which files BoxClaude writes to:

All checked files receive the same scope content on every save.

Supported Languages

C, C++, C#, CSS, Go, Java, JavaScript, Python, Rust, Swift

Commands