Skip to content

Repository files navigation

BiTodo

BiTodo preview

BiTodo is a tiny macOS menu bar todo app for people who want their active tasks to stay visible without opening a full productivity system.

It keeps a compact todo popover in the menu bar, can pin a small task strip near the top of the screen, and saves tasks as a simple local Markdown file.

Features

  • Menu bar app with a lightweight SwiftUI popover.
  • Add, rename, complete, restore, delete, and reorder tasks.
  • Optional always-visible task bar for the active queue.
  • Local Markdown storage at ~/Documents/BiTodo/tasks.md.
  • Launch-at-login toggle powered by SMAppService.
  • No account, sync service, analytics, or network dependency.

Screenshots

BiTodo app icon

Requirements

  • macOS 14.0 or later
  • Xcode 16.4 or later
  • Swift 6

Build

Open BiTodo.xcodeproj in Xcode and run the BiTodo scheme.

You can also build from the command line:

xcodebuild \
  -project BiTodo.xcodeproj \
  -scheme BiTodo \
  -configuration Release \
  CODE_SIGNING_ALLOWED=NO \
  build

The project also includes project.yml for XcodeGen users:

xcodegen generate

Data Format

BiTodo stores tasks in ~/Documents/BiTodo/tasks.md.

The current format is deliberately simple:

6月3日创建Write the README
6月3日创建Ship the icon(6月3日完成该任务)

Project Structure

BiTodo/
├── BiTodo/                 # Swift source and asset catalog
├── BiTodo.xcodeproj/       # Xcode project
├── docs/images/            # README images
├── project.yml             # XcodeGen project definition
└── README.md

Why BiTodo Exists

Most todo apps are too large for the smallest kind of work queue. BiTodo is intentionally narrow: keep a few tasks close, finish them, and get back to the work.

License

BiTodo is released under the MIT License. See LICENSE.

About

A tiny macOS menu bar todo app with a persistent task bar.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages