Options
The command-line flags each Fuse command accepts, with types and defaults.
Fuse commands take a workspace path and a small per-command option set. This page lists the current public CLI options. The MCP parameters are separate and are documented in Tools.
This page is for engineers and maintainers who need exact flag behavior and defaults. Types use these conventions: bool is a switch, int is a whole number, string is a single value, and string[] is a repeatable or space-separated list.
Purpose and scope
Run fuse index before one-shot CLI read commands. MCP read tools build the index on first use. Current context, review, and reduce commands always redact detected secrets before returning source; they expose no redaction-disable flag.
fuse index
| Flag | Type | Default | Description |
|---|---|---|---|
path | string | . | Workspace directory to index. |
--semantic | bool | false | Continue through compiler analysis after syntax indexing. Requires one workspace target. |
--force | bool | false | Force a full re-index instead of an incremental update. |
--from-capture | string | None | Rehydrate from a compatible fuse capture bundle instead of building. |
--json | bool | false | Emit JSON Lines progress snapshots. |
fuse map
| Flag | Type | Default | Description |
|---|---|---|---|
path | string | . | Workspace directory to map. |
--detail | string | symbols | What to include: symbols, routes, or all. |
--max-rows | int | 200 | Maximum rows per section. |
fuse find
Use kind to select exact lookup, wiring resolution, graph facts, or task localization.
| Flag | Type | Default | Description |
|---|---|---|---|
query | string | required | Name, path fragment, text, wiring identifier, or task description. |
path | string | . | Workspace directory. |
--kind | string | all | symbol, path, text, all, service, request, route, config, signatures, neighbors, or task. |
--changed-since | string | None | Git base ref whose changed files seed task candidates. |
--max-candidates | int | 50 | Maximum task candidates or graph neighbors. |
--strict | bool | false | Return only a navigation map when a task has insufficient signal. |
--expand | bool | false | Add graph neighbors to task candidates. |
fuse context
| Flag | Type | Default | Description |
|---|---|---|---|
path | string | . | Workspace directory. |
--seed | string[] | None | A named seed (symbol, service, request, or config section). Repeatable. |
--route | string[] | None | A route seed, for example POST /api/orders/{id}. Repeatable. |
--depth | int | 2 | Graph expansion depth. |
--max-tokens | int | None | Planning budget. Named seeds are must-keep and can make the result exceed this value. |
--format | string | xml | Output format: xml, markdown, or json. |
--plan-only | bool | false | Print the plan without rendering source bodies. |
--handoff | bool | false | Emit a PR handoff packet instead of review context. |
--check-session | string | "" | Gate a handoff on this check-session id. |
fuse impact
| Flag | Type | Default | Description |
|---|---|---|---|
symbol | string | required in symbol mode | Symbol whose blast radius to compute. |
--path | string | . | Workspace directory. |
--limit | int | 50 | Maximum impacted items. |
--package | string | None | NuGet package id for package-upgrade mode. |
--from-version | string | None | Current package version. |
--to-version | string | None | Target package version. |
The three package options are required together and replace symbol mode.
fuse test
| Flag | Type | Default | Description |
|---|---|---|---|
symbol | string | required | Symbol whose covering tests to run. |
--path | string | . | Workspace directory. |
--limit | int | 20 | Maximum covering test types. |
fuse review
| Flag | Type | Default | Description |
|---|---|---|---|
path | string | . | Workspace directory. |
--changed-since | string | HEAD | Git base ref to diff against (branch, commit, or HEAD~N). |
--max-tokens | int | None | Token budget; changed files are always kept. |
--include-tests | bool | true | Include related test files in the blast radius. |
--format | string | xml | Output format: xml, markdown, or json. |
--plan-only | bool | false | Print the plan without rendering source bodies. |
fuse find
| Flag | Type | Default | Description |
|---|---|---|---|
query | string | required | The name, path fragment, or text to find. |
--path | string | . | Workspace directory. |
--kind | string | all | Restrict to one kind: symbol, path, text, or all. |
fuse diagnostics
| Flag | Type | Default | Description |
|---|---|---|---|
path | string | . | Workspace directory whose index state to report. |
fuse reduce
Compact a known set of files or piped content without walking a directory. Pass --files or --stdin, not both.
| Flag | Type | Default | Description |
|---|---|---|---|
--files | string[] | None | File paths to reduce (space-separated). Mutually exclusive with --stdin. |
--stdin | bool | false | Read content to reduce from standard input. Mutually exclusive with --files. |
--ext | string | .cs | Extension that selects the reducer for --stdin content (for example .cs, .ts, .py). |
--level | string | standard | Reduction level: none, standard, aggressive, skeleton, or publicApi. |
--directory | string | . | Base directory for resolving relative --files paths. |
--max-tokens | int | 0 | Output ceiling (0 means no limit). Reduction can truncate at this ceiling; it does not preserve every declaration. |
The reduction levels and what each does to C# are in Reduction levels.
Reduction levels
fuse reduce --level selects C# structural reduction. fuse context chooses a render tier per file and maps that tier to a reduction level internally.
| Level | What it does to C# |
|---|---|
none | No language-specific structural reduction; shared normalization and secret redaction still apply. |
standard | Removes comments, using directives, namespace wrappers, and #region directives. |
aggressive | The standard removals plus whitespace and syntax compression. |
skeleton | Emits type and member signatures, bodies removed. |
publicApi | Like skeleton, but keeps only public and protected members. |
These levels reduce text for context. They do not promise compilable output, semantic equivalence, or retention of private implementation detail. skeleton and publicApi intentionally remove bodies.
Legacy Fusion Pipeline Options
The codebase retains a legacy directory-fusion pipeline used by internal benchmark and compatibility commands. Flags such as --tokenizer, --output, --name, --no-manifest, --provenance, --git-stats, --split-tokens, --include-metadata, --no-redact, --redact-report, and --report belong to that pipeline. They are not options on the current fuse context, fuse review, or fuse reduce commands.
Other commands
fuse mcp serve takes no command options. fuse mcp install accepts --client, --scope, --command, --no-rules, and --with-hooks. fuse mcp doctor accepts --client, --scope, --with-hooks, and --json. See Commands for behavior.
Next
Continue to the Configuration keys reference to set defaults in a file, or to Scoping for how find and review seed the graph.