任务列表生成工具

NotaNote是一款轻量级的macOS菜单栏应用,将LogSeq风格的Markdown转换为快速、随时可访问的任务列表,支持与AI助手集成和与其他工具同步。

  • by ogglord
  • Swift
  • 本地部署
  • 更新于
在 GitHub 查看 Ogglord/notanote-app

使用说明

注意事项

一个轻量级的macOS菜单栏应用程序,将LogSeq风格的markdown变成一个快速、始终可访问的待办事项列表。独立工作或与现有的LogSeq图一起工作——你的待办事项保持不变 .md 你永远拥有的文件。

内置 MCP服务器 因此,人工智能助手可以直接阅读、创建和管理你的待办事项。

为什么

  • 纯文本,零锁定 --todos以markdown文件的形式存在于 journals/ 和 pages/,与LogSeq使用的格式相同
  • 菜单栏本机 --一键查看你的盘子里有什么,键盘驱动,没有窗口管理
  • AI就绪 --内置的MCP服务器允许Claude、Cursor和其他代理处理您的任务列表
  • 与您的工具同步 --将Linear和Pylon中的问题自动拉入摘要页面
  • Git同步 --可选的自动提交+推送,以保持所有内容的备份

安装

swift build

双星降落在 .build/debug/NotaNote。在GUI上运行它,或使用 --mcp 用于无头MCP模式。

需要macOS 14+和Swift 5.9+。

运作原理

journals/2024_01_15.md          pages/linear-digest.md
         |                               |
         +--------> LogSeqParser <-------+
                        |
                   [ TodoItem ]
                        |
                    TodoStore (watches for file changes)
                        |
                  Menu bar popover

Todos是标准的LogSeq标记:

- TODO Buy groceries
- TODO [#A] Fix critical bug #work
- DOING [#B] Review the auth PR
- DONE Ship v2.0
- WAITING Deploy to staging DEADLINE: <2024-03-20>

标记: TODO DOING DONE NOW LATER WAITING CANCELLED 优先: [#A] 高, [#B] 中等, [#C] 低

存储

选择一个:

  • LogSeq模式 --将其指向您现有的图形
  • 单机模式 --用途 ~/.logseq-todos/ 具有相同的目录结构
  • Git同步 --在可配置的时间间隔内自动提交+推送

MCP服务器

添加到MCP客户端配置中:

{
  "mcpServers": {
    "logseq-todos": {
      "command": "/path/to/NotaNote",
      "args": ["--mcp"]
    }
  }
}

JSON-RPC 2.0通过标准输入/标准输出。可用工具:

工具 它做什么
list_todos 使用过滤器、搜索、标签、源进行查询
add_todo 添加到今天的日志
update_todo 更改状态(TODO/DOING/DONE/…)
add_source_todo 添加到线性/塔架摘要(重复数据消除)
remove_todo 删除一行
sync_source 批量替换摘要文件

用以下内容覆盖图形路径 --graph-path /your/path.

建筑

五个SPM模块,具有干净的依赖关系图:

Models          -- pure data types, Foundation-only
  ^       ^
  |       |
Services  Networking  -- file I/O, parsing | HTTP, Keychain
  ^  ^      ^    ^
  |  +--+---+    |
  |     |        |
  |    MCP       |  -- JSON-RPC server
  +----+----+----+
       |
  NotaNote          -- SwiftUI menu bar app

看 建筑.md 为了彻底崩溃。

许可证

麻省理工学院