Installation

Get agentic-fm set up and connected to your FileMaker solution in five steps.

Requirements

Dependency Required By Notes
FileMaker Pro 21.0+ Everything GetTableDDL, While, and data file steps required
MBS FileMaker Plugin Explode XML script Free trial available; other scripts use native steps only
fm-xml-export-exploder Explode XML, fmparse.sh Download binary; place at ~/bin/fm-xml-export-exploder
Python 3 + .venv clipboard.py, validate_snippet.py source .venv/bin/activate before use
xmllint fmcontext.sh Ships with macOS; apt-get install libxml2-utils on Linux

Setup Steps

1

Install the Context custom function

Open your FileMaker solution and go to File > Manage > Custom Functions. Create a function named Context with one task parameter, and paste in the contents of filemaker/Context.fmfn.

2

Install the companion scripts

Load filemaker/agentic-fm.xml onto the clipboard using the clipboard.py write command, then paste into the Script Workspace in FileMaker: 

source .venv/bin/activate
python agent/scripts/clipboard.py write filemaker/agentic-fm.xml
3

Configure the repo path

Run the Get agentic-fm path script once. It will prompt you to select the agentic-fm folder on disk and store the path in $$AGENTIC.FM for use by the other scripts.

4

Explode the XML

Run the Explode XML script to perform your first Save as XML export and populate agent/xml_parsed/. Re-run it any time the solution schema changes.

5

Push context before each session

Navigate to the layout you are working on, run Push Context, enter a task description, and the current context will be written to agent/CONTEXT.json. You are now ready to work with AI.

Optional: FileMaker Reference Docs

For accurate, up-to-date information about script step options and function syntax, you can fetch the official Claris documentation: 

cd agent/docs/filemaker
python fetch_docs.py              # fetch everything
python fetch_docs.py --steps      # script steps only
python fetch_docs.py --functions  # functions only
python fetch_docs.py --errors     # error codes only

Generated files are copyrighted by Claris International Inc. and excluded via .gitignore. For personal, non-commercial use only per the Claris Website Terms of Use.

Verify Installation

Once setup is complete, verify the toolchain works:

# Activate the virtual environment
source .venv/bin/activate

# Validate any existing sandbox files
python agent/scripts/validate_snippet.py

# Check that fmparse.sh is available
./fmparse.sh --help

If all commands succeed, you're ready to start generating FileMaker scripts with AI.

Ready to bring AI into your FileMaker workflow?

agentic-fm is open source and free to use. Star the repo to follow development, or jump straight into the installation guide.

Installation Guide Star on GitHub