Documentation

Deep links

Open files from the file manager, the terminal, or iwe:// links. A file joins the project that owns it, or opens on its own.

IWE Code accepts open requests from outside the application. The running application receives every request, so no second window appears.

Where requests come from

File manager
Open a file with IWE Code. On macOS the released bundle also receives Finder open events.
Command line
Run iwe with a file path or a deep link as the argument.
Second launch
A later launch forwards its requests to the running application and exits.
Drag and drop
Drop files on the application window.

How a file opens

  • A file inside a project directory opens with that project selected.
  • The most specific project matches when projects are nested.
  • A file that no project owns opens on its own tab without a project.
  • A missing file shows a notification.

Deep links

The iwe:// scheme targets files and existing projects from browsers, notes, and scripts:

The path value must be an absolute file-system path. Unknown actions and relative paths are ignored.

iwe://open?path=/abs/path/file.md
Open the file.
iwe://project?path=/abs/path/folder
Switch to the existing project.

One application instance

  • The first launch binds a local endpoint in the settings directory.
  • Later launches forward their requests to that endpoint and exit.
  • macOS delivers open events directly, so the system deduplicates launches.

Platform registration

  • macOS bundles declare the iwe:// scheme and text document types in Info.plist.
  • The Windows installer registers the scheme and the application entry for the current user.
  • The Linux desktop file declares x-scheme-handler/iwe.

Limitations

  • macOS open events need the released bundle. The development binary accepts files and links through the command line.
  • Windows file associations stay manual. Pick IWE Code in the Open With dialog once, and Windows remembers the choice.
  • Linux users register the desktop file with xdg-mime default or a matching desktop tool.

Developer documentation

The developer documentation describes every source, rule, and limitation in detail.