explaingit

emanuele-web04/peekaboo

Analysis updated 2026-05-18

48SwiftAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A hideaway macOS and iPhone to-do list app that pops out from a screen corner and can sync with AI coding agents through a local server.

Mindmap

mindmap
  root((repo))
    What it does
      Hides in menu bar
      Reveals from screen corner
      Syncs Mac and iPhone via iCloud
      Lets AI agents manage tasks
    Tech stack
      Swift
      SwiftData
      CloudKit
      Model Context Protocol
    Use cases
      Quick distraction free task capture
      Sync tasks between Mac and iPhone
      Let an AI agent manage a task list
    Audience
      Mac and iPhone users
      Developers using AI agents
    Setup
      Build with Xcode
      Requires Apple developer account

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep a lightweight to-do list hidden in the Mac menu bar until needed.

USE CASE 2

Sync tasks automatically between a Mac and an iPhone through private iCloud.

USE CASE 3

Let an AI coding agent like Claude Code or Codex read and manage your task list.

USE CASE 4

Separate active tasks from a backlog of ideas not yet ready to act on.

What is it built with?

SwiftSwiftDataCloudKitMCP

How does it compare?

emanuele-web04/peekaboophun333/pi-infobarfatwang2/pulse
Stars484847
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Xcode, an Apple developer account, and matching iCloud/CloudKit configuration across both app targets to sync properly.

Licensed under MIT, which allows free use, modification, and commercial use as long as you keep the copyright notice.

In plain English

Peekaboo is a small native to-do list app for Mac and iPhone that stays hidden until you need it. On the Mac it lives in the menu bar with no icon in the Dock, and the task panel only appears when you move the mouse pointer into a screen corner you have chosen in Settings, or by pressing a global keyboard shortcut. A companion iPhone app shares the same task data and keeps everything in sync through the user's own private iCloud account, so nothing is sent to a third party server. Tasks can be organized into two separate lists, a main Tasks list and a Backlog for ideas not yet ready to act on, each with To do, In Progress, and Done states, along with four priority levels. The interface supports drag and drop reordering, double clicking to move a task between states, and dragging a task's title into another app as plain text. Completed tasks are cleaned up automatically once the day changes, and that cleanup syncs across devices too. One notable feature is that Peekaboo can optionally run a local server using the Model Context Protocol, a standard that lets AI coding assistants and agents read and update data on your computer. When turned on in Settings, tools like Claude Code, Codex, or Cursor can list, create, update, and complete tasks directly, with every change showing up live in the Peekaboo panel. This feature is off by default and requires a randomly generated access token shown in Settings, and only accepts connections from the same computer. Building the app requires Xcode and an Apple developer account, since it uses iCloud and CloudKit for syncing, which needs its own container setup and matching development team across both the Mac and iPhone targets. The README includes detailed steps for setting up iCloud syncing correctly and notes some quirks around syncing in the Simulator versus real devices. The project is aimed at Mac and iPhone users who want a lightweight, distraction free to-do list, and developers comfortable building and signing their own Xcode projects, since there is no pre-built download mentioned. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how Peekaboo's screen corner reveal feature works and how to configure it.
Prompt 2
Walk me through setting up iCloud and CloudKit syncing for this app between Mac and iPhone.
Prompt 3
Help me connect Claude Code to Peekaboo's local MCP server so it can manage my tasks.
Prompt 4
Show me how to build and run this project in Xcode for the first time.

Frequently asked questions

What is peekaboo?

A hideaway macOS and iPhone to-do list app that pops out from a screen corner and can sync with AI coding agents through a local server.

What language is peekaboo written in?

Mainly Swift. The stack also includes Swift, SwiftData, CloudKit.

What license does peekaboo use?

Licensed under MIT, which allows free use, modification, and commercial use as long as you keep the copyright notice.

How hard is peekaboo to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is peekaboo for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.