Skip to content
Skills Library
Programming · Building & coding

revit-addin-debugging

/revit-addin-debugging

Configure an Autodesk Revit add-in project's IDE launch of the matching Revit with the debugger attached, using the Nice3point.Revit.Sdk launch properties. USE FOR: setting up a project where a debug session launches the matching Revit and breaks in the add-in, overriding the Revit path or start arguments, and preserving Hot Reload while debugging. DO NOT USE FOR: copying built files to the Revit add-ins folder (use revit-addin-publishing), dependency isolation or repacking (use revit-dependency-isolation).

Licence
MIT
Last repository change
08.10.2026

Assessment and security

98/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene13 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Configure an Autodesk Revit add-in project's IDE launch of the matching Revit with the debugger attached, using the Nice3point.Revit.Sdk launch properties. USE FOR: setting up a project where a debug session launches the matching Revit and breaks in the add-in, overriding the Revit path or start arguments, and preserving Hot Reload while debugging. DO NOT USE FOR: copying built files to the Revit add-ins folder (use revit-addin-publishing), dependency isolation or repacking (use revit-dependency-isolation).

Original author description

Configure an Autodesk Revit add-in project's IDE launch of the matching Revit with the debugger attached, using the Nice3point.Revit.Sdk launch properties. USE FOR: setting up a project where a debug session launches the matching Revit and breaks in the add-in, overriding the Revit path or start arguments, and preserving Hot Reload while debugging. DO NOT USE FOR: copying built files to the Revit add-ins folder (use revit-addin-publishing), dependency isolation or repacking (use revit-dependency-isolation).

How it works

  1. When to use
  2. When not to use
  3. Workflow
  4. Validation
  5. Common Pitfalls
Original SKILL.md headings · 62 lines, 399 words
SKILL.md preview
---
name: revit-addin-debugging
description: >
  Configure an Autodesk Revit add-in project's IDE launch of the matching Revit with the debugger attached, using the Nice3point.Revit.Sdk launch properties.
  USE FOR: setting up a project where a debug session launches the matching Revit and breaks in the add-in, overriding the Revit path or start arguments, and preserving Hot Reload while debugging.
  DO NOT USE FOR: copying built files to the Revit add-ins folder (use revit-addin-publishing), dependency isolation or repacking (use revit-dependency-isolation).
license: MIT
---

# Revit Add-in Debugging

The `Nice3point.Revit.Sdk` makes the IDE's start-debugging action launch Revit and attach the debugger, without a `launchSettings.json`.
Deploy the add-in first (`revit-addin-publishing`); the launched Revit loads the deployed build.

## When to use

- Setting up a project where a debug session starts the right Revit version and breaks in the add-in.
- Pointing the launcher at a non-default Revit install or start arguments.
- Preserving Hot Reload during iterative debugging.

## When not to use

- The build never needs to run under a debugger — plain `DeployAddin` copying is enough (`revit-addin-publishing`).

## Workflow

### Step 1: Enable launch

```xml
<LaunchRevit>true</LaunchRevit>
```

The SDK sets `StartAction=Program`, `StartProgram` to `C:\Program Files\Autodesk\Revit $(RevitVersion)\Revit.exe`, and `StartArguments=/language ENG`; the IDE reads them, starts Revit, and attaches the debugger.
Enable it alongside `DeployAddin` in the project that contains the `.addin` manifest.
Each build deploys the add-in before launch.

### Step 2: Override the target when the defaults are wrong

```xml
<StartProgram>D:\Autodesk\Revit $(RevitVersion)\Revit.exe</StartProgram>
<StartArguments>/language CHS</StartArguments>
```

Set these when Revit is installed off the default path, or when forcing a language or opening a model on start.

### Step 3: Preserve Hot Reload

With `DeployAddin`, repacking (`IsRepackable`) replaces the deployed add-in assembly with a merged assembly on every build.
The loaded assembly then differs from the compiled one, Hot Reload stops applying edits, and the edit–run loop slows down.
For local debugging on Revit 2027+, disable `IsRepackable` and use manifest-level isolation (`revit-dependency-isolation`); reserve repacking for release builds on pre-2027 versions.

### Step 4: Verify

Set a breakpoint in a command, start a debug session, and confirm the matching Revit launches, loads the add-in, and stops at the breakpoint.

## Validation

- [ ] `LaunchRevit` is enabled alongside `DeployAddin` in the project that contains the `.addin` manifest.
- [ ] `StartProgram`/`StartArguments` are overridden only when the defaults do not fit.
- [ ] `IsRepackable` is off for debug builds; isolation covers dependency conflicts.

## Common Pitfalls

| Pitfall                                              | Correct approach                                                             |
|------------------------------------------------------|------------------------------------------------------------------------------|
| Looking for a `launchSettings.json`                  | The SDK defines the launch in `LaunchRevit`/`StartProgram`/`StartArguments`. |
| A debug session starts Revit but the add-in is stale | Enable `DeployAddin`; the build deploys before launch.                       |
| Hot Reload does nothing while repacking is on        | Disable `IsRepackable` for debug; isolate dependencies via the manifest.     |
| The wrong Revit year launches                        | `StartProgram` uses `$(RevitVersion)`; select the matching configuration.    |

Versions

The database has no other skills named revit-addin-debugging.

Database snapshot: 13.11.2026 · package version 67d34e844cc7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100revit-addin-publishing
    Configure an Autodesk Revit add-in project to copy the add-in, .addin manifest to the local Revit or a `bin/publish` folder, using the Nice3point.Revit.Sdk publish targets. USE FOR: setting up a project for publishing, bundling extra content into the output, and relying on…
  • 100revit-addin-bundle
    Package a versioned Autodesk Revit add-in as an Autodesk App Store bundle with the Nice3point.Revit.Templates ModularPipelines build. USE FOR: setting the bundle vendor metadata and version, and running the build to produce a versioned .bundle with per-Revit-year contents for…
  • 90revit-ai-test-automation
    指导 AI 编码助手为 Windows 上的 Revit 二次开发建立并尽可能自动完成测试,涵盖场景设计、测试代码生成、构建、模型副本执行、结果诊断和回归验证。使用 PowerShell 与 Revit API,适用于插件测试框架搭建和业务回归;界面与正式命令入口按实际工具能力追加验证。
  • 90revit-bim
    Revit BIM expertise for all building professionals. Use when the user asks to design a building, create walls, add floors, place columns, route MEP systems, create structural framing, add dimensions, tag elements, create sheets, export drawings, query the model, analyze…
  • 98inventor-addin-scaffold
    Scaffold a production-quality Autodesk Inventor 2025+ add-in project targeting .NET 8 (`net8.0-windows`). Generates a Clean-Architecture-shaped solution with a COM-hosted entry point, a ribbon installer, an example command that demonstrates the boundary try/catch pattern, an…
  • 98open-point-cloud
    Link a PLY or E57 point cloud into a Revit model with the Open Point Cloud add-in, from an agent or a script. Use it when a user asks to link, import or check a PLY or E57 point cloud in Revit.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.