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.
