360 Secure SkillHub
360 安全技能中心

TaskTime CLI

提供 tasktime/tt 命令行工具，用于启动与停止任务计时、查询历史、按分类搜索、生成带图表的耗时报告，任务记录保存在本地 JSON 文件，并在任务完成时同步到 ClawVault 记忆库，适合衡量同类任务耗时变化与学习进展。

g9pedro
g9pedro
热度 88.99
最近更新 2026-05-11 16:01:18
分类：效率依赖：代码执行 / 读写文件 / 第三方 API应用场景：任务管理 / 报告撰写 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add tasktime
Metadata
name
tasktime
description
CLI task timer for AI agents — benchmark learning progression with auto-save logs and visualizations. Integrates with ClawVault for persistent memory.
metadata
{"openclaw":{"requires":{"bins":["tasktime"]},"install":[{"id":"node","kind":"node","package":"@versatly/tasktime","bins":["tasktime","tt"],"label":"Install TaskTime CLI (npm)"}]}}

tasktime Skill

CLI task timer for AI agents — benchmark learning progression with auto-save logs and visualizations.

Part of the ClawVault ecosystem for AI agent memory.

Installation

npm install -g @versatly/tasktime

Quick Reference

Timer Commands

tasktime start "Task description" --category coding   # Start timing
tasktime stop --notes "What I learned"                # Stop and save
tasktime status                                       # Show current task
tasktime now                                          # One-liner for prompts

History & Search

tasktime history                    # Recent tasks (alias: tt ls)
tasktime history -n 20              # Last 20 tasks
tasktime history -c coding          # Filter by category
tasktime search "auth"              # Full-text search
tasktime categories                 # List all categories

Reports & Charts

tasktime report                     # Full report with charts
tasktime report --days 30           # Last 30 days
tasktime chart --type bar           # Bar chart
tasktime chart --type spark         # Sparkline
tasktime chart --type line          # Line chart

ClawVault Integration

Auto-save on stop (v1.2.0+): Every completed task is automatically saved to ClawVault:

tasktime start "Build API" -c coding
# ... do the work ...
tasktime stop --notes "Finished in record time"
# ✅ Completed: Build API
# 🐘 Saved to ClawVault              ← automatic!

Manual sync and export:

tasktime sync                       # Sync full report to ClawVault
tasktime sync --days 30             # Sync last 30 days
tasktime export                     # Export as markdown
tasktime stop --no-vault            # Skip auto-save for one task

Demo Data

tasktime seed                       # Seed sample data (empty DB only)

Use Cases for Agents

Benchmarking Learning

Track how long similar tasks take over time to measure learning progression:

tt start "Implement OAuth flow" -c auth
# ... do the work ...
tt stop --notes "Used passport.js, took 20min less than last time"

Sync to ClawVault

Persist task data to your agent's memory vault:

# After completing work
tasktime sync

# Or pipe export to clawvault
tasktime export | clawvault store --category research --title "Task Report"

Learn more: clawvault.dev

Category-Based Analytics

Group tasks to understand time allocation:

tt report --days 7
# Shows time breakdown by category: coding, research, testing, docs, etc.

Quick Status for Prompts

Add current task to your shell prompt:

PS1='$(tasktime now) \$ '
# Shows: ⏱️ Build API (23m) $

Data Storage

  • Location: ~/.tasktime/tasks.json
  • Format: JSON (portable, human-readable)
  • No external dependencies or databases

Related

Aliases

  • tasktime → Full command
  • tt → Short alias (same functionality)