Metadata Explorer

Metadata Explorer defines the schema context Genie uses for generation and analysis. It can also be used to manually select or enhance the context available to AI.

Metadata Explorer panel with context guidance copy

Manual selection can speed up discovery and make Genie’s work more precise. It is optional for AGENT: AGENT should normally navigate available metadata and MCP resources automatically before asking you to select context.

Global actions

Label	Description
Expand	Toggle normal/expanded panel width.
Refresh	Pull latest schema from FileMaker.
Clear	Remove all selections.
Preview	Open selected metadata JSON in Viewer.
Close	Close the Metadata Explorer panel.

Panel resizing and active table

You can drag the explorer edge to resize the panel.
In Tables, one table can be marked as the active focus.
When a table is active, the Fields section emphasizes fields from that table.
This helps narrow prompts and reduce field ambiguity.

Schema sections

Tables
Fields
Relationships
Layouts
Scripts
Value Lists
Custom Functions

Each section supports:

Search
All / None bulk actions
Per-item checkbox selection

Select fields on a layout

In the Layouts section, each layout row includes a small Select fields on this layout button. Use it when a prompt depends on the fields that are actually available on a specific FileMaker layout.

Select fields on this layout button in Metadata Explorer

When you click the button, Genie:

selects the layout
reads the fields available on that layout
selects the matching fields in Fields
keeps the selected table, layout, and field context together for prompts and # autocomplete

This is useful for layout-aware CODE, QUERY, and DATA work where a table has many fields but only some are available or relevant on the target layout.

Relationships

The Relationships section shows read-only relationship metadata for the current FileMaker file. Use it when a prompt depends on how table occurrences connect, which fields are used for joins, or whether related-record options are enabled.

Relationship list in Metadata Explorer

Each relationship row shows the relationship name and a compact join summary. Click the info button to open the relationship details view.

Relationship details in Genie

The details view shows:

left and right table occurrences
join predicates
relationship options such as create related records and delete related records
a copy action for sharing the relationship summary

Relationship selections help CODE, QUERY, DATA, and Local MCP agents understand the existing graph. They do not create or edit FileMaker relationships.

Add scripts directly to context

In Scripts, use the Add script to edit context button to attach a known script directly from Metadata Explorer.

Quick add script to edit context button in Metadata Explorer

This avoids clipboard-based capture when the script is already known to Genie. Use Add Selection when you need the current live Script Workspace selection instead.

Metadata scope and autocomplete

The Metadata Explorer selection drives # autocomplete in the composer. If you type # and do not see the table, field, layout, script, or custom function you expected, check the current explorer selection first.

Use Refresh after schema changes in FileMaker.
Select the relevant metadata before sending prompts that depend on exact names.
Use Preview to confirm what Genie will receive as schema context.
Import custom functions when your prompt depends on project-specific calculation helpers.

If required metadata is missing, Genie may ask before generating CODE, QUERY, or DATA output. Advisory gaps can still produce a draft, but Genie should not silently invent unknown fields or functions.