Two videos, ready for any screen.
Every render gives you a widescreen cut and a vertical cut. Apps spring in, hand over their spot and get a label right beside them, while the date and day count move with your story.
Set it once. Enjoy it for months.
A tiny background agent keeps the record for you, so the timelapse builds itself while you work.
-
Start recording
Run
dock-timelapse install, or just ask your AI agent. An hourly agent checks your Dock in the background. -
Keep working
Each day your Dock changes, it saves the app list, every icon in high resolution and your wallpaper.
-
Render the story
Run
dock-timelapse renderwhenever you like. Want a first look today?previewinvents a past that ends with your real Dock.
Install it your way.
Use it from the terminal or through the AI agent you already use. Everything needs macOS and uv; ffmpeg comes bundled.
The plugin adds the skill and the MCP server in one go. Run these inside Claude Code:
/plugin marketplace add bcldvd/dock-timelapse /plugin install dock-timelapse@dock-timelapse
Then ask in your own words:
- Start recording my Dock
- Show me what my Dock timelapse will look like
- Which apps did I add since June?
The skill follows the open Agent Skills format, so it works with Codex,
Cursor, Gemini CLI, GitHub Copilot and every agent that reads SKILL.md.
npx skills add bcldvd/dock-timelapse -y
Add the server to Claude Desktop, Cursor, VS Code or any MCP client:
{
"mcpServers": {
"dock-timelapse": {
"command": "uvx",
"args": ["dock-timelapse", "mcp"]
}
}
}For Codex, in ~/.codex/config.toml:
[mcp_servers.dock-timelapse] command = "uvx" args = ["dock-timelapse", "mcp"]
uv tool install dock-timelapse dock-timelapse install # start recording dock-timelapse preview # your video today, with an invented past dock-timelapse render # the real timelapse, in ~/Movies/Dock Timelapse
Add --format portrait, --background white or --screenshots to
tailor it. dock-timelapse status lists every change it has recorded.
Your Dock stays on your Mac.
Recording, rendering and storage all happen locally. The code is open source under the MIT license, so you can read every line.
- Reads the Dock's own list. It knows exactly which apps are pinned, in order, up to System Settings.
- Light on your Mac. One quick check an hour, and a snapshot only on days your Dock changes.
- Your files, your folder. History lives in
~/Library/Application Support/dock-timelapseand videos land in~/Movies. - Screenshots are your call. Turn them on with
--screenshotsfor a pixel-perfect record of each change.