AI任务管理工具

Taskr是一个AI原生的任务管理工具,专为Claude Code和MCP兼容的代理设计,通过GitHub集成实现任务的自动化创建、跟踪和管理,同时提供开发日志功能以持久化AI记忆。

  • by rhea-impact
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 rhea-impact/taskr

使用说明

AI-native task management for Claude Code and MCP-compatible agents.


为什么选择Taskr?

停止为SaaS付费,与团队一起管理您的项目。 不再有吉拉。不再是Asana。不再是线性的。只需使用Taskr(免费)和GitHub Projects/Issues(也免费)。

魔法? 你的代码和任务放在同一个地方。 GitHub成为你唯一的真相来源——非常适合开源项目、闭源项目或介于两者之间的任何项目。AI喜欢所有数据都集中在一个地方,你的团队也是如此。

Taskr自动化Claude Code在GitHub中创建计划,然后像真正的软件开发团队一样更新和遵循这些计划。只需说:

“使用任务分类来______”

…无论你需要完成什么,都可以。Taskr会制定计划。

如果克劳德中途停下来? 只需再次说“使用任务分类”。Triage旨在找出你的项目在哪里中断,保持积压工作的干净,保持项目的有序性等等。

虽然这只是Taskr为团队所做工作的开始,但这足以 从今天开始,将Claude Code的输出增加一倍或三倍。

这是一种低固执己见的方式,可以使用世界上最好的编码代理Claude Code来组织项目,而不会妨碍Claude。使用Claude Code你喜欢怎么使用它,但调用 taskr triage 只要你需要确保克劳德按照计划行事。

Taskr构建Taskr

我们使用Taskr来构建Taskr。下面是它的样子:

GitHub Projects kanban—tasks move from Todo → In Progress → Done

GitHub Issues with labels—all managed by Claude Code via Taskr


Taskr随时间学习

秘制酱汁? 开发日志。

每次Claude做出决定、修复错误或了解你的代码库时,Taskr都会记录下来。这些不仅仅是日志,而是 持久AI记忆 它可以在会话、上下文窗口甚至不同的Claude实例中生存。

这意味着:

  • 🧠 克劳德记得 你的代码库中哪些有效(哪些无效)
  • 🔍 可搜索历史记录 每一个架构决策、错误修复和模式
  • 📚 机构知识 会话结束时,它不会走出门
  • ⚡ 加速爬坡 当Claude启动新会话时,它可以先搜索devlogs

即将推出:与任务型员工深度睡眠

对于职业球队,我们正在建设 任务工--在非工作时间运行的后台服务,用于:

  • 🌙 整合内存 -总结和压缩开发日志,同时保留关键见解
  • 🧹 修剪那些无关紧要的东西 -自动归档过时或低价值的条目
  • 🔗 建立联系 -将相关的开发日志、问题和决策链接在一起
  • 📈 随着时间的推移而改善 -您使用Taskr的次数越多,它就越聪明

更多细节即将公布。目前,devlogs本身将改变Claude Code在您的项目中的工作方式。


特征

  • 任务管理 -使用完整的CRUD操作创建、跟踪和搜索任务
  • 开发日志 -跨会话的持久AI内存(决策、错误修复、模式)
  • 代理会话 -协调多代理工作与交接和工作索赔
  • GitHub集成 -内置项目V2、问题和PR(无需插件)
  • 双数据库支持 -PostgreSQL供团队使用,SQLite供本地使用
  • 插件架构 -通过Skillsflows、Supabase和自定义集成进行扩展

快速开始

本地设置(SQLite-零配置)

pip install taskr-mcp
taskr-mcp

添加到您的Claude Code MCP配置中(~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "taskr": {
      "command": "taskr-mcp",
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-token"
      }
    }
  }
}

注: 创建一个 GitHub个人访问令牌 随着 repo 和 project 范围。对两台服务器使用相同的令牌。

为什么两者都有? GitHub MCP 不能 管理项目V2(无创建/读取/更新/删除)。由于GitHub项目现在是组织级(而不是仓库级),taskr提供了缺失的项目CRUD。GitHub MCP处理仓库操作(问题、PR、搜索、评论)。

团队设置(PostgreSQL)

pip install taskr-mcp

# Configure database
export TASKR_DATABASE_URL="postgresql://user:pass@host:5432/taskr"

# Run migrations
taskr-mcp migrate

# Start server
taskr-mcp

配置

创建 ~/.taskr/config.yaml:

database:
  type: sqlite  # or "postgres"
  sqlite:
    path: ~/.taskr/taskr.db
  postgres:
    url_env: TASKR_DATABASE_URL

identity:
  author: your-name
  agent_id: claude-code

plugins:
  enabled:
    - github

核心工具

任务管理

  • taskr_list -使用筛选器列出任务
  • taskr_create -创建新任务
  • taskr_show -显示任务详细信息
  • taskr_update -更新任务
  • taskr_search -搜索任务
  • taskr_assign -分配给用户
  • taskr_close -标记完成

开发日志(AI内存)

  • devlog_add -创建日志条目
  • devlog_list -列出条目
  • devlog_search -全文搜索
  • devlog_get -获取完整内容

代理会话

  • session_start -使用上下文启动会话
  • session_end -以交接单结束
  • claim_work -原子索赔工作项
  • release_work -释放索赔工作
  • what_changed -查看最近的更改

SQL工具

  • taskr_sql_query -执行即席SQL查询
  • taskr_sql_explain -分析查询性能
  • taskr_sql_migrate -使用审核日志运行SQL

GitHub项目V2(GitHub MCP无法做到这一点)

GitHub MCP没有项目管理功能。由于Projects V2是组织级(而不是仓库级),taskr提供了缺失的CRUD:

  • github_project_create -创建新的Project V2
  • github_project_items -列出输出最小的项目项
  • github_project_add_item -将问题/PR添加到项目中
  • github_project_close / github_project_reopen -存档/恢复项目
  • github_create_issue_in_project -以原子方式创建问题和项目链接
  • github_pr_create -通过智能问题链接创建PR(自动添加到项目中)
  • github_get_issue_id / github_get_org_id -获取API调用的节点ID

注: 使用GitHub MCP(mcp__github__*)用于回购级操作:阅读问题、搜索、评论、列出PR等。

实用

  • taskr_triage -工作流程指导
  • taskr_health -数据库健康检查
  • taskr_migrate -运行挂起的迁移

插件

安装扩展功能的可选插件:

# Workflow definitions
pip install taskr-plugin-skillflows

# Supabase deployments
pip install taskr-plugin-supabase

在配置中启用:

plugins:
  enabled:
    - skillflows

发展

# Clone
git clone https://github.com/rhea-impact/taskr.git
cd taskr

# Install in dev mode
pip install -e packages/taskr-core
pip install -e packages/taskr-mcp

# Run tests
pytest tests/

许可证

MIT许可证-请参阅 许可证