crowdtime-cli 0.7.0__tar.gz → 0.8.1__tar.gz

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdtime-cli
-Version: 0.7.0
+Version: 0.8.1
 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

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "crowdtime-cli"
-version = "0.7.0"
+version = "0.8.1"
 description = "AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest"
 readme = "README.md"
 license = {text = "Proprietary"}

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/__init__.py

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

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/client.py

@@ -140,16 +140,18 @@ class CrowdTimeClient:
                 detail = response.json()
             except Exception:
                 detail = {}
-            msg = (
-                detail.get("detail", "")
-                if isinstance(detail, dict)
-                else str(detail)
-            ) or "Your organization's subscription is inactive."
-            console.print(
-                f"[yellow]{msg}[/yellow]\n"
-                "Run [bold]ct billing portal[/bold] to update your billing."
-            )
-            raise APIError(msg, status_code=402, detail=detail)
+            code = detail.get("code", "") if isinstance(detail, dict) else ""
+            if code == "subscription_required":
+                console.print(
+                    "\n[yellow]Your organization does not have an active subscription.[/yellow]\n"
+                    "\n  Start your free trial:  [bold]ct billing checkout[/bold]\n"
+                )
+            else:
+                console.print(
+                    "\n[yellow]Your organization's subscription is inactive.[/yellow]\n"
+                    "\n  Manage your billing:    [bold]ct billing portal[/bold]\n"
+                )
+            raise SystemExit(1)
 
         if response.status_code == 404:
             raise APIError("Not found", status_code=404)

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/commands/billing_cmd.py

@@ -205,9 +205,9 @@ def portal(
             )
             raise typer.Exit(1)
         if e.status_code == 404:
-            format_error(
-                "No subscription found. An organization owner must set up "
-                "billing from the web dashboard first."
+            console.print(
+                "[yellow]No subscription found for this organization.[/yellow]\n"
+                "\n  Start your free trial:  [bold]ct billing checkout[/bold]"
             )
             raise typer.Exit(1)
         format_error(e.message)

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/commands/invoice_cmd.py

@@ -397,9 +397,9 @@ def create_invoice(
     client = CrowdTimeClient(require_auth=True, require_org=True)
 
     payload: dict = {
-        "client": client_id,
-        "from_date": start,
-        "to_date": end,
+        "client_id": client_id,
+        "date_from": start,
+        "date_to": end,
     }
     if group_by:
         payload["group_by"] = group_by
@@ -453,23 +453,44 @@ def create_invoice(
 def create_blank_invoice(
     client_id: str = typer.Option(..., "--client", "-c", help="Client ID."),
     issue_date: str = typer.Option(..., "--issue-date", help="Issue date."),
-    due_date: Optional[str] = typer.Option(None, "--due-date", help="Due date."),
+    due_date: Optional[str] = typer.Option(None, "--due-date", help="Due date (auto-calculated from --payment-terms if omitted)."),
+    subject: Optional[str] = typer.Option(None, "--subject", "-s", help="Invoice subject line."),
+    payment_terms: Optional[str] = typer.Option(
+        None, "--payment-terms",
+        help="Payment terms: receipt, net15, net30, or number of days. Auto-calculates due date.",
+    ),
     currency: Optional[str] = typer.Option(None, "--currency", help="Currency code (e.g. USD, EUR)."),
     notes: Optional[str] = typer.Option(None, "--notes", "-n", help="Invoice notes."),
+    terms: Optional[str] = typer.Option(None, "--terms", help="Payment terms text (e.g. bank account details)."),
     output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
 ) -> None:
     """Create an empty draft invoice for manual line item addition.
 
     Examples:
-        ct invoice create-blank --client <id> --issue-date 2026-03-15
+        ct invoice create-blank --client <id> --issue-date today
+        ct invoice create-blank --client <id> --issue-date 2026-03-15 --payment-terms net30
         ct invoice create-blank --client <id> --issue-date today --due-date 2026-04-15 --currency EUR
+        ct invoice create-blank --client <id> --issue-date today --terms "Wire to IBAN XX" --notes "March work"
     """
     try:
-        parsed_issue = format_date(parse_date(issue_date))
+        parsed_issue_date = parse_date(issue_date)
+        parsed_issue = format_date(parsed_issue_date)
     except ValueError as e:
         format_error(str(e))
         raise typer.Exit(1)
 
+    # Resolve payment terms days
+    payment_terms_days: int | None = None
+    if payment_terms is not None:
+        payment_terms_days = _resolve_payment_terms(payment_terms)
+        if payment_terms_days is None:
+            format_error(
+                f"Invalid --payment-terms: '{payment_terms}'. "
+                "Use: receipt, net15, net30, or a number of days."
+            )
+            raise typer.Exit(1)
+
+    # Resolve due date: explicit --due-date > calculated from --payment-terms > default net30
     parsed_due = None
     if due_date:
         try:
@@ -477,19 +498,30 @@ def create_blank_invoice(
         except ValueError as e:
             format_error(str(e))
             raise typer.Exit(1)
+    elif payment_terms_days is not None:
+        parsed_due = format_date(parsed_issue_date + timedelta(days=payment_terms_days))
+    else:
+        # Default to net30
+        payment_terms_days = 30
+        parsed_due = format_date(parsed_issue_date + timedelta(days=30))
 
     api_client = CrowdTimeClient(require_auth=True, require_org=True)
 
     payload: dict = {
         "client": client_id,
         "issue_date": parsed_issue,
+        "due_date": parsed_due,
     }
-    if parsed_due:
-        payload["due_date"] = parsed_due
+    if subject:
+        payload["subject"] = subject
     if currency:
         payload["currency"] = currency
     if notes:
         payload["notes"] = notes
+    if terms:
+        payload["terms"] = terms
+    if payment_terms_days is not None:
+        payload["payment_terms_days"] = payment_terms_days
 
     try:
         data = api_client.post("/invoices/", data=payload)
@@ -506,6 +538,119 @@ def create_blank_invoice(
         raise typer.Exit(1)
 
 
+@app.command("update")
+def update_invoice(
+    invoice_id: str = typer.Argument(..., help="Invoice ID to update (must be draft)."),
+    invoice_number: Optional[str] = typer.Option(None, "--number", help="Invoice number (e.g. INV-0078)."),
+    subject: Optional[str] = typer.Option(None, "--subject", "-s", help="Invoice subject line."),
+    issue_date: Optional[str] = typer.Option(None, "--issue-date", help="Issue date."),
+    due_date: Optional[str] = typer.Option(None, "--due-date", help="Due date."),
+    notes: Optional[str] = typer.Option(None, "--notes", "-n", help="Invoice notes."),
+    terms: Optional[str] = typer.Option(None, "--terms", help="Payment terms text (e.g. bank account details)."),
+    footer: Optional[str] = typer.Option(None, "--footer", help="Invoice footer text."),
+    currency: Optional[str] = typer.Option(None, "--currency", help="Currency code (e.g. USD, EUR)."),
+    tax_rate: Optional[float] = typer.Option(None, "--tax-rate", help="Tax rate percentage (e.g. 21 for 21%%)."),
+    payment_terms: Optional[str] = typer.Option(
+        None, "--payment-terms",
+        help="Payment terms: receipt, net15, net30, or number of days.",
+    ),
+    from_name: Optional[str] = typer.Option(None, "--from-name", help="Issuer/sender name."),
+    from_email: Optional[str] = typer.Option(None, "--from-email", help="Issuer/sender email."),
+    from_address: Optional[str] = typer.Option(None, "--from-address", help="Issuer/sender address."),
+    client_name: Optional[str] = typer.Option(None, "--client-name", help="Bill-to client name."),
+    client_email: Optional[str] = typer.Option(None, "--client-email", help="Bill-to client email."),
+    client_address: Optional[str] = typer.Option(None, "--client-address", help="Bill-to client address."),
+    output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """Update a draft invoice's fields.
+
+    Only draft invoices can be edited. Once sent, use void + recreate.
+
+    Examples:
+        ct invoice update <id> --subject "March 2026 Development"
+        ct invoice update <id> --terms "Wire to IBAN XX" --notes "Net 30"
+        ct invoice update <id> --tax-rate 21 --due-date 2026-04-15
+        ct invoice update <id> --number "INV-0078"
+        ct invoice update <id> --from-name "Acme Inc" --from-email "billing@acme.com"
+        ct invoice update <id> --client-name "Beta Corp" --client-email "ap@beta.com"
+    """
+    # Build payload from provided options
+    payload: dict = {}
+
+    if invoice_number is not None:
+        payload["invoice_number"] = invoice_number
+    if subject is not None:
+        payload["subject"] = subject
+    if notes is not None:
+        payload["notes"] = notes
+    if terms is not None:
+        payload["terms"] = terms
+    if footer is not None:
+        payload["footer"] = footer
+    if currency is not None:
+        payload["currency"] = currency
+    if tax_rate is not None:
+        payload["tax_rate"] = str(tax_rate)
+    if from_name is not None:
+        payload["from_name"] = from_name
+    if from_email is not None:
+        payload["from_email"] = from_email
+    if from_address is not None:
+        payload["from_address"] = from_address
+    if client_name is not None:
+        payload["client_name"] = client_name
+    if client_email is not None:
+        payload["client_email"] = client_email
+    if client_address is not None:
+        payload["client_address"] = client_address
+
+    if issue_date is not None:
+        try:
+            payload["issue_date"] = format_date(parse_date(issue_date))
+        except ValueError as e:
+            format_error(str(e))
+            raise typer.Exit(1)
+
+    if due_date is not None:
+        try:
+            payload["due_date"] = format_date(parse_date(due_date))
+        except ValueError as e:
+            format_error(str(e))
+            raise typer.Exit(1)
+
+    if payment_terms is not None:
+        days = _resolve_payment_terms(payment_terms)
+        if days is None:
+            format_error(
+                f"Invalid --payment-terms: '{payment_terms}'. "
+                "Use: receipt, net15, net30, or a number of days."
+            )
+            raise typer.Exit(1)
+        payload["payment_terms_days"] = days
+
+    if not payload:
+        format_error("No fields to update. Provide at least one option.")
+        raise typer.Exit(1)
+
+    client = CrowdTimeClient(require_auth=True, require_org=True)
+
+    try:
+        data = client.patch(f"/invoices/{invoice_id}/", data=payload)
+
+        if output_json:
+            print_json(data)
+        else:
+            inv_number = data.get("invoice_number", data.get("number", invoice_id))
+            fields = ", ".join(payload.keys())
+            format_success(f"Invoice {inv_number} updated ({fields}).")
+    except APIError as e:
+        if e.status_code == 404:
+            format_error(f"Invoice '{invoice_id}' not found.")
+        else:
+            format_error(e.message)
+        raise typer.Exit(1)
+
+
 @app.command("send")
 def send_invoice(
     invoice_id: str = typer.Argument(..., help="Invoice ID to send."),
@@ -562,7 +707,7 @@ def void_invoice(
     client = CrowdTimeClient(require_auth=True, require_org=True)
 
     try:
-        data = client.post(f"/invoices/{invoice_id}/void/", data={"reason": reason})
+        data = client.post(f"/invoices/{invoice_id}/void/", data={"void_reason": reason})
 
         if output_json:
             print_json(data)
@@ -754,7 +899,7 @@ def add_line_item(
         "unit_price": str(parsed_rate),
     }
     if taxable is not None:
-        payload["taxable"] = taxable
+        payload["is_taxable"] = taxable
 
     try:
         data = client.post(f"/invoices/{invoice_id}/line-items/", data=payload)

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/commands/timesheet_cmd.py

@@ -260,6 +260,30 @@ def reject_timesheet(
         raise typer.Exit(1)
 
 
+@app.command("recall")
+def recall_timesheet(
+    timesheet_id: str = typer.Argument(..., help="Timesheet ID to recall."),
+    output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """Recall a submitted timesheet back to draft (owner only, before approval).
+
+    Examples:
+        ct timesheet recall <timesheet-id>
+    """
+    client = CrowdTimeClient(require_auth=True, require_org=True)
+
+    try:
+        result = client.post(f"/timesheets/{timesheet_id}/recall/")
+
+        if output_json:
+            print_json(result)
+        else:
+            format_success("Timesheet recalled to draft. You can now edit and resubmit.")
+    except APIError as e:
+        format_error(e.message)
+        raise typer.Exit(1)
+
+
 @app.command("team")
 def team_overview(
     period_start: Optional[str] = typer.Option(

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/skills/crowdtime/SKILL.md

@@ -177,6 +177,7 @@ ct favorites delete <id>
 ct timesheet list                       # List your timesheets
 ct timesheet list --status submitted    # Filter by status
 ct timesheet submit --from 2026-03-10 --to 2026-03-16  # Submit for a period
+ct timesheet recall <id>                # Recall submitted timesheet back to draft
 ct timesheet approve <id>               # Approve a submitted timesheet (manager+)
 ct timesheet reject <id> --notes "Missing entries for Wednesday"  # Reject with notes
 ct timesheet team                       # Team overview for this week (manager+)
@@ -189,13 +190,13 @@ ct timesheet team --last-week           # Last week's overview
 ct invoice list                         # List all invoices
 ct invoice list --status draft          # Filter by status
 ct invoice show <id>                    # Invoice details with line items
-ct invoice create --client "Acme" --due 2026-04-15  # Create a draft invoice
-ct invoice create --client "Acme" --period last-month --payment-terms net30  # Period preset + payment terms
-ct invoice add-line <id> --description "Development" --hours 40 --rate 150
-ct invoice import-time <id> --from 2026-03-01 --to 2026-03-31 -p project-slug
+ct invoice create --client <id> --period last-month --payment-terms net30  # From time entries
+ct invoice create-blank --client <id> --issue-date today --payment-terms net30  # Empty draft
+ct invoice update <id> --terms "Wire to IBAN XX" --notes "March"  # Edit draft fields
+ct invoice add-item <id> --desc "Development" --qty 40 --rate 150  # Add line item
 ct invoice send <id>                    # Mark as sent
-ct invoice mark-paid <id>              # Record payment
-ct invoice void <id>                    # Void an invoice
+ct invoice pay <id> --amount 1500      # Record payment
+ct invoice void <id> -r "Duplicate"    # Void an invoice
 ct invoice duplicate <id>              # Duplicate an existing invoice
 ```
 
@@ -319,6 +320,6 @@ Read `references/commands.md` for the full reference of every command, subcomman
 12. **Output formats** — `ct report` supports `table`, `json`, `csv`, and `markdown` via `--format`; suggest `csv` for spreadsheet export, `markdown` for docs
 13. **Ask for details when vague** — if the user's request is ambiguous (e.g. "log 2 hours" with no description or project), ask them for the missing context rather than guessing. It's better to ask one clarifying question than to log something wrong that needs to be edited or deleted
 14. **Expenses** — when the user mentions expenses, receipts, or purchases, use the `ct expense` commands. Always suggest a category and ask if the expense is billable. If recording a billable expense for a client project, always set `--project` and `--billable` so it gets included automatically when the client is invoiced
-15. **Invoices include expenses** — when creating invoices with `ct invoice import-time`, billable expenses from the same period are automatically included as line items. Mention this to users so they know their expenses will appear on the invoice
+15. **Invoices include expenses** — when creating invoices with `ct invoice create --period`, billable expenses from the same period are automatically included as line items. Mention this to users so they know their expenses will appear on the invoice
 16. **Client contacts** — use `ct clients contacts` and `ct clients add-contact` to manage multiple contacts per client. Set `--primary` for the main point of contact
 17. **Payroll** — payroll data is strictly confidential. Only HR managers, admins, and owners can access it. When the user asks about payroll, always use the `ct payroll` commands. Compensation types are `hourly` (rate × hours) or `salary` (fixed monthly). Rate changes are always effective from the 1st of a month. The payroll workflow is: configure compensation → run liquidation → approve → mark paid

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/skills/crowdtime/references/commands.md

@@ -1151,6 +1151,14 @@ ct timesheet reject TIMESHEET_ID --notes NOTES [--json]
 
 Rejects a submitted timesheet with notes (requires manager+ role). Endpoint: `POST /timesheets/{id}/reject/`
 
+### ct timesheet recall
+
+```
+ct timesheet recall TIMESHEET_ID [--json]
+```
+
+Recalls a submitted timesheet back to draft so you can edit and resubmit. Only the timesheet owner can recall, and only before it's been approved or rejected. Endpoint: `POST /timesheets/{id}/recall/`
+
 ### ct timesheet team
 
 ```
@@ -1197,49 +1205,62 @@ Shows invoice details including line items, payments, and totals. Endpoint: `GET
 ### ct invoice create
 
 ```
-ct invoice create --client CLIENT [--due DATE] [--period PERIOD] [--payment-terms TERMS] [--type TYPE] [--currency CUR] [--notes NOTES] [--json]
+ct invoice create --client CLIENT --from DATE --to DATE [--period PERIOD] [--group-by GROUP] [--tax-rate RATE] [--payment-terms TERMS] [--notes NOTES] [--terms TEXT] [--json]
 ```
 
+Creates an invoice from tracked time entries. Requires either `--from`/`--to` or `--period`.
+
 | Option | Type | Description |
 |--------|------|-------------|
-| `--client` | string (required) | Client name or ID |
-| `--due` | string | Due date (default: 30 days from now) |
-| `--period` | string | Period preset: `last-week`, `last-2-weeks`, `last-month`, `this-month` |
-| `--payment-terms` | string | Payment terms: `receipt`, `net15`, `net30`, or a number of days |
-| `--type` | string | `standard` (default), `retainer`, `credit_note` |
-| `--currency` | string | Currency code |
+| `--client` | string (required) | Client ID |
+| `--from` | string | Period start date |
+| `--to` | string | Period end date |
+| `--period` | string | Preset: `last-week`, `last-2-weeks`, `last-month`, `this-month` |
+| `--group-by` | string | Group line items by: `project`, `task`, `date`, `entry` |
+| `--tax-rate` | float | Tax rate percentage (e.g. 21 for 21%) |
+| `--payment-terms` | string | Payment terms: `receipt`, `net15`, `net30`, or number of days |
 | `--notes` | string | Invoice notes |
+| `--terms` | string | Payment terms text |
 | `--json` | flag | JSON output |
 
-Creates a draft invoice. When `--period` is specified, billable time entries and billable expenses from that period are automatically imported as line items. The output shows how many time entries and expenses were included.
-
-When `--payment-terms` is specified, the due date is calculated automatically from the issue date (e.g. `net30` sets the due date to 30 days from now). This overrides `--due` if both are provided.
+Billable time entries and expenses from the period are automatically imported as line items.
 
 **Usage examples:**
 ```bash
-ct invoice create --client "Acme Corp" --due 2026-04-15
-ct invoice create --client "Acme Corp" --period last-month --payment-terms net30
-ct invoice create --client "Beta Inc" --period this-month --payment-terms net15
-ct invoice create --client "Gamma LLC" --period last-2-weeks --payment-terms receipt
+ct invoice create --client <id> --period last-month --payment-terms net30
+ct invoice create --client <id> --from 2026-03-01 --to 2026-03-31
+ct invoice create --client <id> --period last-2-weeks --group-by project
 ```
 
+Endpoint: `POST /invoices/from-time-entries/`
+
+### ct invoice create-blank
+
+```
+ct invoice create-blank --client CLIENT --issue-date DATE [--due-date DATE] [--payment-terms TERMS] [--subject SUBJECT] [--terms TEXT] [--notes NOTES] [--currency CUR] [--json]
+```
+
+Creates an empty draft invoice for manual line item addition. If `--due-date` is omitted, it's auto-calculated from `--payment-terms` (default: net30). `--terms` sets the payment terms text (e.g. bank account details).
+
 Endpoint: `POST /invoices/`
 
-### ct invoice add-line
+### ct invoice update
 
 ```
-ct invoice add-line INVOICE_ID --description DESC [--quantity QTY] [--rate RATE] [--hours HOURS] [--tax TAX_RATE_NAME] [--json]
+ct invoice update INVOICE_ID [--number NUM] [--subject SUBJECT] [--issue-date DATE] [--due-date DATE] [--notes NOTES] [--terms TEXT] [--footer TEXT] [--currency CUR] [--tax-rate RATE] [--payment-terms TERMS] [--from-name NAME] [--from-email EMAIL] [--from-address ADDR] [--client-name NAME] [--client-email EMAIL] [--client-address ADDR] [--json]
 ```
 
-Adds a line item. `--hours` is shorthand for `--quantity` in hours context. Endpoint: `POST /invoices/{id}/line-items/`
+Updates fields on a draft invoice. All fields are editable: invoice number, from/bill-to details, dates, currency, payment terms, notes, terms, footer. Only draft invoices can be edited — once sent, use void + recreate.
+
+Endpoint: `PATCH /invoices/{id}/`
 
-### ct invoice import-time
+### ct invoice add-item
 
 ```
-ct invoice import-time INVOICE_ID --from DATE --to DATE [--project/-p PROJECT] [--json]
+ct invoice add-item INVOICE_ID --description DESC --qty QTY --rate RATE [--taxable/--no-taxable] [--json]
 ```
 
-Imports billable time entries as line items. Endpoint: `POST /invoices/{id}/import-time/`
+Adds a line item to a draft invoice. Endpoint: `POST /invoices/{id}/line-items/`
 
 ### ct invoice send
 
@@ -1249,21 +1270,21 @@ ct invoice send INVOICE_ID [--json]
 
 Marks invoice as sent. Endpoint: `POST /invoices/{id}/send/`
 
-### ct invoice mark-paid
+### ct invoice pay
 
 ```
-ct invoice mark-paid INVOICE_ID [--date DATE] [--method METHOD] [--reference REF] [--json]
+ct invoice pay INVOICE_ID --amount AMOUNT [--date DATE] [--method METHOD] [--reference REF] [--notes NOTES] [--json]
 ```
 
-Records full payment. Endpoint: `POST /invoices/{id}/mark-paid/`
+Records a payment against an invoice. Method choices: `bank_transfer`, `credit_card`, `check`, `cash`, `paypal`, `other`. Endpoint: `POST /invoices/{id}/payments/`
 
 ### ct invoice void
 
 ```
-ct invoice void INVOICE_ID [--force/-f] [--json]
+ct invoice void INVOICE_ID --reason/-r REASON [--json]
 ```
 
-Voids an invoice. Requires confirmation unless `--force`. Endpoint: `POST /invoices/{id}/void/`
+Voids an invoice with a required reason. Endpoint: `POST /invoices/{id}/void/`
 
 ### ct invoice duplicate
 

{crowdtime_cli-0.7.0 → crowdtime_cli-0.8.1}/src/crowdtime_cli/skills/crowdtime/references/workflows.md

@@ -286,6 +286,13 @@ ct timesheet submit --from 2026-03-09 --to 2026-03-15
 
 # Check submission status
 ct timesheet list
+
+# Made a mistake? Recall it back to draft (before approval)
+ct timesheet recall <timesheet-id>
+
+# Fix and resubmit
+ct l -p project-alpha -d friday 2h "missed entry"
+ct timesheet submit --from 2026-03-09 --to 2026-03-15
 ```
 
 ### Manager: Review Team Timesheets
@@ -455,12 +462,13 @@ ct invoice create --client "Acme Corp" --period last-month --payment-terms net30
 # The output shows how many time entries and expenses were included.
 # Billable expenses from the period are automatically added as line items.
 
-# 2. Or create manually and import separately
-ct invoice create --client "Acme Corp" --due 2026-04-15
-ct invoice import-time <invoice-id> --from 2026-03-01 --to 2026-03-31
+# 2. Or create a blank draft and add items manually
+ct invoice create-blank --client <client-id> --issue-date today --payment-terms net30
+ct invoice add-item <invoice-id> --desc "Development" --qty 40 --rate 150
+ct invoice add-item <invoice-id> --desc "Setup fee" --qty 1 --rate 500
 
-# 3. Add manual line items if needed
-ct invoice add-line <invoice-id> --description "Setup fee" --quantity 1 --rate 500
+# 3. Update draft fields (terms, notes, etc.)
+ct invoice update <invoice-id> --terms "Wire to IBAN XX" --notes "March 2026"
 
 # 4. Review the invoice (includes time entries + expenses as line items)
 ct invoice show <invoice-id>
@@ -488,11 +496,10 @@ ct invoice create --client "Acme Corp" --period this-month --payment-terms 45
 ### Invoice for a Specific Project
 
 ```bash
-# Import time for just one project
-ct invoice create --client "Acme Corp" --due 2026-04-15
-ct invoice import-time <invoice-id> --from 2026-03-01 --to 2026-03-31 -p acme-website
+# Create invoice from time entries for a specific date range
+ct invoice create --client <client-id> --from 2026-03-01 --to 2026-03-31
 
-# Review and send — note: billable expenses for the project are included
+# Review and send — note: billable expenses from the period are included
 ct invoice show <invoice-id>
 ct invoice send <invoice-id>
 ```
@@ -517,7 +524,7 @@ ct invoice send <invoice-id>
 
 ```bash
 # Full payment
-ct invoice mark-paid <invoice-id> --method "bank_transfer" --reference "TXN-12345"
+ct invoice pay <invoice-id> --amount 1500 --method bank_transfer --reference "TXN-12345"
 
 # Check invoice status
 ct invoice show <invoice-id>