IssuesTracker
Local-First Issue Tracking
Overview
A lightweight, local-first issue tracker designed for developers who want to keep their project issues alongside their code. Built with SwiftUI for macOS, IssuesTracker stores issues in a simple .issues JSON file in your project directory, making it easy to version control your issues with git.
Interface
Native macOS app with sidebar navigation and a companion CLI for terminal workflows.
Key Features
Local-First Storage
Issues are stored in a .issues file right in your project directory. No cloud services, no accounts required. Your issues live with your code and can be tracked in version control.
CLI Companion
A full-featured command-line interface lets you manage issues directly from the terminal. Create, close, comment, and edit issues without leaving your workflow. Perfect for quick updates during development sessions.
Issue Management
Full issue lifecycle support including priority levels (low, medium, high, critical), labels for categorization, comments for discussion, and automatic history tracking for all changes made to an issue.
Multi-Project Support
The macOS app supports managing multiple projects simultaneously. Add any directory containing a .issues file and switch between projects from the sidebar.
Technology
The GUI application is built with Swift and SwiftUI, using the MVVM architecture pattern. The CLI tool is a standalone Swift script that can be compiled and placed in your PATH for system-wide access. Both tools share the same data model and JSON file format, ensuring seamless interoperability.