Planovel AI Employee for AutoCAD - macOS
========================================

Requirements
------------
- macOS 12 or later (Apple Silicon or Intel)
- AutoCAD for Mac 2019 or later (full AutoCAD - AutoCAD LT for Mac cannot load
  plug-ins of any kind, this is an Autodesk limitation)

Install
-------
1. Unzip this download and keep all the files together in one folder.
2. Quit AutoCAD if it is running.
3. Open Terminal in that folder and run:

       ./install-macos.sh

   If macOS refuses to run it, first make it executable:

       chmod +x install-macos.sh uninstall-macos.sh

4. Start AutoCAD. Choose Planovel from the menu bar, or type PLANOVEL at the
   command line.

Commands
--------
  PLANOVEL         Open the floating Planovel palette
  PLANOVELAPPLY    Apply pending drawing changes from the palette
  PLANOVELSIGNIN   Sign in to your Planovel account
  PLANOVELMENU     Rebuild the Planovel menu in the menu bar
  PLANOVELDIAG     Show install and helper diagnostics
  PLANOVELHELP     List these commands

How it works on Mac, and how that differs from Windows
-----------------------------------------------------
AutoCAD for Mac is a genuinely different product from AutoCAD for Windows:

- It cannot load Managed .NET plug-ins. Autodesk supports only AutoLISP and
  ObjectARX on Mac, so the Windows Planovel plug-in cannot run here. The Mac
  build is an AutoLISP client instead.
- It has no ribbon. There is no way to add a ribbon tab on Mac, so Planovel
  appears as a menu in the macOS menu bar rather than as a ribbon tab.
- AutoLISP cannot make network calls. A small background agent, Planovel Helper,
  does the account, network and AI work and hands results back to AutoCAD.

What gets installed
-------------------
  ~/Library/Application Support/Autodesk/ApplicationAddins/Planovel.bundle
      The AutoCAD plug-in. ApplicationAddins is the folder AutoCAD for Mac
      scans at startup (Windows uses ApplicationPlugins).

  ~/Library/Application Support/Planovel/Planovel Helper.app
      The Planovel helper. It hosts the floating Planovel palette (AutoCAD for
      Mac cannot host a Windows-style PaletteSet inside AutoCAD).

  ~/Library/LaunchAgents/com.planovel.helper.plist
      Starts the helper when you log in.

  A "Planovel" menu added to your AutoCAD customization file, because AutoCAD for
  Mac cannot load partial customization (CUIx) files the way Windows can.

Troubleshooting
---------------
Planovel does not appear when AutoCAD starts
  Run PLANOVELDIAG at the AutoCAD command line. It reports whether the plug-in
  files were found and whether the helper is running. Type PLANOVEL to raise
  the floating palette.

The palette is open but the drawing does not change
  Type PLANOVELAPPLY in AutoCAD. macOS may also ask for Accessibility permission
  so Planovel can send that command automatically.

The Planovel menu is missing but the PLANOVEL command works
  Quit AutoCAD and run install-macos.sh again, or run PLANOVELMENU inside
  AutoCAD and then restart AutoCAD.

"Planovel Helper is not running"
  Reinstall, or check
    ~/Library/Application Support/Planovel/bridge/logs/helper.log

Uninstall
---------
       ./uninstall-macos.sh

Support
-------
support@planovel.com
https://planovel.com
