crowdtime-cli 0.1.0__py3-none-any.whl

crowdtime_cli/skills/crowdtime/references/workflows.md

@@ -0,0 +1,286 @@
+# CrowdTime CLI — Common Workflows
+
+Multi-step workflow patterns for real-world time tracking scenarios.
+
+## Table of Contents
+
+- [Daily Routines](#daily-routines)
+- [End of Week](#end-of-week)
+- [Project Setup](#project-setup)
+- [Backfilling Time](#backfilling-time)
+- [Team Management](#team-management)
+- [Reporting and Export](#reporting-and-export)
+- [Troubleshooting](#troubleshooting)
+
+---
+
+## Daily Routines
+
+### Morning Start
+
+```bash
+# Check what's going on
+ct s
+
+# Start working
+ct ts "morning standup" -p team-meetings
+```
+
+### Switch Between Tasks
+
+```bash
+# Atomic switch — stops current timer and starts new one
+ct timer switch "API endpoint work" -p backend
+
+# Or stop and start separately
+ct tx
+ct ts "design review" -p frontend
+```
+
+### End of Day
+
+```bash
+# Stop running timer
+ct tx
+
+# Check today's log
+ct ll --date today
+
+# See total hours
+ct s
+```
+
+### Quick Entry Without Timer
+
+If you forgot to use a timer, log directly:
+
+```bash
+ct l -p acme-project 1h30m "client call with Acme"
+ct l -p backend 45m "code review for PR #234"
+```
+
+---
+
+## End of Week
+
+### Weekly Review
+
+```bash
+# See the full week at a glance
+ct s
+
+# Detailed report grouped by project
+ct report --week -g project
+
+# Report grouped by day to spot gaps
+ct report --week -g day
+
+# Get AI summary for standup
+ct ai summarize --week --for standup
+
+# Get AI summary for Slack, auto-copied
+ct ai summarize --week --for slack --copy
+```
+
+### Fill In Missing Days
+
+```bash
+# Check what days are light
+ct report --week -g day
+
+# Backfill entries
+ct l -p project-alpha -d monday 6h "feature development"
+ct l -p project-alpha -d monday 2h "code review"
+ct l -p project-beta -d tuesday 7h "API integration"
+```
+
+### Export for Invoicing
+
+```bash
+# CSV export for spreadsheet
+ct report --month -p client-project -f csv > march-2026-hours.csv
+
+# Markdown for docs/email
+ct report --month -g project -f markdown
+
+# JSON for programmatic use
+ct report --month -f json
+```
+
+---
+
+## Project Setup
+
+### Create a New Project with Tasks
+
+```bash
+# Create the project (client is auto-created if it doesn't exist)
+ct projects create "Website Redesign" --client "Acme Corp" --budget 200 --code WR -b
+
+# Create tasks for the project (use project slug, not display name)
+ct tasks create "Design" -p website-redesign -b
+ct tasks create "Development" -p website-redesign -b
+ct tasks create "QA Testing" -p website-redesign -b
+ct tasks create "Meetings" -p website-redesign -B  # non-billable
+
+# Set as default if it's your main project
+ct projects switch website-redesign
+```
+
+### Create Favorites for Recurring Work
+
+```bash
+# Create templates for things you do every day
+ct favorites create "Daily standup" -p team-meetings -t standup
+ct favorites create "Code review" -p engineering -t review -b
+ct favorites create "Sprint planning" -p team-meetings -t planning
+
+# Start a timer from a favorite
+ct favorites list    # find the ID
+ct favorites start <id>
+```
+
+---
+
+## Backfilling Time
+
+### Log a Full Past Day
+
+```bash
+# Log multiple entries for yesterday (options MUST come before duration/description)
+ct l -p team -d yesterday 1h "standup + planning"
+ct l -p project-alpha -d yesterday -b 4h "feature implementation"
+ct l -p project-alpha -d yesterday -b 2h "code review"
+ct l -p project-alpha -d yesterday -B 1h "documentation"
+```
+
+### Log for a Specific Past Date
+
+```bash
+ct l -p training -d "last wednesday" 8h "workshop"
+ct l -p acme -d 2026-03-05 3h "client meeting"
+```
+
+---
+
+## Team Management
+
+### Onboard a New Team Member
+
+```bash
+# Invite them
+ct org invite newdev@company.com -r member
+
+# They need to:
+# 1. Accept the invitation (via email link)
+# 2. Install CLI: pip install crowdtime-cli
+# 3. Configure:
+#    ct config set server.url https://your-server.com
+#    ct auth login
+#    ct org switch your-org
+```
+
+### Check Team Activity
+
+```bash
+# Team utilization this week
+ct report team --week
+
+# Specific member
+ct report team --month --member john@company.com
+
+# List all members
+ct org members
+```
+
+---
+
+## Reporting and Export
+
+### Client Billing Report
+
+```bash
+# Monthly billable hours for a specific project
+ct report --month -p client-project -f csv > invoice-data.csv
+
+# Project breakdown across all projects
+ct report projects --month
+
+# Detailed with day-by-day breakdown
+ct report --from 2026-03-01 --to 2026-03-31 -g day -p client-project
+```
+
+### Personal Productivity
+
+```bash
+# How did I spend my week?
+ct report --week -g project
+
+# Daily breakdown
+ct report --week -g day
+
+# Get AI insights
+ct ai summarize --week
+```
+
+### Custom Date Ranges
+
+```bash
+# Last two weeks
+ct report --from 2026-02-24 --to 2026-03-09
+
+# Specific sprint (2 weeks)
+ct report --from 2026-03-01 --to 2026-03-14 -g task
+
+# Quarter to date
+ct report --from 2026-01-01 --to 2026-03-31 -g project -f markdown
+```
+
+---
+
+## Troubleshooting
+
+### "Not authenticated" Error
+
+```bash
+ct auth whoami           # Check current auth status
+ct auth login            # Re-authenticate (opens browser)
+ct auth login --token <your-token>  # Or use a token directly
+```
+
+### "No organization selected" Error
+
+```bash
+ct org list              # See available orgs
+ct org switch <slug>     # Select one
+```
+
+### "Timer already running" Error
+
+```bash
+ct t                     # See what's running
+ct timer switch "new task" -p project   # Switch to new task
+# or
+ct tx                    # Stop current timer first
+```
+
+### Wrong Default Project
+
+```bash
+ct config get defaults.project      # Check current default
+ct projects switch <correct-slug>   # Change it
+```
+
+### Server Connection Issues
+
+```bash
+ct config get server.url            # Check configured URL
+ct config set server.url https://api.crowdtime.lat   # Fix if needed
+```
+
+### Check Current Configuration
+
+```bash
+ct config list                      # See all settings
+ct config edit                      # Edit in your editor
+```

crowdtime_cli/utils.py

@@ -0,0 +1,166 @@
+"""Utility functions for duration parsing, date parsing, and formatting."""
+
+from __future__ import annotations
+
+import re
+from datetime import date, timedelta
+from decimal import Decimal, InvalidOperation
+
+
+def parse_duration(text: str) -> Decimal:
+    """Parse a duration string into decimal hours.
+
+    Accepts:
+        "2h"       -> 2.0
+        "2h30m"    -> 2.5
+        "2.5h"     -> 2.5
+        "2.5"      -> 2.5 (assumed hours)
+        "2:30"     -> 2.5
+        "150m"     -> 2.5
+        "0.25d"    -> 2.0 (1 day = 8h)
+        "30"       -> 0.5 (assumed minutes if <= 480, else error)
+    """
+    text = text.strip().lower()
+
+    # Format: 2:30
+    match = re.match(r"^(\d+):(\d{1,2})$", text)
+    if match:
+        hours = int(match.group(1))
+        minutes = int(match.group(2))
+        return Decimal(str(hours)) + Decimal(str(minutes)) / Decimal("60")
+
+    # Format: 2h30m or 2h 30m
+    match = re.match(r"^(\d+(?:\.\d+)?)\s*h\s*(?:(\d+)\s*m)?$", text)
+    if match:
+        hours = Decimal(match.group(1))
+        minutes = Decimal(match.group(2) or "0")
+        return hours + minutes / Decimal("60")
+
+    # Format: 150m
+    match = re.match(r"^(\d+(?:\.\d+)?)\s*m$", text)
+    if match:
+        return Decimal(match.group(1)) / Decimal("60")
+
+    # Format: 0.25d
+    match = re.match(r"^(\d+(?:\.\d+)?)\s*d$", text)
+    if match:
+        return Decimal(match.group(1)) * Decimal("8")
+
+    # Format: 2.5h (explicit hours)
+    match = re.match(r"^(\d+(?:\.\d+)?)\s*h$", text)
+    if match:
+        return Decimal(match.group(1))
+
+    # Format: plain number - assume hours
+    match = re.match(r"^(\d+(?:\.\d+)?)$", text)
+    if match:
+        value = Decimal(match.group(1))
+        return value
+
+    raise ValueError(f"Cannot parse duration: '{text}'. Try formats like 2h, 2h30m, 2:30, 150m, 0.25d")
+
+
+def format_duration(hours: Decimal | float | str | None) -> str:
+    """Format decimal hours into a human-readable string like '2h 30m'."""
+    if hours is None:
+        return "0m"
+    try:
+        h = Decimal(str(hours))
+    except (InvalidOperation, ValueError):
+        return "0m"
+
+    if h <= 0:
+        return "0m"
+
+    total_minutes = int(h * 60)
+    hrs = total_minutes // 60
+    mins = total_minutes % 60
+
+    if hrs and mins:
+        return f"{hrs}h {mins}m"
+    elif hrs:
+        return f"{hrs}h"
+    else:
+        return f"{mins}m"
+
+
+def parse_date(text: str) -> date:
+    """Parse a date string into a date object.
+
+    Accepts:
+        "today"         -> today
+        "yesterday"     -> yesterday
+        "monday"        -> most recent Monday
+        "last friday"   -> previous week's Friday
+        "2026-03-10"    -> date(2026, 3, 10)
+        "3/10"          -> date(current_year, 3, 10)
+        "03/10/2026"    -> date(2026, 3, 10)
+    """
+    text = text.strip().lower()
+    today = date.today()
+
+    if text == "today":
+        return today
+
+    if text == "yesterday":
+        return today - timedelta(days=1)
+
+    # Day names
+    day_names = {
+        "monday": 0, "tuesday": 1, "wednesday": 2, "thursday": 3,
+        "friday": 4, "saturday": 5, "sunday": 6,
+        "mon": 0, "tue": 1, "wed": 2, "thu": 3,
+        "fri": 4, "sat": 5, "sun": 6,
+    }
+
+    # "last <day>"
+    match = re.match(r"^last\s+(\w+)$", text)
+    if match:
+        day_name = match.group(1)
+        if day_name in day_names:
+            target = day_names[day_name]
+            days_back = (today.weekday() - target) % 7
+            if days_back == 0:
+                days_back = 7
+            days_back += 7  # "last" means previous week
+            return today - timedelta(days=days_back)
+
+    # Just a day name (most recent occurrence, including today)
+    if text in day_names:
+        target = day_names[text]
+        days_back = (today.weekday() - target) % 7
+        if days_back == 0:
+            days_back = 0  # today if it matches
+        return today - timedelta(days=days_back)
+
+    # ISO format: YYYY-MM-DD
+    match = re.match(r"^(\d{4})-(\d{1,2})-(\d{1,2})$", text)
+    if match:
+        return date(int(match.group(1)), int(match.group(2)), int(match.group(3)))
+
+    # US format: M/D or M/D/YYYY
+    match = re.match(r"^(\d{1,2})/(\d{1,2})(?:/(\d{4}))?$", text)
+    if match:
+        month = int(match.group(1))
+        day = int(match.group(2))
+        year = int(match.group(3)) if match.group(3) else today.year
+        return date(year, month, day)
+
+    raise ValueError(
+        f"Cannot parse date: '{text}'. Try: today, yesterday, monday, "
+        f"last friday, 2026-03-10, 3/10"
+    )
+
+
+def format_date(d: date | None, fmt: str = "%Y-%m-%d") -> str:
+    """Format a date for display."""
+    if d is None:
+        return ""
+    return d.strftime(fmt)
+
+
+def truncate(text: str, max_length: int = 50) -> str:
+    """Truncate text to a maximum length with ellipsis."""
+    if len(text) <= max_length:
+        return text
+    return text[: max_length - 1] + "\u2026"

crowdtime_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: crowdtime-cli
+Version: 0.1.0
+Summary: AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest
+Project-URL: Homepage, https://crowdtime.lat
+Project-URL: Documentation, https://crowdtime.lat/docs
+Project-URL: Support, https://crowdtime.lat/support
+Author-email: IT Crowd <dev@itcrowdarg.com>
+License: Proprietary
+License-File: LICENSE
+Keywords: ai,cli,harvest-alternative,productivity,time-tracking
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: humanize>=4.0
+Requires-Dist: keyring>=25.0
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dateutil>=2.9
+Requires-Dist: rich>=13.0
+Requires-Dist: tomlkit>=0.12.0
+Requires-Dist: typer[all]>=0.12.0
+Description-Content-Type: text/markdown
+
+# 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
+
+```bash
+pip install crowdtime-cli
+```
+
+Requires Python 3.11+
+
+## Quick Start
+
+```bash
+# 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
+
+```bash
+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:
+
+```bash
+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](https://pypi.org/project/keyring/).
+
+## Requirements
+
+- Python 3.11+
+- A CrowdTime account at [crowdtime.lat](https://crowdtime.lat)
+
+## Support
+
+For issues and feature requests, contact [dev@itcrowdarg.com](mailto:dev@itcrowdarg.com).
+
+## License
+
+Proprietary. See [LICENSE](LICENSE) for details.

crowdtime_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,31 @@
+crowdtime_cli/__init__.py,sha256=bsIAwxE8SXqqdg_pQ3SOaMHa79IGvoS99majAe3_arM,93
+crowdtime_cli/auth.py,sha256=6MEKCbDaS8qjOsFhkHqqpuza3l5hQ7V3BN28vRTmI64,1660
+crowdtime_cli/client.py,sha256=fiBQ9pMSaJjObaM06fL_BhsZ0pH8mUUCoQnKA9DqP8E,5995
+crowdtime_cli/config.py,sha256=nM32YouP7tsNsInqAYWtsNCesbfLfd7ZWmLolUFx_6U,3533
+crowdtime_cli/formatters.py,sha256=RKYfp0fkoQzJWW7vcAo9kM9z3Ku_fOnFkAzQyjrVXvI,13936
+crowdtime_cli/main.py,sha256=zNKjvSBQEsD17sx2pOERjKDAIYj0FfZd1Nt4g76zxAM,11257
+crowdtime_cli/models.py,sha256=x0RQH0BMAa85pB7W1kbFs9BXITjjuCOY0rFuS3MpS3s,3681
+crowdtime_cli/oauth.py,sha256=BQOfa9A9avck_E6lgR0dY9hNab4qDBfgsg2nhOBVnwA,3158
+crowdtime_cli/resolvers.py,sha256=hN1IX6xRQ4Atmupvv95XIXpesOIwcDYPOutPicEouwU,2640
+crowdtime_cli/utils.py,sha256=30q7IW95BcBhK5nNFUSL-xVf6GwU4XyiL4PUmaiuo6U,4904
+crowdtime_cli/commands/__init__.py,sha256=GW6wnw9GOvllMHGJbGUcnYF0N2iRjeCOAibIgp4BZi8,30
+crowdtime_cli/commands/ai_cmd.py,sha256=bM7NTLjJQ76tpjw9x6lfaN0GXGRpYNHo9KKevlISdFo,7306
+crowdtime_cli/commands/auth_cmd.py,sha256=bFcnVpuhaylCOY6E89pRM9yYUAfa5kM7olAeNgCFNMY,5053
+crowdtime_cli/commands/clients_cmd.py,sha256=L9h_yFxXz6jt4g9hPyu4alYiXtY9cIUUUVSIUl4dfTY,5277
+crowdtime_cli/commands/config_cmd.py,sha256=PPuVS-o8zHspL4PtY5rUvf0IQ2TQY7LeL-PFxR6ygqw,2687
+crowdtime_cli/commands/favorites_cmd.py,sha256=kfJJvzQwgqi7ghgrmWdOHRUlzgBhfv8EKjs3SxgIXEY,3968
+crowdtime_cli/commands/log_cmd.py,sha256=k7hL8CWUnleiGRlrCTMJQtjxRMYMu7FRjA1UlHARMJ4,10175
+crowdtime_cli/commands/org_cmd.py,sha256=sguQmhmBjLHGUweFkM-0ucc6yNrNn89zPr6LCGnuXGI,4179
+crowdtime_cli/commands/projects_cmd.py,sha256=D_w65Zh2kxslLCLR9EYakRF_-seo4mDIOTQWaPYFAxU,6352
+crowdtime_cli/commands/report_cmd.py,sha256=qGHE_12ZV8QF8cUfrXIe9ze0yVasxscoiR8REaVDwcs,8515
+crowdtime_cli/commands/skill_cmd.py,sha256=HZwOfwwLK1KPXufaZxxomoly6qHaTCxILxNFXowpwfA,8083
+crowdtime_cli/commands/tasks_cmd.py,sha256=3L2cGLaVCt00trHB-_Ip4nf67gJacl36kmZhBZg0J4w,3288
+crowdtime_cli/commands/timer_cmd.py,sha256=W_5egB5q8C2M0jEGnUqsbvk5GWG4Q1u9A3hOLYws_hg,6852
+crowdtime_cli/skills/crowdtime/SKILL.md,sha256=kE2TLTXNZA7wavong4jSyLsjr-aikbiPyKkndtIL6bI,9859
+crowdtime_cli/skills/crowdtime/references/commands.md,sha256=yLk9tD_4DmixYhTLm9hpF5MFLPLjbfnlqVriavh8bzo,14506
+crowdtime_cli/skills/crowdtime/references/workflows.md,sha256=q5mdeIYW5U0gbm86NgMPfRPFYVO51n8vcElIRly-xmc,5863
+crowdtime_cli-0.1.0.dist-info/METADATA,sha256=hA3P9f2K3KPJUWGo2KiNAaubzwDhzWiYgTBf9xWq44Q,4710
+crowdtime_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+crowdtime_cli-0.1.0.dist-info/entry_points.txt,sha256=YI72qLC6AMNccU8R77JZ7ukAaMDbjlYxH-WrPCtxhms,103
+crowdtime_cli-0.1.0.dist-info/licenses/LICENSE,sha256=_cpsrHD4WgNNB2xi-jjDZ2h6QxnfIdHN7iAE9DNN370,3172
+crowdtime_cli-0.1.0.dist-info/RECORD,,

crowdtime_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

crowdtime_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+crowdtime = crowdtime_cli.main:_original_main
+ct = crowdtime_cli.main:_original_main