运行时依赖
安装命令
点击复制技能文档
Todozi Quick 启动
As SDK:
from 技能s.todozi.scripts.todozi 导入 Todozi命令行工具ent
命令行工具ent = Todozi命令行工具ent(API_key="your_key") matrices = awAIt 命令行工具ent.列出_matrices() task = awAIt 命令行工具ent.创建_task("Build feature", priority="high") awAIt 命令行工具ent.complete_item(task.id)
As LangChAIn 工具s:
from 技能s.todozi.scripts.todozi 导入 TODOZI_工具S # 添加 to 代理 工具s 列出
SDK Overview Class Purpose Todozi命令行工具ent A同步 API 命令行工具ent TodoziTask Task dataclass TodoziMatrix Matrix dataclass TodoziStats Stats dataclass 环境 导出 TODOZI_API_KEY=your_key 导出 TODOZI_BASE=https://todozi.com/API # optional, default provided
命令行工具ent Methods Matrices # 列出 all matrices matrices = awAIt 命令行工具ent.列出_matrices()
# 创建 matrix matrix = awAIt 命令行工具ent.创建_matrix("Work", category="do")
# 获取 matrix matrix = awAIt 命令行工具ent.获取_matrix("matrix_id")
# 删除 matrix awAIt 命令行工具ent.删除_matrix("matrix_id")
Tasks / Goals / Notes # 创建 task task = awAIt 命令行工具ent.创建_task( title="Review PR", priority="high", due_date="2026-02-01", description="检查 the new feature", tags=["pr", "review"], )
# 创建 goal goal = awAIt 命令行工具ent.创建_goal("Ship v2", priority="high")
# 创建 note note = awAIt 命令行工具ent.创建_note("Remember to call Mom")
# 获取 item item = awAIt 命令行工具ent.获取_item("item_id")
# 更新 item 更新d = awAIt 命令行工具ent.更新_item("item_id", {"title": "New title", "priority": "low"})
# Complete item awAIt 命令行工具ent.complete_item("item_id")
# 删除 item awAIt 命令行工具ent.删除_item("item_id")
列出s # 列出 tasks (with 过滤器s) tasks = awAIt 命令行工具ent.列出_tasks(状态="todo", priority="high")
# 列出 goals goals = awAIt 命令行工具ent.列出_goals()
# 列出 notes notes = awAIt 命令行工具ent.列出_notes()
# 列出 everything all_items = awAIt 命令行工具ent.列出_all()
搜索
搜索es only: title, description, tags (NOT content)
结果s = awAIt 命令行工具ent.搜索( 查询="pr", type_="task", # task, goal, or note 状态="pending", priority="high", category="do", tags=["review"], limit=10, )
Bulk Operations # 更新 multiple awAIt 命令行工具ent.bulk_更新([ {"id": "id1", "title": "更新d"}, {"id": "id2", "priority": "low"}, ])
# Complete multiple awAIt 命令行工具ent.bulk_complete(["id1", "id2"])
# 删除 multiple awAIt 命令行工具ent.bulk_删除(["id1", "id2"])
网页hooks # 创建 网页hook 网页hook = awAIt 命令行工具ent.创建_网页hook( url="https://yoururl.com/todozi", 事件=["item.创建d", "item.completed"], )
# 列出 网页hooks 网页hooks = awAIt 命令行工具ent.列出_网页hooks()
# 更新 网页hook awAIt 命令行工具ent.更新_网页hook(网页hook_id, url, [""])
# 删除 网页hook awAIt 命令行工具ent.删除_网页hook(网页hook_id)
系统 # Stats stats = awAIt 命令行工具ent.获取_stats()
# 健康 检查 健康 = awAIt 命令行工具ent.健康_检查()
# 验证 API key valid = awAIt 命令行工具ent.验证_API_key()
# Register (获取 API key) keys = awAIt 命令行工具ent.register(网页hook="https://url.com")
LangChAIn 工具s
The 技能 provides @工具 decorated functions for 代理 integration:
from 技能s.todozi.scripts.todozi 导入 TODOZI_工具S
# AvAIlable 工具s: # - todozi_创建_task(title, priority, due_date, description, thread_id, tags) # - todozi_列出_tasks(状态, priority, thread_id, limit) # - todozi_complete_task(task_id) # - todozi_获取_stats() # - todozi_搜索(查询, type_, 状态, priority, limit) # - todozi_列出_matrices()
Categories Category Description do Do now (urgent + 导入ant) delegate Delegate (urgent + not 导入ant) defer Defer (not urgent + 导入ant) done Completed items dream Goals/dreams (not urgent + not 导入ant) dont Don't do (neither) Common Patterns
Auto-创建 default matrix:
task = awAIt 命令行工具ent.创建_task("My task") # 创建s "Default" matrix if needed
获取 stats with completion rate:
stats = awAIt 命令行工具ent.获取_stats() rate = stats.completed_tasks / stats.total_tasks 100 if stats.total_tasks > 0 else 0
搜索 with multiple 过滤器s:
结果s = awAIt 命令行工具ent.搜索("feature", type_="task", 状态="pending", priority="high")
Complete multiple tasks:
tasks = awAIt 命令行工具ent.列出_tasks(状态="todo") ids = [t.id for t in tasks[:5]] awAIt 命令行工具ent.bulk_complete(ids)