File Tree & Editor
The file tree gives you a project-level view of your working directory, and the built-in editor lets you view and edit files without leaving Ironspire.
File tree
The file tree appears in the sidebar as a hierarchical directory browser. Click the chevron next to a folder to expand or collapse it. Files show type-specific icons.
Agent activity dots
When an agent reads, writes, or edits a file, a colour-coded dot appears next to that file in the tree. Dots also propagate up to parent directories, so you can see at a glance which folders have active work.
Activity is determined by scanning the last 30 messages per agent for file operation tools (Read, Write, Edit, MultiEdit, NotebookEdit). Dots fade after 30 seconds of inactivity, with checks every 10 seconds.
File conflict detection
When multiple agents modify the same file simultaneously, Ironspire detects the conflict and shows warning badges on the affected agent cards. Severity escalates from warning to critical depending on how many overlapping edits are detected.
Toast notifications alert you when a conflict is found, and conflicts also appear in the Activity Timeline for a full audit trail. The detection system uses a 5-minute debounce window with periodic 60-second sweeps to avoid false positives from rapid sequential edits.
Editor
Click any file in the tree to open it in the Monaco editor. The editor uses a custom "Ironspire" theme with DM Mono font, tab size 2, minimap disabled, and word wrap enabled.
Markdown modes
Markdown files support three viewing modes:
- Source: raw markdown editing
- Split: side-by-side source and preview (Columns2 icon)
- Preview: rendered markdown only (Eye icon)
Image preview
Opening an image file displays the image with metadata including file size and dimensions.
Binary files
Binary files show a "Cannot be displayed" message with an "Open externally" button to launch the file in your system's default application.
Files larger than 5MB cannot be opened in the editor. You will see an error message for oversized files.
Saving
Press Ctrl+S to save the current file.