A collaboration with Proof · 1 public repo per week

Are you an open source maintainer? We can help your project.

Completely free for open source repositories.

Proof turns your repository into a graph of requirements that humans and agents can both use. It finds as many bugs as it can, and gives you the tools to triage GitHub issues and pull requests from contributors — including community bug reports and security reports.

Swift good first issues

467 open Swift issues currently match the default 10+ star filter. Scored difficulty: 5,947 at 1/5, 8,791 at 2/5, 12,711 at 3/5, 12,149 at 4/5, 859 at 5/5. This hub uses the same feed as the homepage, limited to repositories whose GitHub language is Swift.

All languages · Browse projects · How to find good first issues

Active filters:Language: Swift • Stars: 10+ Stars
Filters trigger API requests for better performance

Showing 30 of 467 opportunities to contribute from the last 7 days

AI Summary: This issue proposes adding a customizable accent color picker for the OLED Dark Mode in the Mooziac application. Users will be able to select from a predefined set of colors to personalize the progress bar and active controls, enhancing the user interface.

Complexity:2/5
enhancementhelp wantedgood first issue

Native macOS menu bar player for YouTube Music & local audio. Lightweight Dynamic Island UI, synced lyrics, and trackpad gestures for Apple Silicon & Intel.

Swift
#appkit#apple-silicon#dynamic-island#macos#macos-app#menubar-app#mooziac#music-player#native-macos#offline-music-player#swift#swiftui#synced-lyrics#youtube-music#youtube-music-desktop#youtubemusicapp

AI Summary: This issue proposes adding functionality to export and import offline playlists in Mooziac using .m3u8 or .json file formats. This would enable users to back up and migrate their local track playlists, enhancing library management capabilities.

Complexity:2/5
enhancementhelp wantedgood first issue

Native macOS menu bar player for YouTube Music & local audio. Lightweight Dynamic Island UI, synced lyrics, and trackpad gestures for Apple Silicon & Intel.

Swift
#appkit#apple-silicon#dynamic-island#macos#macos-app#menubar-app#mooziac#music-player#native-macos#offline-music-player#swift#swiftui#synced-lyrics#youtube-music#youtube-music-desktop#youtubemusicapp

AI Summary: This issue proposes adding customizable global keyboard shortcuts for media playback controls (Play/Pause, Skip) in the Mooziac application. The goal is to enhance user experience by allowing users to control playback from anywhere on macOS using their preferred key combinations. The implementation involves integrating with macOS's global event monitoring system and adding new options to the application's preferences.

Complexity:3/5
enhancementhelp wantedgood first issue

Native macOS menu bar player for YouTube Music & local audio. Lightweight Dynamic Island UI, synced lyrics, and trackpad gestures for Apple Silicon & Intel.

Swift
#appkit#apple-silicon#dynamic-island#macos#macos-app#menubar-app#mooziac#music-player#native-macos#offline-music-player#swift#swiftui#synced-lyrics#youtube-music#youtube-music-desktop#youtubemusicapp

AI Summary: This issue reports a visual bug on macOS where an unexplained horizontal line appears below the file tree module. The proposed solution is to simply remove this line to improve the user interface.

Complexity:1/5
bugenhancementgood first issuemacos

A lightweight, cross-platform IDE for the AI era, with on-demand tools and services.

Swift

AI Summary: This feature request proposes adding a preference option to allow users to hide the OpenClip menu bar icon on macOS. This would be beneficial for users who prefer a cleaner menu bar or have limited space, while ensuring all other functionalities remain accessible. The change should ideally take effect immediately.

Complexity:2/5
enhancementgood first issue

Fast, open-source macOS floating text actions and PopClip alternative. Transform text, run scripts, and integrate AI seamlessly.

Swift
#app-kit#apple-intelligence#applescript#clipboard#developer-tools#javascriptcore#llm#macos#macos-app#menubar-app#ollama#open-source#popclip-alternative#productivity#swift#swift6#swiftui#text-selection

AI Summary: The developer has created a universal build of their application, Muro, that should now run on Intel Macs. They are seeking testers with Intel Macs running macOS 14 or newer to verify its functionality, specifically checking wallpaper playback, CPU usage, and general app performance. This testing is the final step before releasing the Intel-compatible version.

Complexity:2/5
help wanted

Live wallpapers for your Mac, with low CPU and RAM usage. Native, free, no paywall. The wallpaper library updates itself.

Swift
#apple-silicon#hevc#live-wallpaper#lock-screen#macos#macos-app#menu-bar-app#open-source#swift#swiftui#video-wallpaper#wallpaper

AI Summary: The application's light mode is not properly adapted and instead directly inverts the dark mode configuration. This results in a visually uncomfortable experience with poor color distinction, requiring specific adaptations for icons and colors.

Complexity:3/5
buggood first issuemacos

A lightweight, cross-platform IDE for the AI era, with on-demand tools and services.

Swift

AI Summary: This issue proposes making the BrightspaceBar application 'agent-native' to allow AI agents to automatically add syllabus dates to heatmaps. Currently, adding assignments and quizzes is a manual process, but an AI could extract this information from a syllabus and input it directly, saving users time.

Complexity:3/5
enhancementhelp wanted

A macOS menu-bar app for Brightspace: course due-date heatmaps, hover popups, and one-click deep links that land already signed in — credentials never touch the app.

Swift
#appkit#brightspace#d2l#macos#menu-bar#playwright#purdue#student-tools#swift#swiftpm

AI Summary: The README file for the repository contains broken links to its 'getting started' and documentation sections. This issue is marked as reproducible with SwiftPM command-line tools, indicating a problem with how these links are presented or resolved within the project's documentation structure.

Complexity:1/5
good first issuebug

The Package Manager for the Swift Programming Language

Swift

AI Summary: This issue requests the addition of a troubleshooting section to the project's documentation, specifically for the `build.sh` script used for building from source. The goal is to document common build issues encountered by first-time users and provide clear solutions, making the build process smoother.

Complexity:2/5
documentationgood first issue

Mac Agent for macOS 26: the agentic AI harness for your Mac Desktop. Computer use, automation, scripting, coding, and more. Powered by 18+ providers across local and cloud LLMs.

Swift
#accessibility#agentic-framework#agentic-workflow#ai#ai-agent#apple-intelligence#applescript#automation#claude#imessage#javascript#jxa#llm#macos#mcp#ollama#swift#swiftui#xcode#xpc

AI Summary: This issue requests the translation of the project's README file into various languages to make it accessible to a wider user base. The process involves copying the existing README, translating the text while preserving code, links, and legal notices, and adding a language switcher to both the original and translated files.

Complexity:2/5
documentationgood first issue

Mac Agent for macOS 26: the agentic AI harness for your Mac Desktop. Computer use, automation, scripting, coding, and more. Powered by 18+ providers across local and cloud LLMs.

Swift
#accessibility#agentic-framework#agentic-workflow#ai#ai-agent#apple-intelligence#applescript#automation#claude#imessage#javascript#jxa#llm#macos#mcp#ollama#swift#swiftui#xcode#xpc

AI Summary: This issue proposes expanding the `docs/FAQ.md` file to include answers to common setup questions faced by new users. The goal is to add 2-4 new Q&A entries based on the provided examples or other common issues, ensuring accuracy by verifying against the README and personal builds. No Swift knowledge is required, and it's tagged as a good first issue.

Complexity:1/5
documentationgood first issue

Mac Agent for macOS 26: the agentic AI harness for your Mac Desktop. Computer use, automation, scripting, coding, and more. Powered by 18+ providers across local and cloud LLMs.

Swift
#accessibility#agentic-framework#agentic-workflow#ai#ai-agent#apple-intelligence#applescript#automation#claude#imessage#javascript#jxa#llm#macos#mcp#ollama#swift#swiftui#xcode#xpc

AI Summary: This issue requests the creation of a Homebrew Cask for the Agent! application. The goal is to enable users to install Agent! with a simple `brew install --cask agent` command, making it more discoverable and easier to install for Homebrew users. The task involves creating a Ruby formula for the cask and updating the project's README.

Complexity:2/5
enhancementgood first issue

Mac Agent for macOS 26: the agentic AI harness for your Mac Desktop. Computer use, automation, scripting, coding, and more. Powered by 18+ providers across local and cloud LLMs.

Swift
#accessibility#agentic-framework#agentic-workflow#ai#ai-agent#apple-intelligence#applescript#automation#claude#imessage#javascript#jxa#llm#macos#mcp#ollama#swift#swiftui#xcode#xpc

AI Summary: This issue requests the addition of unit tests for a service within the `Agent/Services/` directory that currently lacks test coverage. The contributor needs to select an untested service, create a new test file in `AgentTests/` following existing patterns, and ensure all tests pass.

Complexity:2/5
enhancementgood first issue

Mac Agent for macOS 26: the agentic AI harness for your Mac Desktop. Computer use, automation, scripting, coding, and more. Powered by 18+ providers across local and cloud LLMs.

Swift
#accessibility#agentic-framework#agentic-workflow#ai#ai-agent#apple-intelligence#applescript#automation#claude#imessage#javascript#jxa#llm#macos#mcp#ollama#swift#swiftui#xcode#xpc

AI Summary: This issue proposes adding a short, animated GIF to the top of the project's README file. The GIF should visually demonstrate a unique capability of 'Agent!' that competing tools like Claude Code or Cursor cannot perform, aiming to improve the initial impression for new users. The process involves building the project, recording a screen capture, optimizing it into a GIF, and then embedding it into the README.

Complexity:1/5
documentationgood first issue

Mac Agent for macOS 26: the agentic AI harness for your Mac Desktop. Computer use, automation, scripting, coding, and more. Powered by 18+ providers across local and cloud LLMs.

Swift
#accessibility#agentic-framework#agentic-workflow#ai#ai-agent#apple-intelligence#applescript#automation#claude#imessage#javascript#jxa#llm#macos#mcp#ollama#swift#swiftui#xcode#xpc

AI Summary: The user is reporting a bug where all server settings in Proxmox Bar are lost after updating to the newest version (3.0.2). This issue has been observed after previous updates as well. The expected behavior is for the app to retain server credentials across updates.

Complexity:2/5
bughelp wanted

Control and monitor your Proxmox VE servers from the macOS menu bar

Swift
#homelab#macos#macos-app#menubar#monitoring#proxmox#proxmox-ve#self-hosted#swift#swiftui#virtualization

AI Summary: This feature request proposes modifying the JSON output of container commands to avoid escaping forward slashes. This change aims to improve the readability and copy-paste friendliness of JSON output, particularly for pathnames, by using the `.withoutEscapingSlashes` configuration for JSONEncoder.

Complexity:2/5
good first issuehelp wantedux

A tool for creating and running Linux containers using lightweight virtual machines on a Mac. It is written in Swift, and optimized for Apple silicon.

Swift

AI Summary: This issue requires updating hardcoded kernel version strings within mock fixtures in the Berthly project. The goal is to align these mock values with the new default Kata kernel version (3.32.0-debug) to ensure SwiftUI previews and UI tests display current information. This is a low-priority, cosmetic change with no impact on production code or test assertions.

Complexity:1/5
good first issue

A native macOS app for managing Apple's container - build images, run machines, and tail logs from a real GUI.

Swift
#apple-container#apple-silicon#containers#docker-desktop#macos#menubar-app#swiftui

Inspect, mock and reshape HTTP/S traffic on macOS. Free, public-domain, native — the modern Proxyman alternative, built on mitmproxy.

Swift
#charles-alternative#debugging#developer-tools#http-debugging#http-proxy#macos#mitmproxy#mocking#network-debugging#proxy#proxyman-alternative#swift#swiftui#web-debugging

AI Summary: This is a tracking issue for breaking changes in version 3.0 of a networking library. Key improvements include typed request bodies, richer error payloads with specific status codes and underlying errors, and access to response metadata like status codes and headers. These changes address limitations that prevented users from sending complex data, distinguishing between different network errors, and inspecting crucial response information.

Complexity:4/5
buggood first issue

Powerful network layer seamlessly integrating Combine Framework, Async/Await, and Closures.

Swift
#apple#async-await#closure#combine#ios#network#package#swift#swift-package-manager

一个简洁优雅的词典翻译 macOS App。开箱即用,支持离线 OCR 识别,支持有道词典,🍎 苹果系统词典,🍎 苹果系统翻译,OpenAI,Gemini,DeepL,Google,Bing,腾讯,百度,阿里,小牛,彩云和火山翻译。A concise and elegant Dictionary and Translator macOS App for looking up words and translating text.

Swift
#app#baidu#bing#deepl#dictionary#gemini#google#macos#ocr#openai#shortcuts#tencent#translate#translator#youdao

AI Summary: This issue requests the creation of a practical, copy-pasteable example demonstrating how to use Belay's local webhook to send 'work started' and 'work finished' notifications from a shell command. The example should be integrated into the documentation and tested with a running Belay instance.

Complexity:2/5
good first issuehelp wanted

💻 Keeps your Mac awake while your AI agents work. Built-in detection for Claude Code, Codex, Cline, Copilot plus presets for Gemini CLI, OpenCode, Aider and Pi.

Swift
#ai-agents#caffeinate#claude#claude-code#cline#codex#coding-agent#copilot-cli#developer-tools#gemini-cli#keep-awake#macos#macos-app#macos-utility#menu-bar#power-management#sleep-prevention#swift

AI Summary: This issue requests native speakers of German, Spanish, French, or Italian to review and correct translations within the Belay application. The task involves examining CSV files for unnatural wording, tone, idioms, or UI length issues and submitting a pull request with the corrected strings.

Complexity:2/5
good first issuehelp wanted

💻 Keeps your Mac awake while your AI agents work. Built-in detection for Claude Code, Codex, Cline, Copilot plus presets for Gemini CLI, OpenCode, Aider and Pi.

Swift
#ai-agents#caffeinate#claude#claude-code#cline#codex#coding-agent#copilot-cli#developer-tools#gemini-cli#keep-awake#macos#macos-app#macos-utility#menu-bar#power-management#sleep-prevention#swift

AI Summary: This issue proposes adding a new "one-click preset" to the Belay application for users of custom coding agents. The task involves identifying where a specific agent stores its session files and then adding a simple configuration entry to a Swift file, similar to existing presets. No complex logic or new detection mechanisms are required.

Complexity:2/5
good first issuehelp wanted

💻 Keeps your Mac awake while your AI agents work. Built-in detection for Claude Code, Codex, Cline, Copilot plus presets for Gemini CLI, OpenCode, Aider and Pi.

Swift
#ai-agents#caffeinate#claude#claude-code#cline#codex#coding-agent#copilot-cli#developer-tools#gemini-cli#keep-awake#macos#macos-app#macos-utility#menu-bar#power-management#sleep-prevention#swift

AI Summary: Users on macOS versions older than 15 encounter confusion when attempting to download models that are incompatible with their OS. The current behavior displays a progress bar that starts but never completes, leading users to believe the download is broken. The suggested solution is to either disable the download button with a compatibility message or prevent the progress bar from appearing for incompatible models.

Complexity:2/5
enhancementhelp wantedgood first issue

Muesli - local meeting transcription + dictation for macOS (Granola + WisprFlow alternative)

Swift
#apple-silicon#dictation#macos#meeting-assistant#meeting-notes#on-device-ai#privacy-first#speech-to-text#transcription

AI Summary: Users are experiencing unintended day selections on the activity chart when scrolling on the app's homepage. The issue proposes that the activity chart should only register taps and ignore scroll gestures to prevent interference with general scrolling.

Complexity:2/5
bughelp wantedgood first issue

Foqos allows you to lock apps behind the tap of a NFC tag or scan of a QR code. Free and open source alternative to Brick, Opal, ScreenZen, Unpluq, Blok and more!

Swift
#ios-app#productivity#swiftui

AI Summary: This issue reports several suggestions for improving the preview version of the Lithe application on Windows. The user requests better default settings for hiding paths, more configuration options for LSP, a different error display format, adjustments to window sizing, and improvements to the notification system, referencing IntelliJ IDEA as a benchmark. Additionally, there's a specific request to modify the jdtls packaging script to allow configuration or automatic detection of the host Java version.

Complexity:3/5
buggood first issuewindows

A lightweight, cross-platform IDE for the AI era, with on-demand tools and services.

Swift

AI Summary: The user is reporting that the application is not correctly recognizing their Colemak keyboard layout, instead treating it as a US layout. This results in incorrect key mappings for the user on both their laptop and external keyboards. The issue appears to be a bug in how the application detects or utilizes system keyboard layouts.

Complexity:3/5
bugenhancementhelp wantedgood first issue

MacOS Native app switcher

Swift
#app#apple#application#fast#gui#lightweight#mac#macos#open-source#opensource#productivity#swift#swiftui#xcode

AI Summary: The `container image list` command fails completely when a single content blob in the image store is unreadable. This prevents users from listing images with details like size and date, impacting automation and tooling. The issue suggests skipping unreadable entries with a warning or providing a way to prune broken content.

Complexity:3/5
good first issuereliability

A tool for creating and running Linux containers using lightweight virtual machines on a Mac. It is written in Swift, and optimized for Apple silicon.

Swift

AI Summary: The `forumMention` socket event currently lacks the `forumID`, making it difficult for the Tricordarr notification system to correctly cancel notifications when a user navigates to a forum without directly tapping a notification. Adding a `secondaryContentID` field to the `forumMention` socket event payload, specifically for the `forumID`, would enable more efficient notification cancellation.

Complexity:2/5
good first issue

The V3 Twitarr server and templated web interface.

Swift

Also browsing: Python , TypeScript , JavaScript