掌控任务，从命令行开始：`na` 智能任务管理工具

掌控任务，从命令行开始：na 智能任务管理工具

项目简介

na 是一个简洁而强大的脚本工具，专为习惯在命令行环境中工作的人们设计，帮助您轻松查看和管理任何项目中的待办事项。它支持 TaskPaper 格式，但同样适用于其他纯文本格式的文件，通过查找标记有 @na 的任务（或者您可以自定义的标签）来提取待办事项。当您进入一个项目目录时，na 可以自动显示该目录及其子目录中的所有待办事项，极大地提升了工作效率。

项目技术分析

na 使用智能项目匹配功能，只需输入项目部分路径或名称，就能快速列出对应项目下的待办事项。此外，通过配置，您可以指定搜索文件的扩展名、待办事项的标签以及已完成的标志。它还支持递归搜索，可以一次性查找当前目录及其子目录内的所有待办事项。

添加新待办事项也是轻而易举，na 能在当前目录下的 todo.taskpaper 文件中创建新的任务，并自动将其标记为待办事项。如果文件不存在，它还会为您创建。

应用场景

• 当您需要快速浏览项目中的下一步行动时，无需打开复杂的任务管理软件，直接在终端输入 na 即可。
• 在切换到不同项目目录时，自动显示该项目的所有待办事项，让您的工作流程始终如一。
• 从命令行创建新任务，无论何时何地，只要有想法，都能立即记录下来。

项目特点

• 智能匹配：基于项目目录名称进行智能匹配，仅需输入部分项目名，即可列出相关待办事项。
• 递归搜索：通过 -r 开关，可搜索当前目录及其子目录的待办事项，深度可控。
• 快速添加：使用 -a 开关，可以在终端直接添加待办事项，自动加入 @na 标签并存储于当前项目文件中。
• 自定义配置：可以通过环境变量设置待办事项文件扩展名、待办和已办标签，以及最大递归深度。
• 自动显示：在切换目录时，通过设置，可以让 na 自动显示相应项目待办事项，确保时刻掌握进度。

安装与使用

1. 下载脚本：访问 GitHub
2. 将 na 放入您的 PATH 环境变量所在目录，并确保其可执行权限。

查看使用文档，了解更详细的选项和示例，以充分利用 na 的强大功能。

借助 na，您可以在保持命令行高效操作的同时，享受到便捷的任务管理体验。现在就开始您的智能任务管理之旅吧！