This is the documentation of version 0.4. The newest version is 0.5: go to the newest documentation
Installation guide
2. Requirements
- The model is an EA project file .qea or .qeax, or is in a PostgreSQL database. Older file formats (.eap, .eapx, .feap) and other databases are not supported; Enterprise Architect converts an .eap/.eapx file to .qea with a project transfer (Settings → Model → Transfer → Full Project Transfer).
- A model in a database has user security enabled (in Enterprise Architect: Settings → Security → Enable Security), in “Require User Lock to Edit” mode. In a model file, security is optional: without it, the assistant needs no EA account. The application logs in to the model as a specific user and locks objects while saving. When security is turned off, the locks are skipped; this is not a supported configuration.
- A model with security enabled has a user account for the assistant (Settings → Security → Users), with a password and edit permissions. The account name can be anything, for example
claudeorassistant, but the account must exist. You enter its login and password in the application settings.
| What | Details |
|---|---|
| System | Windows 10 or Windows 11 (64-bit) |
| Enterprise Architect | Installed on the same computer, with a valid license. The application starts it in the background; while it runs, it takes up one license seat. |
| EA model | An EA project file .qea or .qeax (you need only its path), or a repository in a PostgreSQL database with user security enabled (you need: the server, port, database name, and the database user and password). A .qea file is meant for one person; .qeax for a small team sharing the file. |
| Model user account | For a database model, or a model file with security enabled: the login and password of a user defined in the EA model. Ideally a separate account just for the assistant, so that its changes and locks are visible separately and do not clash with yours. |
| Claude API key | A key from the Anthropic Console. |
| Internet | An HTTPS connection to api.anthropic.com. The application uses the proxy from the Windows Internet settings or from the HTTPS_PROXY and ALL_PROXY variables (chapter 14). |
| Confluence (optional) | Confluence Cloud or Data Center, only for publishing pages through the assistant: the Confluence address (https://), a token and the space key (chapter 9). Without them, pages are still created and you paste the code yourself. |
| Mail program (optional) | For reporting bugs and subscribing to news about new releases: a mail program set as the default in Windows, for example Outlook. |
3. Installation
Run the file LoonarCompass-Setup-0.4.exe. The wizard guides you through the steps with the Next and Back buttons. You do not need administrator rights unless you install the application for all users of the computer.
- Language. Polish, English, German or French. For a new installation, English is selected; for an update, the language saved in your settings. The chosen language applies to the wizard, the application, the assistant's answers and the default document templates; you can change it later in the settings (chapter 5).
- Welcome. The prerequisites and a list of things worth preparing before installation.
- What's new. When updating: the changes since the installed version. For a new installation: the changes in the current version.
- License agreement. Select “I accept the terms of the license agreement”.
- Destination folder. The installation type (described below), the program folder (Browse…) and the shortcuts: Start menu (application, user guide, uninstall) and Desktop.
- Configuration. Choose “Enter the details now” or “Configure later in the application ("Settings" view)”. The page contains the Claude API key (with a note on what the application sends to Anthropic), the model (a PostgreSQL database: server, port, database name, database user, database password; or an EA file: the path to the .qea/.qeax file, which you can select with the … button), Enterprise Architect (the path to
EA.exe, which you can select with the … button, the EA user account and the EA account password) and the approval mode. - Ready to install. A summary of the installation type, folder, shortcuts and configuration. Click Install; the progress bar shows the percentage and the current step.
- Installation complete. With “Launch Loonar Compass” selected, the application opens after you click Finish.
Installation type
On the “Destination folder” page, you choose who the application is installed for:
- “Just for me (recommended, no administrator rights)”: the program is installed in
%LOCALAPPDATA%\Programs\Loonar Compass. Windows does not ask for administrator rights. - “For all users of this computer (requires administrator rights)”: the program is installed in
%ProgramFiles%\Loonar Compass, where only administrators can change files. Only in this case does Windows ask for administrator rights, after you click Install.
Settings, conversations and passwords are always stored for the user who runs the wizard (in %APPDATA%\Loonar Compass and in Windows Credential Manager), also when another person confirms the administrator rights and also in an installation for all users.
Updating from an earlier version
Earlier versions of the application were called Loonar EA Assistant: Loonar Compass takes over their settings, conversations, memory, templates and passwords automatically.
- An earlier version installed just for you is removed during installation (program files, shortcuts and the Windows entry); your data stays.
- If an earlier version is installed for all users, the “Ready to install” page shows it. You can remove it with the Remove the old version (administrator rights) button, or later in Windows Settings → Apps.
- On the first page, the wizard preselects the language saved in your settings (settings without a saved language, from versions 0.1 and 0.2, count as Polish), or English when there are no settings. Check this choice before you continue.
- Changing the language in the wizard does not translate the assistant's memory or your templates. To carry them over to a new language, change the language on card 4 in the settings after installation (chapter 5).
- A database password that older versions kept in the settings file is moved to Windows Credential Manager, and files with Polish names in the data folder get English names (for example
audit_log.jsonl).
17. Updating and uninstalling
Updating. Close the application and run the installer of the newer version. The wizard shows the “What's new” page with the changes since the installed version, suggests the same installation type and folder, and keeps your settings, conversation history, attachments, memory, templates and audit log. Updating from the earlier version under its former name is described in chapter 3.
Closing the application. Closing the window also closes the Enterprise Architect session started in the background by the application, so the EA license is released immediately.
Uninstalling. Close the application. Use the “Uninstall Loonar Compass” shortcut in the Start menu or the “Loonar Compass” entry in Windows Settings (Apps → Installed apps). The uninstaller removes the program files, the shortcuts and the system entry, showing the progress on a bar. For an installation for all users, Windows asks for administrator rights. Your data stays unless you select:
- “Remove settings, conversations, attachments, memory, templates and the audit log”: deletes the whole user data folder
%APPDATA%\Loonar Compass, - “Remove the API key, passwords and tokens from Credential Manager”: removes all the secrets, including the Confluence token and the database password.
In an installation for all users, only your own data is removed; the data of other users stays in their profiles.