A macOS application that tracks project folders using security-scoped bookmarks and custom marker files, maintaining access even after folders are moved.
- Persistent Tracking: Tracks folders even after they're moved to different locations
- Automatic Updates: Automatically updates folder paths when moves are detected
- Visual Indicators: Real-time sync status, bookmark status, and search indicators
- Marker Files: Creates searchable
.DSBookmarkfiles with custom icons - Robust Resolution: Multiple fallback mechanisms (path → bookmark → marker search → manual)
- Full Disk Access: No sandbox restrictions for seamless file operations
The project follows MVC (Model-View-Controller) architecture:
BookMarks/
├── BookMarksApp.swift # App entry point
├── Models/ # Data models
│ └── ProjectFolder.swift
├── Views/ # UI components
│ ├── ContentView.swift
│ └── ManualLocateSheet.swift
├── ViewModels/ # Business logic
│ └── ProjectFolderViewModel.swift
├── Services/ # Service layer
│ ├── BookmarkManager.swift
│ ├── FolderMarkerManager.swift
│ ├── SecurityScopedResource.swift
│ └── PermissionHelper.swift
└── Resources/ # Assets & config
├── Assets.xcassets/
├── Info.plist
└── BookMarks.entitlements
- Click the "+" button
- Select a folder from the file picker
- The app:
- Creates a security-scoped bookmark
- Stores folder information in SwiftData
- Creates a
[ProjectName].DSBookmarkmarker file - Sets custom icon on the marker file
The app uses a three-tier resolution system:
- Stored Path: Checks if folder exists at stored location
- Bookmark Resolution: Resolves security-scoped bookmark to find new location
- Marker File Search: Searches for
.DSBookmarkfiles by projectID - Manual Locate: Prompts user if automatic resolution fails
- Checks sync status every 10 seconds
- Automatically updates paths when folders are moved
- Updates bookmarks and marker files to new locations
- Shows visual indicators for sync status
Each tracked folder contains a marker file:
- Name:
[ProjectName].DSBookmark - Icon: Custom devspace-icon
- Content: Project metadata (name, ID, dates)
- Purpose: Searchable in Finder, enables folder discovery
The app requires full disk access:
- Open project in Xcode
- Select app target → "Signing & Capabilities"
- Remove "App Sandbox" capability if present
- Verify
BookMarks.entitlementshas sandbox disabled
- Clean build folder (Shift+Cmd+K)
- Build (Cmd+B)
- Run (Cmd+R)
- Click "+" button
- Select folder from picker
- Optionally provide a custom name
- Folder is now tracked
- Green bookmark = In sync
- Orange bookmark = Out of sync
- "Out of Sync" badge = Path mismatch
- "Searching..." = Actively searching
- "Locate" button = Manual locate available
If automatic search fails:
- Click "Locate" button
- Select folder from file picker
- App updates path automatically
Right-click any folder for:
- Test Bookmark
- Resolve Folder
- Update to Current Location (if out of sync)
- Create Marker File
See ARCHITECTURE.md for detailed technical documentation.
- macOS 14.0+
- Xcode 15.0+
- Swift 5.9+
- Full disk access (no sandbox)
Copyright © 2025. All rights reserved.