SILMARIL DOCUMENTATION

Silmaril for macOS

Install Silmaril for macOS, connect it to your Firewall, and protect supported coding agents on your Mac.

Download Silmaril 0.2.0
Current release
Silmaril 0.2.0 (8)
Requires
macOS 14 or later
Before setup
Silmaril API URL and key
Overview

Protect Local Coding Agents

Silmaril discovers supported local coding agents, configures their protection, and shows their current state in one place.

The app also provides a local inventory of plugins, skills, MCP servers, and connectors, plus recent protection activity. Direct installs show an Update action when a verified update is ready.

Install

Install The App

You need macOS 14 or later, a supported coding agent, and the API URL and key supplied by Silmaril.

Download

Download Silmaril 0.2.0 from the verified Silmaril download service.

Move to Applications

Open the DMG, then drag Silmaril to the Applications folder.

Open Silmaril

Open Silmaril from Applications and complete the first-run review.

Mounted Silmaril installer showing the Silmaril app and Applications folder
Drag Silmaril into Applications.

If your Mac is managed by your organization, follow your administrator's installation process instead.

Setup

Connect And Protect

Review first-run items

Complete every required item. An unavailable capability may show Not needed, and notifications can be enabled later in Settings.

Save the connection

Open Settings, enter the Silmaril API URL and key you received, then select Save. The key is entered once and stored in your login Keychain.

Silmaril Connection settings with a sanitized API URL and an empty API key field
Enter the supplied connection details in Settings.
Start in Shadow mode

On Protection, keep Shadow selected while you confirm agent coverage. Shadow mode reports protection activity without blocking it.

Protect and verify

Select Protect All. Wait for each installed agent to show Protected. If an agent shows Restart required, restart that app or begin a new terminal session, then check again.

Silmaril Protection page showing a privacy-safe representative list of protected agents
Protection shows coverage and status for supported agents.
Troubleshooting

Resolve Common Issues

Silmaril does not open
Confirm that your Mac runs macOS 14 or later and that Silmaril is in Applications. Download the DMG again if needed. If macOS reports that the app is damaged or cannot be verified, stop and contact Silmaril Support instead of bypassing the warning.
No agents found
Install or start a supported coding agent, return to Silmaril, and refresh the agent list.
Connection rejected
Re-enter the API URL and key supplied by Silmaril in Settings, then select Save. Contact Support if the credentials are still rejected.
Needs attention or Restart required
Open the affected agent and follow the action shown. After a repair or update, restart the named app or begin a new terminal session.
Notifications are off
Open Settings and select Enable next to Notifications. If permission was previously denied, enable Silmaril in macOS System Settings.
The issue continues
In Settings, select Export Diagnostics. Then open Support in Silmaril to send the export, or email aum@silmaril.dev.