@versatly/tasktime

@versatly/tasktime ⏱️

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

Part of the ClawVault ecosystem for AI agent memory.

Install

npm install -g @versatly/tasktime

Usage

# Start timing a task
tasktime start "Build auth module" --category coding

# Check what's running
tasktime status

# Stop when done
tasktime stop --notes "Implemented JWT + refresh tokens"

# View history
tasktime history
tasktime ls -n 20

# Search tasks
tasktime search "auth"

# Get reports with charts
tasktime report
tasktime report --days 30

# Pretty charts
tasktime chart --type bar
tasktime chart --type line
tasktime chart --type spark

# List categories
tasktime categories

# One-liner for prompts
tasktime now  # ⏱️ Build auth module (1h 23m)

ClawVault Integration

Sync your task data to ClawVault for persistent agent memory:

# Install ClawVault
npm i -g clawvault

# Sync task report to your vault
tasktime sync
tasktime sync --days 30

# Export as markdown (pipe to clawvault or file)
tasktime export > task-report.md
tasktime export | clawvault store --category research --title "Weekly Tasks"

Learn more at clawvault.dev

Alias

tt is a shortcut:

tt start "Quick fix"
tt stop
tt report

Features

• ⏱️ Simple timer — start/stop with one command
• 📁 Categories — organize tasks by type
• 🔍 Full-text search — find any past task
• 📊 ASCII charts — bar, line, sparkline
• 💾 JSON storage — local, fast, portable
• 📝 Notes — attach context when stopping
• 🔗 ClawVault sync — persist to agent memory

Data

Stored in ~/.tasktime/tasks.json (JSON, human-readable).

Programmatic Use

import { startTask, stopTask, getTasks, getStats, syncToClawVault } from '@versatly/tasktime';

const task = startTask('My task', 'coding');
// ... do work ...
const completed = stopTask(task.id, 'Done!');

// Sync to ClawVault
syncToClawVault(7); // Last 7 days

Related

• ClawVault — Memory system for AI agents
• OpenClaw — AI agent platform

License

MIT