{"skill":{"slug":"tasktime","displayName":"TaskTime CLI","summary":"CLI task timer for AI agents — benchmark learning progression with auto-save logs and visualizations. Integrates with ClawVault for persistent memory.","description":"---\nname: tasktime\ndescription: CLI task timer for AI agents — benchmark learning progression with auto-save logs and visualizations. Integrates with ClawVault for persistent memory.\nmetadata:\n  openclaw:\n    requires:\n      bins: [tasktime]\n    install:\n      - id: node\n        kind: node\n        package: \"@versatly/tasktime\"\n        bins: [tasktime, tt]\n        label: Install TaskTime CLI (npm)\n---\n\n# tasktime Skill\n\nCLI task timer for AI agents — benchmark learning progression with auto-save logs and visualizations.\n\n**Part of the [ClawVault](https://clawvault.dev) ecosystem** for AI agent memory.\n\n## Installation\n\n```bash\nnpm install -g @versatly/tasktime\n```\n\n## Quick Reference\n\n### Timer Commands\n```bash\ntasktime start \"Task description\" --category coding   # Start timing\ntasktime stop --notes \"What I learned\"                # Stop and save\ntasktime status                                       # Show current task\ntasktime now                                          # One-liner for prompts\n```\n\n### History & Search\n```bash\ntasktime history                    # Recent tasks (alias: tt ls)\ntasktime history -n 20              # Last 20 tasks\ntasktime history -c coding          # Filter by category\ntasktime search \"auth\"              # Full-text search\ntasktime categories                 # List all categories\n```\n\n### Reports & Charts\n```bash\ntasktime report                     # Full report with charts\ntasktime report --days 30           # Last 30 days\ntasktime chart --type bar           # Bar chart\ntasktime chart --type spark         # Sparkline\ntasktime chart --type line          # Line chart\n```\n\n### ClawVault Integration\n\n**Auto-save on stop (v1.2.0+):** Every completed task is automatically saved to [ClawVault](https://clawvault.dev):\n\n```bash\ntasktime start \"Build API\" -c coding\n# ... do the work ...\ntasktime stop --notes \"Finished in record time\"\n# ✅ Completed: Build API\n# 🐘 Saved to ClawVault              ← automatic!\n```\n\n**Manual sync and export:**\n```bash\ntasktime sync                       # Sync full report to ClawVault\ntasktime sync --days 30             # Sync last 30 days\ntasktime export                     # Export as markdown\ntasktime stop --no-vault            # Skip auto-save for one task\n```\n\n### Demo Data\n```bash\ntasktime seed                       # Seed sample data (empty DB only)\n```\n\n## Use Cases for Agents\n\n### Benchmarking Learning\nTrack how long similar tasks take over time to measure learning progression:\n\n```bash\ntt start \"Implement OAuth flow\" -c auth\n# ... do the work ...\ntt stop --notes \"Used passport.js, took 20min less than last time\"\n```\n\n### Sync to ClawVault\nPersist task data to your agent's memory vault:\n\n```bash\n# After completing work\ntasktime sync\n\n# Or pipe export to clawvault\ntasktime export | clawvault store --category research --title \"Task Report\"\n```\n\nLearn more: [clawvault.dev](https://clawvault.dev)\n\n### Category-Based Analytics\nGroup tasks to understand time allocation:\n\n```bash\ntt report --days 7\n# Shows time breakdown by category: coding, research, testing, docs, etc.\n```\n\n### Quick Status for Prompts\nAdd current task to your shell prompt:\n\n```bash\nPS1='$(tasktime now) \\$ '\n# Shows: ⏱️ Build API (23m) $\n```\n\n## Data Storage\n\n- Location: `~/.tasktime/tasks.json`\n- Format: JSON (portable, human-readable)\n- No external dependencies or databases\n\n## Related\n\n- [ClawVault](https://clawvault.dev) — Memory system for AI agents\n- [OpenClaw](https://openclaw.ai) — AI agent platform\n\n## Aliases\n\n- `tasktime` → Full command\n- `tt` → Short alias (same functionality)\n","tags":{"latest":"1.2.0"},"stats":{"comments":0,"downloads":1409,"installsAllTime":3,"installsCurrent":2,"stars":0,"versions":3},"createdAt":1770705245541,"updatedAt":1778486478500},"latestVersion":{"version":"1.2.0","createdAt":1770749308054,"changelog":"Auto-save to ClawVault on stop (🐘 emoji confirms). Use --no-vault to skip.","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"g9pedro","userId":"s170qw9ry89qte3815nzjvz1sh83mzvt","displayName":"G9Pedro","image":"https://avatars.githubusercontent.com/u/78662829?v=4"},"moderation":null}