Skip to main content

File management

Headmaster’s agent has full file system access within your project folder. The file management features help you organize, preview, and manage the files the agent creates.

File Manager

The File Manager is a panel that shows the files in your current project folder. Open it from the sidebar or with Cmd/Ctrl + I.

Auto-organize

Click Sort my files in the File Manager. The agent reads the folder, classifies files by type and content, and moves them into subfolders:
You can customize the classification rules or undo the sort if you don’t like the result.

Batch rename

Select multiple files, click Rename a batch, and enter a pattern. Example: report_{n}_{date}report_1_2026-06-23.txt, report_2_2026-06-23.txt, etc.

Preview panel

When the agent writes a file or you click a file in the File Manager, the preview panel opens: The preview panel is a tabbed interface — open multiple files at once and switch between them. Previews open automatically when the agent writes a new file or creates a new Office document.

File operations the agent can perform

  • 👁️ Read — reads file contents into its context.
  • 📝 Write — creates or overwrites files.
  • ✂️ Edit — makes targeted edits to specific lines or sections.
  • 🗑️ Delete — deletes files (with approval in Work Along mode).
  • 📦 Move — moves or renames files.
  • 🔍 Search — searches file contents with regex or plain text.
  • 🔀 Merge — merges multiple files into one.
All file operations are logged in the conversation transcript for audit.

Preview panel

Full details on the multi-format file viewer.

Documents

Generate Office documents — decks, spreadsheets, reports, and PDFs.