AutoCAD

SphereHarness works in AutoCAD as a drafting assistant: lines, arcs, blocks, xrefs, layers, annotation and drafting symbols, layouts and plotting. AutoCAD is not a feature-based modeller, so this page is as much about what SphereHarness does not do here as what it does — and it is specific about both.

Read this first if you are coming from one of the 3D systems. There is no feature tree in a DWG, no parametric sketch, no assembly and no solid modelling on this backend. Requests for them are refused by name rather than approximated, and the refusal usually names the AutoCAD equivalent to use instead.

Versions

  • AutoCAD 2026 is the supported release.
  • AutoCAD LT is not supported, and cannot be — LT has no plug-in platform at all. SphereHarness requires full AutoCAD.
  • The verticals — Mechanical, Electrical, Civil 3D, Plant 3D, Architecture, Map 3D — load the plug-in and work at plain-AutoCAD level. Their own object models are not addressed.
  • AutoCAD for Mac and AutoCAD Web are out of scope.

Installation and where SphereHarness appears

SphereHarness installs for AutoCAD as an Autodesk plug-in bundle that loads automatically when AutoCAD starts — there is nothing to enable per session. Your administrator handles this; if the tab is missing after a restart, see Troubleshooting.

You get a ribbon tab called SphereHarness with one panel and five buttons:

ButtonCommandWhat it does
MacrosCOPILOTMACROSOpens the macro library in the desktop agent. See Macros.
VariationsCOPILOTVARIATIONSOpens the variations dialog. See Variations.
Stop Connection / Restart ConnectionCOPILOTCONNSTOP / COPILOTCONNRESTARTOne toggle; the caption tells you the current state.
ReconnectCOPILOTRECONNECTRe-reads your sign-in and reconnects this AutoCAD session to the desktop agent — use it after you sign in. No AutoCAD restart needed.
Desktop AgentCOPILOTAGENTOpens the chat. COPILOT does the same.
HelpCOPILOTHELPOpens this documentation.
The chat is not inside AutoCAD. You talk to SphereHarness in the desktop agent — the floating balloon, the quick ask bar or the chat card — and it drives your AutoCAD session from there. All five commands work with no drawing open.

AutoCAD gets five ribbon buttons where the 3D systems get nine. The four that are missing — Part from Drawing/PDF/Image, Part from Mesh, Drawing from Reference and Refeature Solid — all produce 3D parts, which this backend cannot do. They are omitted rather than shown and refused.

Units: check this before anything else

A DWG has no inherent units, and AutoCAD's own default template is imperial. SphereHarness always talks in millimetres. A drawing it creates starts from acadiso.dwt with INSUNITS set to millimetres. A drawing you opened is converted from whatever INSUNITS says — and if INSUNITS is unset, SphereHarness assumes millimetres and says so in every reply (“unitless (assumed mm)”). If you see that and the drawing is really inches, set INSUNITS before going further.

What SphereHarness can do in AutoCAD

Drawing and editing 2D geometry

Lines, circles, arcs (by centre and angles, or by three points), ellipses, splines through fit points, rectangles and regular polygons. Move, rotate, copy, mirror, offset, uniform scale, erase, and rectangular or polar arrays.

Draw a 120 x 80 rectangle at (0,0), then offset it 5 mm inwards
Array the Ø8 circle at (20,20) six times at 25 mm spacing along X

Every entity is reported by its AutoCAD handle — the same hexadecimal id AutoCAD itself uses, which survives saving and reopening — so you can refer back to exactly what was created.

Annotation and drafting symbols

Notes as MText, and proper drafting symbols rather than drawn approximations:

  • Geometric tolerance — a native AutoCAD feature control frame, all fourteen characteristics, plus datum symbols.
  • Weld symbols to ISO 2553, including all-around and field-weld flags.
  • Surface-finish symbols to ISO 1302, with Ra value, production method and lay direction.
  • Balloons in five shapes, with leaders.
  • Centre marks on circles and arcs, on the CENTER linetype.
  • Detail views — a real scaled, circularly clipped block reference with a source marker, boundary circle and a “DETAIL A (2:1)” label, lettered automatically.
Add a flatness 0.05 feature control frame at (60, 40) with a leader to the top edge
SphereHarness cannot create dimensions in AutoCAD. It can list, select and re-layer the dimensions that are already in a drawing, but it has no dimension-creation operation here. To add one, have it run AutoCAD's own command — DIMLINEAR, DIMRADIUS and so on — and answer the prompts. This is the one place where the 3D systems are meaningfully ahead; see Drawings & Dimensions for what they do.

Blocks and xrefs

Blocks are AutoCAD's re-use mechanism, and SphereHarness treats them as first-class: create a block from selected entities (attributes and nested references carried across), insert a reference from a file or from a definition already in the drawing, and read back the block name, scale, rotation and attribute values.

External references get the full set: attach and overlay, detach, bind, repath, and reload or unload. Listing the drawing's references reports nested xrefs hierarchically, with each one's path and AutoCAD's own load status.

List every xref in this drawing with its path and load state
Repath the FRAME xref to C:\refs\FRAME-rev-C.dwg and reload it
Binding only works on an xref that is currently resolved. An unloaded or missing one is refused by name, with the fix named: reload it, or repath it first. Binding uses bind style, so nothing of the xref is merged over your host layers.

Layers and linetypes

Create a layer with its colour, linetype and current-status in one go; turn layers on and off, freeze, thaw, lock, unlock, delete; read back every layer's colour, linetype, lineweight, transparency, state and how many entities are on it. Linetypes load from the standard pattern files automatically, and everyday names (“dashed”, “dash-dot”, “centre”) are understood.

Create a layer called DIMS, colour 3, linetype CONTINUOUS, and make it current
Move every dimension in the drawing to the DIMS layer
A layer move has to say what it moves. “Move things to layer X” with neither a list of entities nor a kind is refused rather than treated as “everything” — that ambiguity once relocated forty-one entities nobody meant to touch. Name the handles, or name a kind (curves, text, dimensions, blocks, hatches, all).
Notes and symbols land on the current layer, exactly as they do when you draw them yourself. Make the layer you want current before asking for annotation, or it inherits whatever was last set.

Layouts and plotting

Model space and every existing layout are addressable as places to put geometry and annotation — say which one you mean and SphereHarness draws there. Export supports PDF (a real plot through the standard PDF plotter), DXF and DWG, and each export is verified on disk afterwards, so a plot that produced no file is reported as a failure rather than a success.

Plot Layout1 to C:\out\sheet1.pdf
  • SphereHarness cannot create, rename or delete a layout. The layout must already exist in the drawing or its template.
  • Only the current layout can plot, so SphereHarness switches to the one you asked for, plots, and switches your tab back. You may see the tab flick.
  • A layout plots at 1:1 — AutoCAD refuses scale-to-fit and centring for layout plots. Only model space is fitted and centred.

Selection, properties and preferences

SphereHarness can set AutoCAD's real pick set — and it reads it back, so it only claims a selection that the drawing agrees with. You can select by kind (curves, lines, circles, arcs, polylines, text, dimensions, blocks, hatches, leaders, feature control frames…), by a name substring, or by pattern, and add to, remove from, replace or clear the current selection.

Select every block whose name starts with VALVE-
What is currently selected?

Drawing properties (title, author, revision, and your own custom properties) can be read and written. System variables and the Options tree can both be read and set — and for variables where the number means something, the reply says what it means rather than leaving you to look it up.

What is LUPREC set to, and what does that mean?

Running any AutoCAD command

Whatever is not covered above is still reachable: SphereHarness can search a catalogue of AutoCAD's commands — including where each one lives on the ribbon — and run one by name with its option keywords.

Search the AutoCAD commands for anything about hatching, then run HATCH

This is the escape hatch for dimensioning, hatching, PDF import and anything else without a direct operation. See When a Dialog Appears for how SphereHarness handles a command that stops and asks.

3D solids that already exist

If your DWG contains 3D solids, SphereHarness can inspect and lightly edit them: list their faces with type, outward normal, area, radius and bounding box; push a named face along its normal to add or remove material, with the volume measured before and after; and scale a solid uniformly.

It cannot create them. Extrude, revolve, sweep, loft, boolean, fillet, chamfer, shell, draft, hole and thread are not available in AutoCAD, and there is no STEP, IGES, STL or SAT export. If you need to build a solid, build it in one of the 3D systems.

What is not available in AutoCAD

These are refused by name, with the reason — you will never get a fabricated success:

  • 3D solid modelling — every creation feature, and every boolean and surfacing operation.
  • A feature tree — there is no history in a DWG. AutoCAD's own UNDO is the way back.
  • Parametric sketches and constraints — coincident, concentric, tangent, dimensional and the rest.
  • Assemblies and mates — the AutoCAD equivalents are xrefs and block references, and those are supported.
  • Faces, edges and vertices of 2D geometry — a 2D drawing has none. Face-flavoured requests are refused and told what is selectable.
  • Mass properties and materials — there is no density in a DWG.
  • Sheet metal, simulation, CAM, nesting, and mould or casting tooling.
  • Equations, design tables and configurations.
  • Datum planes, axes, points and coordinate systems.
  • Creating dimensions, layouts, hatches, BOM tables and drawing tables — use AutoCAD's own commands for these.
  • Recording a native AutoCAD macro or running an external script through SphereHarness. AutoCAD's own SCRIPT and LISP can still be launched as commands.

Macros, variations and the markup board on AutoCAD

  • Macros work. The recorder captures the SphereHarness operations you run against AutoCAD, and a macro replays them as one approved run — the same as on any other CAD. What is not available is recording AutoCAD's own native macro format.
  • Variations are limited to custom properties. A DWG has no features, parameters, materials or configurations to drive, so that is the only kind a template can capture here.
  • The markup board works, but cannot pick a face. You can draw on an AutoCAD screenshot and discuss it, and the camera is reported accurately — but the underlying face lookup is not implemented for AutoCAD, so asking “what did I circle?” always comes back with no face. Note also that a screenshot of a paper-space layout carries no camera at all, by design: each floating viewport shows model space at its own scale, so there is no single camera to report.

Three more things worth knowing

  • Screenshot sizes are approximate. AutoCAD reshapes a capture to the viewport's aspect ratio, so asking for 1000×1000 may give you 1000×424. SphereHarness reports the size of the image it actually wrote, not the size you asked for — crop afterwards if you need exact.
  • A 2D drawing asked for an isometric view is shown from the top instead, with a note saying so. An oblique view of a flat plan is never what was meant.
  • Word reports cannot be generated from inside AutoCAD. AutoCAD ships its own copy of the document library and wins the conflict. Excel and PDF output work normally.

See also