Skip to content

Liftof/littletodo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LittleTodo

A tiny menu bar todo app for macOS. No Electron, no Xcode project, no dependencies — just a single Swift file compiled from the terminal.

macOS Swift License

Features

  • Lives in your menu bar — no Dock icon, no window clutter
  • Add tasks with Enter, check them off with a click
  • Double-click to edit, hover to reveal delete
  • Archive completed lists to timestamped JSON files
  • Data persisted locally in ~/Library/Application Support/LittleTodo/
  • Native macOS look and feel (SwiftUI + AppKit)
  • ~300 lines of Swift. That's it.

Install

Build from source

git clone https://github.com/Liftof/littletodo.git
cd littletodo
chmod +x build.sh
./build.sh

Then either:

# Run directly
open LittleTodo.app

# Or copy to Applications
cp -r LittleTodo.app /Applications/

Requirements

  • macOS 14.0 or later
  • Apple Silicon (arm64)
  • Xcode Command Line Tools (xcode-select --install)

Usage

Action How
Add a task Type in the field, press Enter
Complete a task Click the circle
Edit a task Double-click the text
Delete a task Hover, click ×
Archive all Click the Archive button
Quit Right-click the menu bar icon → Quit

How it works

The entire app is a single main.swift file:

  • SwiftUI for the popover UI
  • AppKit (NSStatusItem + NSPopover) for menu bar integration
  • JSON files in Application Support for persistence
  • Compiled with swiftc — no Xcode project needed

Project structure

littletodo/
├── main.swift      # The entire app
├── build.sh        # Build script
├── Info.plist      # App bundle metadata
├── LICENSE         # MIT
└── README.md

Launch at login

To start LittleTodo automatically:

  1. Open System SettingsGeneralLogin Items
  2. Click + and select LittleTodo.app

License

MIT — see LICENSE.

Author

Pierre-Baptiste Borges@Liftof

About

A tiny menu bar todo app for macOS. Single Swift file, no dependencies.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors