crowdtime-cli 0.1.0

AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest

CrowdTime CLI

AI-powered time tracking from your terminal. A modern, developer-friendly alternative to Harvest.

Track time, manage projects, generate reports, and get AI-powered insights — all without leaving your terminal.

Features

• Fast time tracking — Start/stop timers or log entries directly with natural duration formats (2h30m, 1:45, 0.5d)
• AI-powered — Natural language time entry, smart suggestions based on your patterns, and automatic standup/slack summaries
• Rich terminal UI — Beautiful tables, dashboards, and reports powered by Rich
• Multi-org support — Switch between organizations seamlessly
• Secure by default — API tokens stored in your OS keychain, never in plain text
• Flexible reporting — Daily, weekly, monthly reports in table, JSON, CSV, or Markdown formats
• Favorites & templates — Save common entries for one-command reuse
• Claude Code integration — Ships as a Claude Code skill for AI-assisted time tracking

Installation

pip install crowdtime-cli

Requires Python 3.11+

Quick Start

# Authenticate
ct config set server.url https://api.crowdtime.lat
ct auth login

# Switch to your organization
ct org switch my-org

# Start tracking
ct timer start "Building REST API" -p backend -t "Development"
ct timer stop

# Or log time directly
ct log -p backend -t "Code Review" 2h "Reviewed auth module PR"

# Check your day
ct status

# Weekly report
ct report --week

Command Overview

Command	Alias	Description
ct status	ct s	Dashboard: running timer, today's entries, weekly total
ct timer start	ct ts	Start a timer with project and task
ct timer stop	ct tx	Stop the running timer and save the entry
ct log <duration> <desc>	ct l	Log a time entry directly
ct log list	ct ll	List time entries (today, --week, --month)
ct report	ct r	Generate reports with grouping and filters
ct projects list	ct p	List projects
ct ai suggest	—	Get AI suggestions based on your patterns
ct ai summarize	—	AI-generated summaries (--for standup, --for slack)

Duration Formats

2h | 2h30m | 2:30 | 150m | 0.25d (1 day = 8h) | 1.5 (hours)

Date Formats

today | yesterday | monday..sunday | last friday | 2026-03-10 | 3/10

Configuration

ct config set server.url https://api.crowdtime.lat   # API server
ct config set defaults.project my-project             # Default project
ct config set defaults.daily_target 7h                # Daily hour target
ct config list                                        # Show all settings

Config is stored at ~/.crowdtime/config.toml.

Authentication

CrowdTime supports multiple auth methods:

ct auth login                    # Browser-based Google OAuth (default)
ct auth login --token <token>    # API token (for CI/scripts)
ct auth login --no-browser       # Token prompt (headless environments)

API tokens are stored securely in your OS keychain via keyring.

Requirements

• Python 3.11+
• A CrowdTime account at crowdtime.lat

Support

For issues and feature requests, contact [e-mail].

License

Proprietary. See LICENSE for details.