Inbox File
Process items dropped in the Inbox folder, suggesting destinations and filing with user's approval.
[GOAL]
Interactively process each item in Inbox/, showing content previews, suggesting destinations, and moving files with minimal frontmatter added.
[PROCESS]
1. List inbox items
bash
ls -la {VAULT_PATH}/Inbox/ | grep -v README.md | grep -v ".DS_Store"
If empty, report "Inbox empty - nothing to file" and exit.
2. For each item
Show preview:
- •First 20 lines of content (or full file if short)
- •Any hashtags on first line
- •File size and modification date
Suggest destination based on hints:
| Hint/Pattern | Suggested Destination |
|---|---|
#project or project name | Projects/{name}/ |
#meeting | Projects/{project}/meetings/ or Clients/{client}/meetings/ |
#idea | Personal/Ideas/ |
#client or client name | Clients/{name}/ |
#reference or #clip | Knowledge/Clippings/ |
#journal | Journal/ |
| PDF financial doc | Personal/Finances/ |
| No clear hint | Ask user |
3. Get user approval
Use AskUserQuestion:
- •Show suggested destination
- •Options: Accept / Different location / Skip / Delete
4. Execute move
If approved:
bash
mv "{VAULT_PATH}/Inbox/{filename}" "{VAULT_PATH}/{destination}/"
If file is .md, optionally add minimal frontmatter:
yaml
--- type: note date: YYYY-MM-DD source: inbox ---
5. Report summary
After processing all items:
- •X items filed
- •X items skipped
- •X items deleted
[IMPORTANT]
- •Always preview before suggesting - don't guess from filename alone
- •Ask, don't assume - user confirms each move
- •Minimal frontmatter - only type and date, nothing more
- •Preserve content - never modify file content, only add frontmatter
- •Handle PDFs - can't add frontmatter, just move to destination
[DESTINATION REFERENCE]
| Type | Path |
|---|---|
| Project work | Projects/{project-name}/ |
| Client work | Clients/{client-name}/ |
| Ideas | Personal/Ideas/ |
| Financial docs | Personal/Finances/ |
| Reference material | Knowledge/Clippings/ |
| Daily reflection | Journal/ |
| Meeting notes | {project-or-client}/meetings/ |
| Family matters | Personal/Family/ |
[FALLBACK]
If destination folder doesn't exist, ask user:
- •Create folder and proceed?
- •Choose different destination?