Skip to content

meloer101/DriftLog

Repository files navigation

DriftLog

The Creative Cockpit for Vibe Coders / 为 Vibe Coder 打造的创意驾驶舱

You have 5 projects in progress — but do you remember where each one stands? 你有 5 个进行中的项目,但你记得每个都走到哪了吗?

Version Platform License Built with

English · 中文


English

What is this

DriftLog is a macOS Menu Bar App built for solo developers juggling multiple projects at once.

It's not Linear, not Notion, not GitHub Issues. It's lighter, faster, always within reach — press Cmd+Shift+D, glance at it, see where every project stands, then get back to coding.

"Like a co-pilot. It doesn't drive, but it keeps you from taking the wrong turn."


Core Concepts

DriftLog's entire world has just three things:

Stamp — Reusable Task Nodes

A Stamp is a task, like "Finish login system", "Deploy to prod", or "Finalize UI design". Give it a name and a color, and it's alive.

The magic of Stamps is cross-project reuse. You never have to redefine "Integrate API", "Write tests", or "Ship it" for every new project — just pull them from your library.

Project — An Ordered Workflow

A Project is a group of Stamps arranged in sequence. Stack them like blocks and your project roadmap appears.

Commit — Proof of Progress

Finished a task? Mark that Stamp as done — that's a Commit. Add a note to log decisions made or pitfalls avoided. The progress bar updates automatically.


Why Not Just Use Other Tools

Tool The Problem
Linear / Jira Just opening it takes 30 seconds, and you don't need Sprint Planning
Notion Too freeform — you'll spend more time "designing the system" than using it
GitHub Issues Requires a Git workflow, not intuitive enough
Your brain Starts failing after 3 projects

DriftLog has one design principle: open to insight in under 3 seconds.


Features

  • Menu Bar resident — always visible, never intrudes on your workspace
  • Global shortcut Cmd+Shift+D — summon and dismiss anytime
  • Project progress snapshot — see completion percentage and current task at a glance
  • Stamp library — create reusable task stamps with custom names and colors
  • Drag-to-reorder — drag stamps to rearrange task order, works by feel
  • Commit log — mark done + optional note, progress updates live
  • Local database — data lives in local SQLite, no account, no subscription, no cloud

Quick Start

Requirements

  • macOS 12+
  • Node.js 18+

Run in Development

# Clone the repo
git clone https://github.com/your-username/driftlog.git
cd driftlog

# Install dependencies
npm install

# Start the dev server
npm run dev

Build for Distribution

# Build .dmg installer
npm run dist

Output is in the dist/ directory.


How to Use

Step 1: Build your Stamp library

Go to the Stamps page and spend 30 seconds creating a few stamps for your common tasks. Pick colors freely — but grouping similar tasks by color helps, e.g. green for "ship" tasks, orange for "design" tasks.

Step 2: Create a project, wire up the workflow

When creating a project, pick the stamps you need from your library and drag them into order. A clear task roadmap appears instantly.

Step 3: Start moving, Commit as you go

Write code, do design, integrate APIs. Finish a task — open DriftLog, mark the stamp done, jot two lines of notes.

That's it.


Tech Stack

Layer Technology
Framework Electron 33 + electron-vite
Renderer React 18 + TypeScript
State Zustand
Database better-sqlite3 (local SQLite)
Styling Tailwind CSS
Drag & Drop @dnd-kit

Database file lives at ~/Library/Application Support/driftlog/driftlog.db — fully local, your data belongs to you.


Roadmap

Version Key Features Status
v0.1 (MVP) Stamp system + Menu Bar + Commit log + Drag reorder Done
v2 AI task decomposition + Git auto-sync Planned
v3 Commit history timeline + data insights Planned

v2 core bet: when you describe a new project, AI auto-breaks it into a set of stamps — eliminating the last bit of friction in bootstrapping a workflow.


Author

Made by Jacoy — someone with too many projects in flight who had to build their own tool.


License

MIT — use it, fork it, do whatever.


中文

这是什么

DriftLog 是一个 macOS Menu Bar App,专门为同时推进多个项目的个人开发者而造。

它不是 Linear,不是 Notion,也不是 GitHub Issues。它更轻,更快,更随手可得——按下 Cmd+Shift+D,瞥一眼,知道你的每个项目走到哪了,然后继续写代码。

"就像副驾驶。它不开车,但它让你不会开错路。"


核心概念

DriftLog 的整个世界只有三个东西:

Stamp — 可复用的任务节点

一张 Stamp 就是一个任务,比如「完成登录系统」、「部署上线」、「UI 设计定稿」。你给它取个名字、选个颜色,它就活了。

Stamp 的精髓在于跨项目复用。你不需要为每个新项目从零开始定义「接入 API」「写测试」「上线部署」——从便签库里拖出来就行。

Project — 有序的工作流

一个 Project 就是一组按顺序排列的 Stamp。搭积木一样把便签拼起来,你的项目路线图就出现了。

Commit — 进度的证明

完成一个任务?把那张便签标记为完成,就是一次 Commit。可以附上备注,记录你踩过的坑、做过的决策。进度条会自动更新。


为什么不用其他工具

工具 问题所在
Linear / Jira 打开它本身就要花 30 秒,而且你不需要 Sprint Planning
Notion 太自由了,你会花更多时间"设计系统"而不是用它
GitHub Issues 需要 Git 工作流,不够直觉
脑子记 超过 3 个项目就开始出错

DriftLog 的设计原则只有一条:打开到获取信息,不超过 3 秒。


功能一览

  • Menu Bar 常驻 — 始终可见,不打扰主工作区
  • 全局快捷键 Cmd+Shift+D — 随时唤出,随时收起
  • 项目进度快照 — 一眼看到每个项目的完成百分比和当前任务
  • 便签库 — 创建可跨项目复用的任务便签,支持自定义名称和颜色
  • 拖拽排序 — 拖动便签调整任务顺序,直觉操作
  • Commit 记录 — 标记完成 + 可选备注,进度实时更新
  • 本地数据库 — 数据存在本地 SQLite,没有账户,没有订阅,没有云

快速上手

环境要求

  • macOS 12+
  • Node.js 18+

开发环境启动

# 克隆项目
git clone https://github.com/your-username/driftlog.git
cd driftlog

# 安装依赖
npm install

# 启动开发服务器
npm run dev

构建为可分发的应用

# 构建 .dmg 安装包
npm run dist

构建产物在 dist/ 目录下。


使用流程

第一步:创建你的便签库

进入 Stamps 页面,花 30 秒创建几张你常用的任务便签。颜色随意——但建议同类任务用同一种颜色,比如绿色代表「上线类」、橙色代表「设计类」。

第二步:新建项目,拼接工作流

创建项目时,从便签库里选出这个项目需要的便签,拖拽排好顺序。一个清晰的任务路线图就出现了。

第三步:开始推进,随时 Commit

写代码,做设计,接 API。完成了一个任务,打开 DriftLog,把对应便签标记为完成,顺手写两句备注。

就这样。


技术栈

层级 技术
框架 Electron 33 + electron-vite
渲染层 React 18 + TypeScript
状态管理 Zustand
数据库 better-sqlite3(本地 SQLite)
样式 Tailwind CSS
拖拽 @dnd-kit

数据库文件存储在 ~/Library/Application Support/driftlog/driftlog.db,完全本地,你的数据只属于你。


版本规划

版本 核心功能 状态
v0.1 (MVP) 便签系统 + Menu Bar + Commit 记录 + 拖拽排序 已完成
v2 AI 任务拆解 + Git 自动同步 规划中
v3 Commit 历史时间线 + 数据洞察 规划中

v2 的核心假设:当你描述一个新项目时,AI 帮你自动拆解成一组便签,消除手动搭建工作流的最后一点摩擦。


作者

Made by Jacoy — 一个同时有太多进行中项目、所以不得不自己造工具的人。


License

MIT — 随便用,随便改。

About

macOS menu bar app for Vibe Coders juggling multiple projects. Stamp-based task workflow + one-click commits. No account, no cloud, no noise.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors