Check whether Adobe Illustrator is running and, if so, its version and how many documents are open. This does NOT launch Illustrator, so it is a safe first call to verify the connection.

Create a new Illustrator document. Launches Illustrator if it is not already running.

Args:

• width, height (number): canvas size in the chosen unit

• unit ('pt'|'px'|'mm'|'cm'|'in'): default 'px'

• color_mode ('RGB'|'CMYK'): 'RGB' for screen, 'CMYK' for print (default 'RGB')

• artboards (number): number of artboards (default 1)

Returns the new document's name, size in points, and color mode.

Open an existing file in Illustrator (.ai, .pdf, .eps, .svg, and other supported formats).

Args:

• path (string): absolute path to the file to open.

List all documents currently open in Illustrator, marking the active one.

Save the active document. With no 'path', saves in place (the document must already have a file). With a 'path', saves a copy in the given format.

Args:

• path (string, optional): absolute destination path

• format ('ai'|'pdf'|'eps'): used only when 'path' is given (default 'ai').

Close the active document.

Args:

• save (boolean): save changes before closing (default false).

Export the active document to an image or PDF.

Args:

• path (string): absolute destination path (include the extension)

• format ('png'|'jpg'|'svg'|'pdf'): default 'png'

• scale (number): raster scale in percent, e.g. 200 = 2x (default 100)

• transparent (boolean): PNG transparency (default true)

• artboard_index (number, optional): export a specific artboard (0-based)

PNG/JPG are clipped to the active artboard.

Get an overview of the active document: name, color mode, size, artboards, layers, item and selection counts. Use this to understand the current state before making changes.

List the currently selected objects with their type, name, position and size (artboard-relative, Y down).

List all layers in the active document with visibility, lock state and item counts.

List all artboards in the active document with their index, name and size in points.

Draw a rectangle (optionally rounded) on the active document.

Coordinates/sizes are in points, from the top-left of the active artboard, Y down. Args: x, y (top-left), width, height, optional corner_radius, fill, stroke, strokeWidth, name.

Draw an ellipse/circle. The x,y,width,height describe its bounding box (top-left origin, Y down). Args: x, y, width, height, optional fill, stroke, strokeWidth, name.

Draw a straight line between two points (x1,y1) and (x2,y2), top-left origin, Y down. Args: x1, y1, x2, y2, optional stroke (default black), strokeWidth (default 1), name.

Add a text object.

Args:

• text (string): the text content

• x, y (number): top-left position (Y down)

• font_size (number): size in points (default 24)

• font (string, optional): PostScript font name, e.g. 'ArialMT', 'Helvetica-Bold'

• fill (color, optional): text color

• name (string, optional)

Place a raster/vector image file into the active document (linked, or embedded).

Args:

• path (string): absolute path to the image

• x, y (number): top-left position (default 0,0)

• width, height (number, optional): resize to these dimensions in points

• embed (boolean): embed instead of link (default false)

• name (string, optional)

Move, rotate and/or scale the currently selected objects.

Args (all optional, applied in order move -> rotate -> scale):

• dx, dy (number): move by this many points (dy positive = down)

• rotate (number): rotation in degrees (counter-clockwise positive)

• scale (number): uniform scale in percent (100 = no change)

• scale_x, scale_y (number): non-uniform scale in percent (used if 'scale' omitted).

Change fill/stroke of the selected objects. For text objects, 'fill' recolors the text.

Args: fill (color), stroke (color), strokeWidth (number). Provide at least one.

Change the stacking order of selected objects.

Args:

• order ('front'|'back'|'forward'|'backward').

Align selected objects relative to the active artboard.

Args:

• horizontal ('left'|'center'|'right'), optional

• vertical ('top'|'middle'|'bottom'), optional.

Delete all currently selected objects.

Group the selected objects into one group, or ungroup selected groups.

Args:

• action ('group'|'ungroup'), default 'group'.

Create a new layer in the active document and make it active. New artwork is created on the active layer.

Args:

• name (string).

Make an existing layer the active one (subsequent new artwork goes here).

Args:

• name (string): the layer name.

Select all objects in the active document.

Clear the current selection.

Select objects by their name (assigned when created). Clears the previous selection first.

Args:

• name (string): name (or substring) to match

• exact (boolean): require an exact match (default false).

Turn a raster image (PNG/JPG, e.g. AI-generated art a client sent) into editable VECTOR PATHS in Illustrator. This automates the 'redraw the artwork from scratch' task.

Engines:

• 'vtracer' (default): open-source VTracer produces a clean SVG that is opened as editable paths. Usually cleaner than Image Trace; free and local. Needs the vtracer binary installed (see README).

• 'image_trace': Illustrator's built-in Image Trace (no install), kept as a fallback.

Input: path (absolute) OR image_base64 (bytes / data: URI, for images pasted in chat).

VTracer args: mode ('color'|'blackwhite'), curve_mode ('spline'|'polygon'|'pixel'), filter_speckle (remove specks, higher = cleaner), color_precision (2-8), corner_threshold (deg). Image Trace args: mode, preset, max_colors, threshold, path_fidelity, corner_fidelity, noise_fidelity, expand.

Best on logos, flat art, line art, and few-color graphics. Photorealistic images produce many paths and usually need manual cleanup.

Execute arbitrary ExtendScript (Illustrator's JavaScript) in the active Illustrator instance. Use this for anything the specialized tools do not cover — advanced paths, effects, batch edits, reading detailed properties, etc.

The code runs inside a function body: use return <value> to send JSON-serializable data back. The global app and the active document are available, plus helpers: __doc(), __color(hex), __setPos(item, x, y), __itemInfo(item), __abRect(), __activeAB(doc), __style(item, opts).

Coordinates in Illustrator's native API are Y-up and global; the helpers convert to artboard-relative Y-down.

Example code: var d = __doc(); var r = d.pathItems.rectangle(0, 0, 100, 100); return __itemInfo(r);

NOTE: This can modify or delete artwork and interact with the file system. Prefer the specialized tools when they fit.