Projects, figures, and files

Eidograph is organized as workspace → projects → figures. Every top tab is an open project; one project corresponds to one .eido file and can contain any number of 2D or 3D figures. Each figure is one Eidolang script.

Create a project

Choose + in the header, then select:

• New project — 2D figure for one initial plane figure;
• New project — 3D figure for one initial solid figure;
• Empty project to add a figure later from Figures or the Agent.

Click tabs to switch. Click the active tab for project actions: rename, save, Save As, or close. After saving, the actual .eido file name becomes the project name.

Manage figures

In the Figures panel:

• use + 2D or + 3D to add a figure;
• click a row to switch;
• use the pencil to rename;
• use × to delete—after confirmation, ordinary undo cannot restore the figure;
• the filled/hollow dot controls exposure to Windows MCP/REST clients.

A figure is fixed as plane or solid at creation. Changing its space line to the other kind produces a diagnostic; it does not convert the figure. Create a figure of the intended kind and rewrite the construction instead.

While the Agent is pinned to and working in a project, figure add/delete/switch actions are locked so the target cannot change mid-turn.

Save, Save As, and close

• Save chooses a path the first time, then overwrites that file.
• Save As chooses a new name and location and synchronizes the project name to it.
• Ctrl/⌘ S saves; Ctrl/⌘ Shift S uses Save As.
• Close removes the project tab from the workspace; it does not delete the saved .eido. Unsaved work requires confirmation.

.eido is a ZIP container with current manifest version: 2; every figure remains a plain-text script. It stores project name, figure order/names/kinds, and project canvas settings. Agent chat is excluded by default; enable Settings › General › Include agent chats when needed.

Camera pose, 2D pan/zoom, grid style, and selection are local view state and are not stored in .eido.

Open and drag-drop files

Choose the folder button or drop a file anywhere on the app:

File	Result
.eido	opens as a new project tab
.zip	reads the current package structure and opens a new project
.geo / .txt	adds one figure to the active project

A bare script uses space plane or space solid. Without it, Eidograph asks which kind to use. An .eido package never merges into the active project.

Export one script

Choose Save Eidolang (.txt) in the command palette for the current figure's plain text. It has no other figures or project settings. This is useful for code review and version control; use .eido for a complete shareable project.

Recommended backup routine

1. Save projects regularly.
2. Use Save As before an upgrade, track switch, or uninstall.
3. Include Agent chats only when needed, after checking prompts for sensitive content.
4. Reopen the backup in another tab and verify figure count, kinds, and scripts.