import

Import

Process local files into permanent vault notes in [resources_folder]/ (resolved from onebrain.yml; default: 04-resources/).

Usage:

• /import : scan default import staging inbox ([inbox_folder]/imports/, resolved from onebrain.yml)
• /import /path/to/file : import a single explicit file
• /import --attach : scan inbox and copy supported files into vault for inline Obsidian preview
• /import /path/to/file --attach : single file with attach

---

Orchestrator Flow

Step 1: Resolve source and parse flags

Resolve additional folders from onebrain.yml (read the file if it exists at the vault root):

• If onebrain.yml does not exist: use all defaults below.
• If onebrain.yml exists but cannot be parsed: report the error and stop : do not proceed with unknown folder paths.
• folders.import_inbox → default: [inbox_folder]/imports (import staging folder; substituting the resolved [inbox_folder] placeholder)
• folders.attachments → default: attachments (for --attach copies)

Use [inbox_folder] and [resources_folder] from session config. Store resolved [attachments_folder] from onebrain.yml above.

Parse arguments:

• Extract --attach flag if present (remove from path consideration)
• If a file path is provided after /import: this is single-file mode
• If no path: this is batch mode (scan inbox)

Single-file mode:

1. Validate the file exists. If not, report and stop.
2. Determine file type from extension (see Supported File Types below).
3. If unsupported type, report:

   [filename] is not a supported file type. Supported: PDF, Word, Excel, PowerPoint, images, video, Python/Shell/SQL scripts. Then stop.

4. Note whether the file is inside the inbox folder (used in cleanup : files outside inbox are never deleted).
5. Skip Steps 2 and 3 below. Go directly to Step 4 with this single file.

Batch mode:

1. Use [inbox_folder] resolved in Step 1 above (default: [inbox_folder]/imports from onebrain.yml).
2. List all files recursively in the inbox folder.
3. If the inbox folder does not exist, report:

   Import inbox not found at [inbox path]. Run /onboarding to set up your vault, or use /import /path/to/file to import a specific file. Then stop.

4. If inbox is empty, report: 🔴 Inbox is empty ([inbox path]). Add files or use /import /path/to/file. Then stop.