名称： nb
描述： 使用 nb CLI 管理笔记、书签和笔记本。通过 Git 版本控制，跨多个笔记本创建、列出、搜索和组织笔记。
作者： Benjamin Jesuiter bjesuiter@gmail.com
主页： https://github.com/xwmx/nb
元数据：
clawdbot:
emoji: "📓"
os: ["darwin", "linux"]
requires:
bins: ["nb"]

nb - 命令行笔记工具

⚠️ 重要提示： 切勿手动编辑 nb 的 Git 仓库文件（~/.nb/*）！请始终使用 nb CLI 工具，以确保正确的索引和 Git 提交。

一个命令行和本地网页端的笔记、书签与归档工具，采用纯文本数据存储，支持 Git 版本控制和维基式链接。

快速参考

笔记本管理

# 列出所有笔记本
nb notebooks

# 切换到指定笔记本
nb use <notebook>

# 创建新笔记本
nb notebooks add <name>

# 显示当前笔记本
nb notebooks current

添加笔记

# 添加带标题的笔记
nb add -t "标题" -c "内容"

# 添加到指定笔记本
nb <notebook>: add -t "标题" -c "内容"

# 添加带标签的笔记
nb add -t "标题" --tags 标签1,标签2

# 从文件内容添加笔记
nb add <notebook>:文件名.md

列出笔记

# 列出当前笔记本中的笔记
nb list

# 列出所有笔记（无数量限制）
nb list -a

# 列出指定笔记本中的笔记
nb <notebook>: list

# 列出笔记并显示摘要
nb list -e

# 列出笔记并显示标签
nb list --tags

查看笔记

# 通过 ID 或标题查看笔记
nb show <id>
nb show "<标题>"

# 查看指定笔记本中的笔记
nb show <notebook>:<id>

# 打印内容（用于管道操作）
nb show <id> --print

搜索笔记

# 在所有笔记本中搜索
nb search "查询词"

# 在指定笔记本中搜索
nb <notebook>: search "查询词"

# 使用 AND/OR/NOT 逻辑搜索
nb search "词条1" --and "词条2"
nb search "词条1" --or "词条2"
nb search "词条1" --not "排除词"

# 按标签搜索
nb search --tag "标签名"

编辑笔记

# 通过 ID 编辑
nb edit <id>

# 通过标题编辑
nb edit "<标题>"

# 追加内容
nb edit <id> -c "要追加的新内容"

# 前置内容
nb edit <id> -c "顶部内容" --prepend

# 覆盖全部内容
nb edit <id> -c "替换所有内容" --overwrite

删除笔记

# 通过 ID 删除（会提示确认）
nb delete <id>

# 强制删除（无需确认）
nb delete <id> -f

移动/重命名

# 将笔记移动到另一个笔记本
nb move <id> <notebook>:

# 重命名笔记
nb move <id> 新文件名.md

待办事项

# 添加待办事项
nb todo add "任务标题"

# 添加带截止日期的待办事项
nb todo add "任务" --due "2026-01-15"

# 列出未完成的待办事项
nb todos open

# 列出已完成的待办事项
nb todos closed

# 标记待办事项为已完成
nb todo do <id>

# 标记待办事项为未完成
nb todo undo <id>

书签

# 添加书签
nb bookmark <url>

# 添加带评论的书签
nb bookmark <url> -c "我的评论"

# 添加带标签的书签
nb bookmark <url> --tags 参考,开发

# 列出书签
nb bookmark list

# 搜索书签
nb bookmark search "查询词"

Git 操作

# 与远程仓库同步
nb sync

# 创建检查点（提交）
nb git checkpoint "提交信息"

# 检查未提交的更改
nb git dirty

# 运行任意 Git 命令
nb git status
nb git log --oneline -5

文件夹

# 向笔记本添加文件夹
nb folders add <文件夹名称>

# 列出文件夹
nb folders

# 向文件夹添加笔记
nb add <文件夹>/<文件名>.md

常用模式

添加包含完整内容的笔记

对于较长的笔记，可以先创建临时文件再导入：

# 先将内容写入临时文件，然后复制到 nb
cp /tmp/笔记.md ~/.nb/<notebook>/
cd ~/.nb/<notebook> && git add . && git commit -m "添加笔记"
nb <notebook>: index rebuild

全局搜索

# 搜索所有内容
nb search "词条" --all

# 按类型搜索
nb search "词条" --type bookmark
nb search "词条" --type todo

数据存储位置

笔记以 Markdown 文件形式存储在 ~/.nb/<notebook>/ 目录下，并带有 Git 版本控制。

~/.nb/
├── notebook-name-1/ # 你的第一个笔记本
├── notebook-name-2/ # 你的第二个笔记本
└── ...

使用技巧

1. 使用 nb <notebook>: 前缀来操作特定笔记本
2. ID 是 nb list 中显示的数字
3. 可以用标题代替 ID（如果包含空格，请用引号括起来）
4. 所有更改都会自动进行 Git 提交
5. 使用 nb sync 来推送/拉取远程仓库的更改