crowdtime-cli 0.1.0__tar.gz

crowdtime_cli-0.1.0/.gitignore

@@ -0,0 +1,58 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Environment
+.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Django
+*.log
+db.sqlite3
+staticfiles/
+media/
+logs/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# Coverage
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Docker
+docker-compose.override.yml
+
+# Claude Code
+.claude/
+
+# Frontend
+node_modules/
+.next/
+.env.local
+.env*.local
+RECOVERY.md
+coolify_deployment.md

crowdtime_cli-0.1.0/LICENSE

@@ -0,0 +1,77 @@
+CrowdTime CLI - Proprietary Software License
+
+Copyright (c) 2024-2026 IT Crowd SRL. All rights reserved.
+
+NOTICE: This software and associated documentation files (the "Software") are
+the proprietary property of IT Crowd SRL ("Company"). The Software is protected
+by copyright laws and international treaty provisions.
+
+1. GRANT OF LICENSE
+
+   Subject to the terms of this license, the Company grants you a limited,
+   non-exclusive, non-transferable, revocable license to install and use the
+   Software solely for your internal business purposes in connection with
+   a valid CrowdTime subscription.
+
+2. RESTRICTIONS
+
+   You may NOT:
+   a) Copy, modify, adapt, translate, or create derivative works of the Software;
+   b) Reverse engineer, decompile, disassemble, or otherwise attempt to derive
+      the source code of the Software;
+   c) Redistribute, sublicense, rent, lease, lend, sell, or otherwise transfer
+      the Software or any rights therein to any third party;
+   d) Remove, alter, or obscure any proprietary notices, labels, or marks on
+      the Software;
+   e) Use the Software to build a competing product or service;
+   f) Use the Software in any manner that violates applicable laws or
+      regulations.
+
+3. OWNERSHIP
+
+   The Software is licensed, not sold. The Company retains all right, title,
+   and interest in and to the Software, including all intellectual property
+   rights therein. No rights are granted to you other than those expressly
+   set forth in this license.
+
+4. SUBSCRIPTION REQUIREMENT
+
+   Use of the Software requires an active CrowdTime subscription. The Company
+   reserves the right to verify your subscription status and to disable access
+   to the Software if your subscription lapses or is terminated.
+
+5. DATA COLLECTION
+
+   The Software communicates with CrowdTime servers to provide its
+   functionality. By using the Software, you acknowledge that data will be
+   transmitted to and stored on CrowdTime servers in accordance with the
+   CrowdTime Privacy Policy.
+
+6. NO WARRANTY
+
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. THE COMPANY DOES NOT
+   WARRANT THAT THE SOFTWARE WILL BE ERROR-FREE OR UNINTERRUPTED.
+
+7. LIMITATION OF LIABILITY
+
+   IN NO EVENT SHALL THE COMPANY BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+   SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, OR ANY LOSS OF PROFITS OR
+   REVENUE, WHETHER INCURRED DIRECTLY OR INDIRECTLY, OR ANY LOSS OF DATA, USE,
+   GOODWILL, OR OTHER INTANGIBLE LOSSES, ARISING OUT OF OR IN CONNECTION WITH
+   YOUR USE OF THE SOFTWARE.
+
+8. TERMINATION
+
+   This license is effective until terminated. The Company may terminate this
+   license at any time if you fail to comply with any term herein. Upon
+   termination, you must cease all use of the Software and destroy all copies
+   in your possession.
+
+9. GOVERNING LAW
+
+   This license shall be governed by and construed in accordance with the laws
+   of Argentina, without regard to its conflict of laws principles.
+
+For licensing inquiries: dev@itcrowdarg.com

crowdtime_cli-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,106 @@
+# 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/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "crowdtime-cli"
+version = "0.1.0"
+description = "AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest"
+readme = "README.md"
+license = {text = "Proprietary"}
+authors = [{name = "IT Crowd", email = "dev@itcrowdarg.com"}]
+requires-python = ">=3.11"
+keywords = ["time-tracking", "cli", "productivity", "harvest-alternative", "ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: Other/Proprietary License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business",
+    "Typing :: Typed",
+]
+dependencies = [
+    "typer[all]>=0.12.0",
+    "rich>=13.0",
+    "httpx>=0.27.0",
+    "pydantic>=2.0",
+    "tomlkit>=0.12.0",
+    "keyring>=25.0",
+    "platformdirs>=4.0",
+    "python-dateutil>=2.9",
+    "humanize>=4.0",
+]
+
+[project.urls]
+Homepage = "https://crowdtime.lat"
+Documentation = "https://crowdtime.lat/docs"
+Support = "https://crowdtime.lat/support"
+
+[project.scripts]
+crowdtime = "crowdtime_cli.main:_original_main"
+ct = "crowdtime_cli.main:_original_main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/crowdtime_cli"]

crowdtime_cli-0.1.0/src/crowdtime_cli/__init__.py

@@ -0,0 +1,3 @@
+"""CrowdTime CLI - AI-powered time tracking from the command line."""
+
+__version__ = "0.1.0"

crowdtime_cli-0.1.0/src/crowdtime_cli/auth.py

@@ -0,0 +1,69 @@
+"""Authentication and token management for CrowdTime CLI.
+
+Stores API tokens in the system keyring, with file-based fallback.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from .config import CONFIG_DIR
+
+SERVICE_NAME = "crowdtime"
+USERNAME = "api_token"
+CREDENTIALS_FILE = CONFIG_DIR / "credentials"
+
+
+def save_token(token: str) -> None:
+    """Store the API token, preferring keyring with file fallback."""
+    try:
+        import keyring
+
+        keyring.set_password(SERVICE_NAME, USERNAME, token)
+    except Exception:
+        _save_token_file(token)
+
+
+def get_token() -> str | None:
+    """Retrieve the stored API token."""
+    try:
+        import keyring
+
+        token = keyring.get_password(SERVICE_NAME, USERNAME)
+        if token:
+            return token
+    except Exception:
+        pass
+    return _get_token_file()
+
+
+def clear_token() -> None:
+    """Remove the stored API token."""
+    try:
+        import keyring
+
+        keyring.delete_password(SERVICE_NAME, USERNAME)
+    except Exception:
+        pass
+    _clear_token_file()
+
+
+def _save_token_file(token: str) -> None:
+    """File-based fallback for token storage."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CREDENTIALS_FILE.write_text(token)
+    CREDENTIALS_FILE.chmod(0o600)
+
+
+def _get_token_file() -> str | None:
+    """File-based fallback for token retrieval."""
+    if CREDENTIALS_FILE.exists():
+        content = CREDENTIALS_FILE.read_text().strip()
+        return content if content else None
+    return None
+
+
+def _clear_token_file() -> None:
+    """Remove file-based token."""
+    if CREDENTIALS_FILE.exists():
+        CREDENTIALS_FILE.unlink()

crowdtime_cli-0.1.0/src/crowdtime_cli/client.py

@@ -0,0 +1,177 @@
+"""HTTP client for the CrowdTime API.
+
+Wraps httpx with auth header injection, org-scoped URL prefixing,
+and friendly error handling.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+from rich.console import Console
+
+from .auth import get_token
+from .config import get_config
+
+console = Console(stderr=True)
+
+
+class APIError(Exception):
+    """Raised when an API call fails."""
+
+    def __init__(self, message: str, status_code: int | None = None, detail: Any = None) -> None:
+        self.message = message
+        self.status_code = status_code
+        self.detail = detail
+        super().__init__(message)
+
+
+class CrowdTimeClient:
+    """Synchronous HTTP client for the CrowdTime API."""
+
+    def __init__(self, require_auth: bool = True, require_org: bool = False) -> None:
+        self.config = get_config()
+        self.base_url = self.config.server_url
+        self.token = get_token()
+        self.org_slug = self.config.organization
+
+        if require_auth and not self.token:
+            console.print(
+                "[red]Not authenticated.[/red] Please run [bold]ct login[/bold] first."
+            )
+            raise SystemExit(1)
+
+        if require_org and not self.org_slug:
+            console.print(
+                "[red]No organization set.[/red] Please run [bold]ct org switch <slug>[/bold] first."
+            )
+            raise SystemExit(1)
+
+        headers: dict[str, str] = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+        }
+        if self.token:
+            headers["Authorization"] = f"Bearer {self.token}"
+
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            headers=headers,
+            timeout=30.0,
+        )
+
+    def _org_prefix(self) -> str:
+        """Return the org-scoped URL prefix."""
+        return f"/api/v1/organizations/{self.org_slug}"
+
+    def _url(self, path: str, org_scoped: bool = True) -> str:
+        """Build the full URL path."""
+        if path.startswith("/api/"):
+            return path
+        if org_scoped and self.org_slug:
+            return f"{self._org_prefix()}/{path.lstrip('/')}"
+        return f"/api/v1/{path.lstrip('/')}"
+
+    def get(self, path: str, params: dict[str, Any] | None = None,
+            org_scoped: bool = True) -> Any:
+        """Make a GET request."""
+        url = self._url(path, org_scoped=org_scoped)
+        response = self._request("GET", url, params=params)
+        return response
+
+    def post(self, path: str, data: dict[str, Any] | None = None,
+             org_scoped: bool = True) -> Any:
+        """Make a POST request."""
+        url = self._url(path, org_scoped=org_scoped)
+        response = self._request("POST", url, json=data)
+        return response
+
+    def patch(self, path: str, data: dict[str, Any] | None = None,
+              org_scoped: bool = True) -> Any:
+        """Make a PATCH request."""
+        url = self._url(path, org_scoped=org_scoped)
+        response = self._request("PATCH", url, json=data)
+        return response
+
+    def delete(self, path: str, org_scoped: bool = True) -> Any:
+        """Make a DELETE request."""
+        url = self._url(path, org_scoped=org_scoped)
+        response = self._request("DELETE", url)
+        return response
+
+    def _request(self, method: str, url: str, **kwargs: Any) -> Any:
+        """Execute an HTTP request with error handling."""
+        try:
+            response = self._client.request(method, url, **kwargs)
+            return self._handle_response(response)
+        except httpx.ConnectError:
+            console.print(
+                f"[red]Cannot connect to server at {self.base_url}[/red]\n"
+                "Is the CrowdTime server running?"
+            )
+            raise SystemExit(1)
+        except httpx.TimeoutException:
+            console.print("[red]Request timed out.[/red] Please try again.")
+            raise SystemExit(1)
+        except APIError:
+            raise
+        except httpx.HTTPError as e:
+            console.print(f"[red]HTTP error:[/red] {e}")
+            raise SystemExit(1)
+
+    def _handle_response(self, response: httpx.Response) -> Any:
+        """Check response status and parse JSON."""
+        if response.status_code == 204:
+            return None
+
+        if response.status_code == 401:
+            console.print(
+                "[red]Authentication failed.[/red] Please run [bold]ct login[/bold] to re-authenticate."
+            )
+            raise SystemExit(1)
+
+        if response.status_code == 403:
+            console.print("[red]Permission denied.[/red] You don't have access to this resource.")
+            raise SystemExit(1)
+
+        if response.status_code == 404:
+            raise APIError("Not found", status_code=404)
+
+        if response.status_code >= 500:
+            # Server errors — show a friendly message, not raw HTML
+            try:
+                detail = response.json()
+                msg = detail.get("detail", "Internal server error")
+            except Exception:
+                msg = "Internal server error"
+            raise APIError(
+                f"Server error ({response.status_code}): {msg}",
+                status_code=response.status_code,
+            )
+
+        if response.status_code >= 400:
+            try:
+                detail = response.json()
+            except Exception:
+                detail = response.text
+            msg = detail.get("detail", str(detail)) if isinstance(detail, dict) else str(detail)
+            raise APIError(msg, status_code=response.status_code, detail=detail)
+
+        if not response.content:
+            return None
+
+        try:
+            return response.json()
+        except Exception:
+            return response.text
+
+    def close(self) -> None:
+        """Close the underlying HTTP client."""
+        self._client.close()
+
+    def __enter__(self) -> CrowdTimeClient:
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()

crowdtime_cli-0.1.0/src/crowdtime_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CrowdTime CLI commands."""