1. Installation

1.1 System Requirements

• Windows 10 (1809+) or Windows 11 — 64-bit
• Autodesk Revit 2022, 2023, 2024, or 2025
• 4 GB RAM minimum (8 GB+ recommended for AI coach)
• 200 MB free disk space
• Internet connection (for AI inference & licence activation)

1.2 Installing from Autodesk App Store

1. On the Autodesk App Store listing, click Download.
2. Run the downloaded 2DSUITE-Setup-1.0.10.exe.
3. Accept the End User Licence Agreement and click Install.
4. Both the desktop app and the Revit add-in install automatically.
5. Launch Revit — you'll see a new 2DSUITE ribbon tab.

1.3 Installing from djinja-c.com

Go to https://djinja-c.com and click Download Free. The same installer is used — both channels install identical software.

2. Revit Ribbon & Launch Button

After installation, open Revit and look for the 2DSUITE tab on the ribbon. It contains one panel named 2DSUITE with three buttons:

Button	Purpose
Launch 2DSUITE	Starts the 2DSUITE desktop app. If the app isn't installed, a dialog offers a one-click download link.
Bridge Status	Shows the current bridge connection status, last executed command, and any diagnostic messages.
Ping	Writes a proof-of-life record to the bridge status file — useful for diagnosing whether the add-in is loaded.

2.1 How the Bridge Works

The add-in subscribes to Revit's UIControlledApplication.Idling event and polls a local JSON file at %USERPROFILE%\.djinja-revit-bridge.json. When the desktop app writes a command to that file, the add-in picks it up and executes it on the Revit API thread via ExternalEvent.

2.2 Keyboard Shortcut Dispatch

The desktop app's Command Deck dispatches actions via your installed Revit keyboard shortcut map. On first run, export your shortcuts from Revit:

1. In Revit: File → Options → User Interface → Keyboard Shortcuts.
2. Click Export... and save the resulting KeyboardShortcuts.xml.
3. In 2DSUITE: Command Deck → Sync Shortcuts — point it at the exported file.

3. AI Coach Modes

2DSUITE offers five distinct coaching modes. Switch between them via the left sidebar.

Mode	What It Does	Tier
Watch & Suggest	Observes your screen every few seconds and offers context-aware tips. Best for passive guidance while you work.	Free (3/day)
Voice Only	Push-to-talk coaching with spoken responses. Hands-free — great for site visits on a tablet.	Free
Step-by-Step	Structured walkthroughs of complex Revit tasks. The coach waits for you to complete each step before moving on.	Pro
Cross-Reference	Compare up to 25 PDF, DWG, or DOCX documents against your active Revit model. Flags mismatches, missing specs, revision drift.	Pro (5 docs), Studio (25)
Code & Run	The coach generates Python / PowerShell / IronPython snippets and executes them locally with your permission. Output feeds back into the conversation.	Studio

3.1 Coach Personality

Each mode supports five personality styles, set via Profile → Coach Style:

• Warm & Friendly — encouraging, conversational
• Confident & Direct — crisp, professional
• Motivational — upbeat, goal-oriented
• Hardcore Coach — no-nonsense, pushes back on excuses
• Technical Expert — deep-detail, jargon-friendly

4. Command Deck — 168 Revit Actions

Open the Command Deck with the DECK hex button (or D). It surfaces 168 MORECROFTS-style Revit automations grouped into 13 panels:

Panel	Actions
Sheets	Revision increment, transmittal creation, as-built updates, sheet/view creation
Views	3D → sheets, crop to section, hide by sheet, zoom to face/selection
Annotation	Auto-tag, align tags, duplicate cleanup, text-to-type conversion
Admin	Find/replace, purge views, link sync, structure check, bulk delete
QA	COBie pull/push, revision cross-check, database compare
Clash Detection	Run clash, import Navisworks, resolve, clear markers
Results	Clash reports, navigator, CSV export
Workflow	Transmittal generator, upload audit, launcher

Click a tile to execute the action immediately, or Shift + click to ask the coach to explain what it will do first.

4.1 How It Dispatches

Each tile maps to a unique 2–3-letter Revit keyboard shortcut. When you click a tile, 2DSUITE:

1. Focuses the Revit window (via nut-js or AppActivate fallback);
2. Waits 120 ms for Revit to settle;
3. Types the shortcut letters, which Revit matches against its installed keyboard shortcut map.

5. Subscription Tiers

Feature	Free	Pro — £12/mo	Studio — £79/mo	Enterprise — £49–99/seat
Watch & Suggest	3/day	Unlimited	Unlimited	Unlimited
Voice Only	✅	✅	✅	✅
Command Deck (168 actions)	✅	✅	✅	✅
Step-by-Step	—	✅	✅	✅
Cross-Reference (docs)	—	5	25	Unlimited
Code & Run	—	—	✅	✅
Document Creator (9 formats)	—	—	✅	✅
Meeting Recorder + Brief	—	—	—	✅
Email Assistant + Drafts	—	—	—	✅
White-label / SSO	—	—	—	✅

Upgrade from inside the app: Profile → Manage Billing. Cancel any time; no lock-in.

6. Troubleshooting

The 2DSUITE ribbon tab doesn't appear in Revit

1. Close Revit fully.
2. Check the manifest exists: %AppData%\Autodesk\Revit\Addins\<year>\TwoDSuiteBridge.addin
3. Check the DLL exists: %AppData%\Autodesk\Revit\Addins\<year>\TwoDSuite\TwoDSuiteBridge.dll
4. If missing, reinstall 2DSUITE — the installer places both files automatically.
5. Re-launch Revit — accept the "Load" / "Always Load" security prompt.

"Unknown publisher" SmartScreen warning during install

The installer is signed, but Windows SmartScreen reputation takes time to build for new signing certificates. Click More info → Run anyway to proceed. This warning will disappear automatically once the cert accrues enough reputation.

Launch button says "2DSUITE isn't installed"

The Revit add-in couldn't find 2DSUITE.exe on your machine. Install the desktop app from the dialog's Open download page link, or re-run the 2DSUITE installer from Autodesk App Store.

Command Deck tile does nothing

1. Make sure Revit is the foreground window when you click the tile.
2. Check that you've imported the merged shortcut map: Revit → Options → Keyboard Shortcuts → Import → KeyboardShortcuts-2DSUITE.xml.
3. Verify the shortcut exists: inside 2DSUITE, hover the tile — the key code is shown top-right.

AI responses are slow / timing out

Check your internet connection and Claude API status at status.anthropic.com. If you're supplying your own API key (via Profile → API Key), verify it has credit and the correct permissions.

7. Support & Contact

• Email: [email protected]
• Documentation: https://djinja-c.com
• Issue tracker: github.com/carlosmorecrofts-dotcom/djinja-releases/issues
• Response time: Free/Pro — 72 hours. Studio — 24 hours. Enterprise — 4 hours (business days).

© 2026 Djinja-C Limited · All rights reserved
2DSUITE v1.0.10 · EULA · Privacy · Terms