AI导哈

终端任务追踪器

一个基于终端的任务跟踪应用程序，具有三窗格布局，用于管理任务和项目计划。

  • by LiorStrugach
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 mryanmyn/task-manager-mcp

使用说明

终端任务跟踪器

一个基于终端的任务跟踪应用程序，具有三窗格布局，用于管理任务和项目计划。

图像

特性

  • 三窗格终端UI：
    • 任务列表（左上）
    • 任务详细信息（右上角）
    • 项目平面图（底部，全宽）
  • 任务管理：
    • 创建、查看、编辑和删除任务
    • 设定优先级和状态
    • 添加详细说明
  • 项目计划管理：
    • 定义高级项目步骤
    • 跟踪步骤完成情况
    • 重新排序步骤
  • 用于编程访问的完整API
  • 用于脚本编写的命令行界面
  • 数据持久性

安装

# Clone the repository
git clone https://github.com/yourusername/terminal-task-tracker.git
cd terminal-task-tracker

# Install dependencies
pip install -e .

用法

终端用户界面

要启动终端UI：

python -m main.py

密钥绑定：

  • Tab：在窗口之间循环
  • Up/Down：导航列表
  • Enter：选择任务（在任务列表中）
  • n：新项目（在任务列表或计划中）
  • e：编辑项目
  • d：删除项目
  • Space：切换完成（在计划中）
  • Esc：退出

命令行界面

CLI提供对所有功能的访问：

# List all tasks
python -m app.api.cli task list

# Add a new task
python -m app.api.cli task add "Implement feature X" --description "Details about feature X" --priority 2

# Mark a plan step as completed
python -m app.api.cli plan toggle STEP_ID

# Export data to JSON
python -m app.api.cli export data.json

API使用

from app.core.task_manager import TaskManager
from app.core.plan_manager import PlanManager
from app.api.api import TaskTrackerAPI

# Initialize managers
task_manager = TaskManager("tasks.json")
plan_manager = PlanManager("plan.json")

# Create API
api = TaskTrackerAPI(task_manager, plan_manager)

# Add a task
task = api.add_task("Implement feature X", "Details about feature X", priority=2)

# Add a plan step
step = api.add_plan_step("Design architecture for shared operations module")

# Mark step as completed
api.toggle_plan_step(step["id"])

# Save data
api.save_all()

项目结构

terminal-task-tracker/
├── app/
│   ├── __init__.py
│   ├── core/               # Business logic
│   │   ├── __init__.py
│   │   ├── task_manager.py
│   │   └── plan_manager.py
│   ├── ui/                 # Terminal UI
│   │   ├── __init__.py
│   │   ├── terminal_ui.py
│   │   ├── ui_components.py
│   │   └── input_handler.py
│   └── api/                # API and CLI
│       ├── __init__.py
│       ├── api.py
│       └── cli.py
├── main.py                 # Main application entry point
└── README.md

数据存储

默认情况下，数据存储在 ~/.tasktracker 目录：

  • tasks.json：任务数据
  • plan.json：项目计划数据
  • notes.json：注释数据

许可证

麻省理工学院

相关 MCP