@versatly/tasktime

@versatly/tasktime ⏱️

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

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)

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
• 💾 SQLite storage — local, fast, reliable
• 📝 Notes — attach context when stopping

Data

Stored in ~/.tasktime/tasks.db (SQLite).

Programmatic Use

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

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

License

MIT