Core workflow

Projects, figures, and scripts

The workspace can keep several projects open. Projects are top-level tabs, and each project may contain any number of 2D plane and 3D solid figures. A figure's kind is fixed when it is created; switching figures mounts the matching canvas and tools.

Each figure has one source of truth: its Eidolang script. Canvas tools append commands, dragging rewrites numeric literals, and parameter sliders write their final value back to text. You can freely combine three editing styles:

• use tools to assemble a construction quickly;
• drag free points or points bound to paths;
• edit commands and expressions precisely in the editor.

The Objects panel lists names, types, freedom tiers, and current status. Diagnostics reports errors and warnings with source locations and hints. Fix the earliest error first; later errors are often consequences.

File management

One .eido file is one complete project. It is the current ZIP-based format (manifest version: 2), with scripts kept as plain UTF-8 text. A saved project includes figure order, names, 2D/3D kinds, and that project's own canvas and zoom settings.

Agent chats are excluded by default. Enable Settings › General › Include agent chats when you intend to share them. Camera direction, pan/zoom, and selection are local view state and are not stored in the project file.

Export a figure

Choose Export at the bottom of the left rail, then select a format and region:

Format	2D plane	3D solid	Good for
SVG	Native vector output	Wireframe/contour projection from the current view	Publishing, web, and vector editing
PNG	Transparency and 1×/2×/4× scales	WebGL canvas pixels	Slides, chat, and general images
GIF	Animation or stage timeline	Timeline or camera orbit	Showing dynamic relationships

The region can be Current view or Fit content; 2D also supports a custom rectangle drawn on the canvas. Grid, transparency, pixel scale, and GIF frame rate can be changed per export or used as saved defaults.

Useful settings

• Appearance: light/dark/system theme, interface language, and text scale.
• Canvas & zoom (default): seeds future projects only.
• This project › Canvas & zoom: saved in .eido and affects only this project.
• Export defaults: initial values in the export dialog.
• Agent: saved model endpoints and the active model.
• MCP / REST server: native-app port, listening scope, tool permissions, and activity.

In-app Agent basics

1. Open Settings › Agent and add a provider, Base URL, API key, and model ID.
2. Return to the Agent tab and ask for something such as “Create a triangle and mark the midpoint of every side.”
3. Expand each tool call to inspect its arguments, result, and script edit.
4. If the result is not useful, choose Revert turn. Eidograph attempts to retain manual edits you made afterward.

The Agent follows the active project by default. Pin it before a long task so viewing another tab does not change its target. Agent edits use the same compilation, diagnostics, persistence, and undo path as manual edits.

WARNING

The model endpoint must allow cross-origin requests from the app's WebView (CORS). The Windows and Android apps store API keys in OS-protected credential storage.

Go deeper: Projects and files · Object editing · Animation and GIF · Using 3D · Settings reference