
Clues.app
https://github.com/f/clues.app- Category
- Entertainment
- Rank
- No. 1805Tools index
Previous survey · No. 1816 ·
- Pricing
- Open Source
- Type
- APP
- Builder
- f
- GitHub
- 39 stars
- Latest release
- v1.0
- Date
About
Native macOS/iOS app built entirely using AI tools — a showcase of agentic coding shipping real apps.
What it does
Clues is a macOS canvas for arranging colorful notes, images, and visual links between related ideas. Notes can be moved, searched, marked complete, and automatically tidied. Boards persist locally and can be saved as portable .clues documents, with iCloud presented as a synchronization option.
Why it's ranked here
The focused interaction model makes Clues interesting: it treats notes as spatial objects instead of rows in a list. Native controls, document saving, image drops, search, and animated connections form a coherent working app. However, the persistence and window-management code contains credible correctness risks that temper the recommendation.
What's good
The board preserves note positions, colors, rotations, completion state, images, and connection geometry. Dropped images are resized and compressed before storage. Connection strings respond to moving endpoints through a small physics simulation, giving relationships useful visual presence rather than rendering them as static lines.
Tradeoffs
It requires macOS 14 or later, and iCloud synchronization needs internet access. Each connection is attached to both endpoint notes, while document export walks every note’s connections, so a saved board can encode the same relationship twice. The application delegate’s new-window path also appears unable to retrieve the shared data container.
How to use it well
Use Clues for personal brainstorming, lightweight task mapping, or arranging reference images where spatial relationships matter. Save important canvases as .clues documents and verify reopened connections after editing. It suits interactive desktop work, but it does not provide a command-line tool, programming library, web API, or collaborative service interface.
Technical notes+
Clues/CluesApp.swift builds a SwiftUI WindowGroup backed by SwiftData, but AppDelegate.sharedModelContainer casts NSApp.delegate to CluesApp, even though the delegate is configured as AppDelegate; consequently createNewWindow() may not install content. Clues/Models/Item.swift stores each Connection in both endpoint arrays. Clues/BoardDocument.swift then uses items.flatMap over those arrays without deduplication, so JSON document output can contain duplicate connection records. Clues/ContentView.swift registers NotificationCenter observers during appearance without retaining or removing observer tokens. Clues/Views/StringView.swift uses CVDisplayLink at a preferred 60 frames per second and dispatches physics updates onto the main queue.
Observed
- License
- MIT
- Primary language
- Swift
- Platform
- macOS 14.0 Sonoma or later
- Install surface
- DMG download from GitHub Releases, then drag Clues.app into Applications
- Source build
- Xcode project built and run with Xcode
- Interface
- Native macOS graphical application
- Document format
- Custom .clues board files encoded as JSON
- Core frameworks
- SwiftUI, SwiftData, AppKit, and Uniform Type Identifiers
Read from README.md, Clues/CluesApp.swift, Clues/Extensions.swift, Clues/ContentView.swift, Clues/BoardDocument.swift, Clues/Models/Item.swift, Clues/Views/EditViews.swift, Clues/Views/TapeLabel.swift, Clues/Views/PostItView.swift, Clues/Views/StringView.swift, Clues/Views/StringsLayer.swift, Clues/Views/CrossPaintView.swift, Clues/Views/ImageDropDelegate.swift, Clues/Views/NewFloatingPostIt.swift, Clues/Views/PopupContainerView.swift.
What it can do
Generate native macOS applications using AI
User requirements and specifications → Functional macOS application
Generate native iOS applications using AI
User requirements and specifications → Functional iOS application
Demonstrate AI-powered code generation capabilities
Development requests and prompts → Working application code
Showcase agentic coding workflows
Software development tasks → Complete application implementation
Provide real-world example of AI tool usage
Development scenarios → Production-ready software application
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.