@liebig-technology/clockodo-cli 0.1.0 → 0.3.0

package/README.md

@@ -6,28 +6,31 @@ CLI for the [Clockodo](https://www.clockodo.com) time tracking API. Human-friend
 Usage: clockodo [options] [command]
 
 Options:
-  -j, --json     Output as JSON
-  -p, --plain    Output as plain text (no colors)
-  --no-color     Disable colors
-  --no-input     Disable interactive prompts
-  -v, --verbose  Verbose output
+  -V, --version          output the version number
+  -j, --json             Output as JSON
+  -p, --plain            Output as plain text (no colors)
+  --no-color             Disable colors
+  --no-input             Disable interactive prompts
+  -v, --verbose          Verbose output
 
 Commands:
-  config         Manage CLI configuration
-  status         Show running clock and today's summary
-  start          Start time tracking
-  stop           Stop time tracking
-  entries        Manage time entries
-  customers      Manage customers
-  projects       Manage projects
-  services       Manage services
-  users          User management
-  report         Aggregated time reports
-  absences       Manage absences
-  worktimes      Show work time intervals
-  userreport     Show user report (overtime, holidays, absences)
-  userreports    Show user reports for all users
-  schema         Output machine-readable CLI structure (for AI agents)
+  config                 Manage CLI configuration
+  status [options]       Show running clock and today's summary
+  start [options]        Start time tracking
+  stop                   Stop time tracking
+  edit [options]         Edit the running clock entry
+  extend <minutes>       Extend the running clock by N minutes
+  entries                Manage time entries
+  customers              Manage customers
+  projects               Manage projects
+  services               Manage services
+  users                  User management
+  report                 Aggregated time reports
+  absences               Manage absences
+  worktimes [options]    Show work time intervals
+  userreport [options]   Show user report (overtime, holidays, absences)
+  userreports [options]  Show user reports for all users
+  schema                 Output machine-readable CLI structure (for AI agents)
 ```
 
 Every command supports `--help` for full usage details.
@@ -54,18 +57,31 @@ Credentials are stored in `~/.config/clockodo-cli/config.json`. Environment vari
 ```bash
 # Time tracking
 clockodo start --customer 123 --service 456 --text "Working on feature"
+clockodo start --customer 123 --service 456 --billable   # explicit billability
 clockodo stop
 clockodo status
+clockodo edit --text "New description" --billable         # edit running entry
+clockodo extend 30                                        # extend running clock by 30 minutes
 
 # Entries
 clockodo entries                                         # list today's entries
 clockodo entries --since 2026-01-01 --until 2026-01-31   # date range
+clockodo entries --billable                              # only billable entries
 clockodo entries create --from "09:00" --to "12:30" --customer 123 --service 456
+clockodo entries update 42 --text "New description" --customer 789 --service 456
+
+# Customers, projects, services
+clockodo customers                                   # list all customers
+clockodo customers create --name "Acme Corp"         # create a customer
+clockodo customers update 42 --name "Acme Inc"       # rename customer 42
+clockodo customers delete 42 --force                 # delete without confirmation
+clockodo projects create --name "Website" --customer 42
+clockodo services create --name "Development"
 
 # Reports
-clockodo report              # today
-clockodo report week         # this week
-clockodo report month        # this month
+clockodo report                          # today, grouped by project
+clockodo report week --group customer    # this week by customer
+clockodo report month --group text       # this month by description
 
 # Absences, work times, user reports
 clockodo absences list --year 2026
@@ -75,6 +91,25 @@ clockodo userreport --year 2026
 
 When `--customer` or `--service` is not provided, `start` and `entries create` launch an interactive picker (disable with `--no-input`). You can also set defaults via `clockodo config set`.
 
+## Shell Prompt Integration
+
+`clockodo status --prompt` outputs a single plain-text line for embedding in your terminal prompt:
+
+```bash
+clockodo status --prompt              # "Working on feature 1h 23m" or empty if idle
+clockodo status --prompt --json       # {"data":{"running":true,"text":"...","elapsed":4980,"formatted":"1h 23m"}}
+```
+
+Example for [Starship](https://starship.rs/):
+
+```toml
+# ~/.config/starship.toml
+[custom.clockodo]
+command = "clockodo status --prompt"
+when = true
+symbol = "⏱ "
+```
+
 ## AI Agent Integration
 
 ```bash

package/dist/index.js

@@ -290,6 +290,9 @@ function printDetail(entries, options) {
 function printSuccess(message) {
   console.error(styleText2("green", `\u2713 ${message}`));
 }
+function printInfo(message) {
+  console.error(styleText2("cyan", `\u2139 ${message}`));
+}
 
 // src/lib/validate.ts
 function parseId(input, label = "ID") {
@@ -441,10 +444,10 @@ function registerAbsencesCommands(program2) {
     const opts = program2.opts();
     const client = getClient();
     if (!cmdOpts.force && process.stdout.isTTY) {
-      const confirm3 = await p.confirm({
+      const confirm6 = await p.confirm({
         message: `Delete absence ${id}?`
       });
-      if (!confirm3 || p.isCancel(confirm3)) return;
+      if (!confirm6 || p.isCancel(confirm6)) return;
     }
     const absenceId = parseId(id);
     await client.deleteAbsence({ id: absenceId });
@@ -458,7 +461,7 @@ function registerAbsencesCommands(program2) {
 }
 
 // src/commands/clock.ts
-import { Billability } from "clockodo";
+import { Billability, getEntryDurationUntilNow } from "clockodo";
 
 // src/lib/prompts.ts
 import * as p2 from "@clack/prompts";
@@ -562,6 +565,18 @@ function formatDecimalHours(seconds) {
 function toClockodoDateTime(date) {
   return date.toISOString().replace(/\.\d{3}Z$/, "Z");
 }
+function parseDateTimeUntil(input) {
+  const lower = input.toLowerCase();
+  if (lower === "today" || lower === "yesterday" || lower === "tomorrow") {
+    const now = /* @__PURE__ */ new Date();
+    const offset = lower === "yesterday" ? -1 : lower === "tomorrow" ? 1 : 0;
+    return toClockodoDateTime(_endOfDay(addDays(now, offset)));
+  }
+  if (/^\d{4}-\d{2}-\d{2}$/.test(input)) {
+    return toClockodoDateTime(_endOfDay(/* @__PURE__ */ new Date(`${input}T00:00:00`)));
+  }
+  return parseDateTime(input);
+}
 function parseDateTime(input) {
   const now = /* @__PURE__ */ new Date();
   switch (input.toLowerCase()) {
@@ -595,7 +610,7 @@ function parseDateTime(input) {
 
 // src/commands/clock.ts
 function registerClockCommands(program2) {
-  program2.command("start").description("Start time tracking").option("-c, --customer <id>", "Customer ID", parseIntStrict).option("-p, --project <id>", "Project ID", parseIntStrict).option("-s, --service <id>", "Service ID", parseIntStrict).option("-t, --text <description>", "Entry description").option("-b, --billable", "Mark as billable").action(async (cmdOpts) => {
+  program2.command("start").description("Start time tracking").option("-c, --customer <id>", "Customer ID", parseIntStrict).option("-p, --project <id>", "Project ID", parseIntStrict).option("-s, --service <id>", "Service ID", parseIntStrict).option("-t, --text <description>", "Entry description").option("-b, --billable", "Mark as billable").option("--no-billable", "Mark as not billable").action(async (cmdOpts) => {
     const opts = program2.opts();
     const mode = resolveOutputMode(opts);
     const client = getClient();
@@ -619,9 +634,11 @@ function registerClockCommands(program2) {
     const result = await client.startClock({
       customersId,
       servicesId,
+      ...cmdOpts.billable !== void 0 && {
+        billable: cmdOpts.billable ? Billability.Billable : Billability.NotBillable
+      },
       ...projectsId && { projectsId },
-      ...cmdOpts.text && { text: cmdOpts.text },
-      ...cmdOpts.billable && { billable: Billability.Billable }
+      ...cmdOpts.text && { text: cmdOpts.text }
     });
     if (mode !== "human") {
       printResult({ data: result.running }, opts);
@@ -652,6 +669,57 @@ function registerClockCommands(program2) {
       console.log(`  Description: ${result.stopped.text}`);
     }
   });
+  program2.command("edit").description("Edit the running clock entry").option("-c, --customer <id>", "Customer ID", parseIntStrict).option("-p, --project <id>", "Project ID", parseIntStrict).option("-s, --service <id>", "Service ID", parseIntStrict).option("-t, --text <description>", "Entry description").option("-b, --billable", "Mark as billable").option("--no-billable", "Mark as not billable").action(async (cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const clock = await client.getClock();
+    if (!clock.running) {
+      throw new CliError("No clock is currently running.", ExitCode.EMPTY_RESULTS);
+    }
+    const updates = { id: clock.running.id };
+    if (cmdOpts.customer !== void 0) updates.customersId = cmdOpts.customer;
+    if (cmdOpts.project !== void 0) updates.projectsId = cmdOpts.project;
+    if (cmdOpts.service !== void 0) updates.servicesId = cmdOpts.service;
+    if (cmdOpts.text !== void 0) updates.text = cmdOpts.text;
+    if (cmdOpts.billable !== void 0)
+      updates.billable = cmdOpts.billable ? Billability.Billable : Billability.NotBillable;
+    if (Object.keys(updates).length === 1) {
+      throw new CliError(
+        "No update flags provided.",
+        ExitCode.INVALID_ARGS,
+        "Use --text, --customer, --project, --service, --billable, or --no-billable"
+      );
+    }
+    const result = await client.editEntry(updates);
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.entry }, opts);
+      return;
+    }
+    printSuccess("Running entry updated");
+  });
+  program2.command("extend").description("Extend the running clock by N minutes").argument("<minutes>", "Minutes to extend by", parseIntStrict).action(async (minutes) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const clock = await client.getClock();
+    if (!clock.running) {
+      throw new CliError("No clock is currently running.", ExitCode.EMPTY_RESULTS);
+    }
+    const durationBefore = getEntryDurationUntilNow(clock.running);
+    const duration = durationBefore + minutes * 60;
+    const result = await client.changeClockDuration({
+      entriesId: clock.running.id,
+      durationBefore,
+      duration
+    });
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.updated }, opts);
+      return;
+    }
+    printSuccess(`Clock extended by ${minutes} minutes`);
+    console.log(`  New duration: ${formatDuration(duration)}`);
+  });
 }
 
 // src/commands/config.ts
@@ -712,6 +780,8 @@ function registerConfigCommands(program2) {
 }
 
 // src/commands/customers.ts
+import * as p4 from "@clack/prompts";
+import { Billability as Billability2 } from "clockodo";
 function registerCustomersCommands(program2) {
   const customers = program2.command("customers").description("Manage customers");
   customers.command("list", { isDefault: true }).description("List customers").option("--active", "Show only active customers").option("--search <text>", "Search by name").action(async (cmdOpts) => {
@@ -725,6 +795,14 @@ function registerCustomersCommands(program2) {
     );
     const items = result.data ?? [];
     const mode = resolveOutputMode(opts);
+    if (items.length === 0) {
+      if (mode !== "human") {
+        printResult({ data: [], meta: { count: 0 } }, opts);
+      } else {
+        printInfo("No customers found.");
+      }
+      return;
+    }
     if (mode !== "human") {
       printResult({ data: items, meta: { count: items.length } }, opts);
       return;
@@ -759,27 +837,89 @@ function registerCustomersCommands(program2) {
       opts
     );
   });
+  customers.command("create").description("Create a customer").requiredOption("--name <name>", "Customer name").option("--number <text>", "Customer number").option("--note <text>", "Note").option("--active", "Set as active (default)").option("--no-active", "Set as inactive").option("--billable", "Set as billable by default").option("--no-billable", "Set as not billable by default").action(async (cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const params = {
+      name: cmdOpts.name,
+      ...cmdOpts.number != null && { number: cmdOpts.number },
+      ...cmdOpts.note != null && { note: cmdOpts.note },
+      ...cmdOpts.active !== void 0 && { active: cmdOpts.active },
+      ...cmdOpts.billable !== void 0 && {
+        billableDefault: cmdOpts.billable ? Billability2.Billable : Billability2.NotBillable
+      }
+    };
+    const result = await client.addCustomer(params);
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.data }, opts);
+      return;
+    }
+    printSuccess(`Customer created (ID: ${result.data.id})`);
+    console.log(`  ${result.data.name}`);
+  });
+  customers.command("update <id>").description("Update a customer").option("--name <name>", "New name").option("--number <text>", "New number").option("--note <text>", "New note").option("--active", "Set as active").option("--no-active", "Set as inactive").option("--billable", "Set as billable by default").option("--no-billable", "Set as not billable by default").action(async (id, cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const params = {
+      id: parseId(id),
+      ...cmdOpts.name != null && { name: cmdOpts.name },
+      ...cmdOpts.number != null && { number: cmdOpts.number },
+      ...cmdOpts.note != null && { note: cmdOpts.note },
+      ...cmdOpts.active !== void 0 && { active: cmdOpts.active },
+      ...cmdOpts.billable !== void 0 && {
+        billableDefault: cmdOpts.billable ? Billability2.Billable : Billability2.NotBillable
+      }
+    };
+    const result = await client.editCustomer(params);
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.data }, opts);
+      return;
+    }
+    printSuccess(`Customer ${id} updated`);
+  });
+  customers.command("delete <id>").description("Delete a customer").option("-f, --force", "Skip confirmation").action(async (id, cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    if (!cmdOpts.force && process.stdout.isTTY) {
+      const confirm6 = await p4.confirm({
+        message: `Delete customer ${id}?`
+      });
+      if (!confirm6 || p4.isCancel(confirm6)) return;
+    }
+    const customerId = parseId(id);
+    await client.deleteCustomer({ id: customerId });
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: { success: true, id: customerId } }, opts);
+      return;
+    }
+    printSuccess(`Customer ${id} deleted`);
+  });
 }
 
 // src/commands/entries.ts
 import { styleText as styleText4 } from "util";
-import * as p4 from "@clack/prompts";
-import { getEntryDurationUntilNow, isTimeEntry } from "clockodo";
+import * as p5 from "@clack/prompts";
+import { Billability as Billability3, getEntryDurationUntilNow as getEntryDurationUntilNow2, isTimeEntry } from "clockodo";
 function registerEntriesCommands(program2) {
   const entries = program2.command("entries").description("Manage time entries");
-  entries.command("list", { isDefault: true }).description("List time entries").option("--since <date>", "Start date (default: today)", "today").option("--until <date>", "End date (default: today)").option("--customer <id>", "Filter by customer ID", parseIntStrict).option("--project <id>", "Filter by project ID", parseIntStrict).option("--service <id>", "Filter by service ID", parseIntStrict).option("--text <search>", "Filter by description text").option(
+  entries.command("list", { isDefault: true }).description("List time entries").option("--since <date>", "Start date (default: today)", "today").option("--until <date>", "End date (default: today)").option("--customer <id>", "Filter by customer ID", parseIntStrict).option("--project <id>", "Filter by project ID", parseIntStrict).option("--service <id>", "Filter by service ID", parseIntStrict).option("--text <search>", "Filter by description text").option("-b, --billable", "Show only billable entries").option("--no-billable", "Show only non-billable entries").option(
     "-g, --group <field>",
     "Group by: customer, project, service, text (shows summary table instead)"
   ).action(async (cmdOpts) => {
     const opts = program2.opts();
     const client = getClient();
     const since = parseDateTime(cmdOpts.since);
-    const until = cmdOpts.until ? parseDateTime(cmdOpts.until) : toClockodoDateTime(endOfDay(/* @__PURE__ */ new Date()));
+    const until = cmdOpts.until ? parseDateTimeUntil(cmdOpts.until) : toClockodoDateTime(endOfDay(/* @__PURE__ */ new Date()));
     const filter = {};
     if (cmdOpts.customer) filter.customersId = cmdOpts.customer;
     if (cmdOpts.project) filter.projectsId = cmdOpts.project;
     if (cmdOpts.service) filter.servicesId = cmdOpts.service;
     if (cmdOpts.text) filter.text = cmdOpts.text;
+    if (cmdOpts.billable !== void 0)
+      filter.billable = cmdOpts.billable ? Billability3.Billable : Billability3.NotBillable;
     const result = await client.getEntries({
       timeSince: since,
       timeUntil: until,
@@ -795,7 +935,7 @@ function registerEntriesCommands(program2) {
       }
       return;
     }
-    const totalSeconds = entryList.reduce((sum, e) => sum + getEntryDurationUntilNow(e), 0);
+    const totalSeconds = entryList.reduce((sum, e) => sum + getEntryDurationUntilNow2(e), 0);
     if (cmdOpts.group) {
       const groupKey = resolveGroupKey(cmdOpts.group);
       const groups = groupEntries(entryList, groupKey);
@@ -841,7 +981,7 @@ function registerEntriesCommands(program2) {
       formatDate(new Date(e.timeSince)),
       formatTime(e.timeSince),
       isTimeEntry(e) && !e.timeUntil ? styleText4("green", "running") : formatTime(e.timeUntil ?? e.timeSince),
-      formatDuration(getEntryDurationUntilNow(e)),
+      formatDuration(getEntryDurationUntilNow2(e)),
       e.text || styleText4("dim", "\u2014")
     ]);
     printTable(["ID", "Date", "Start", "End", "Duration", "Description"], rows, opts);
@@ -862,7 +1002,7 @@ function registerEntriesCommands(program2) {
       return;
     }
     const timeUntilDisplay = isTimeEntry(e) && !e.timeUntil ? "running" : formatTime(e.timeUntil ?? e.timeSince);
-    const duration = getEntryDurationUntilNow(e);
+    const duration = getEntryDurationUntilNow2(e);
     printDetail(
       [
         ["ID", e.id],
@@ -874,12 +1014,12 @@ function registerEntriesCommands(program2) {
         ["Customer ID", e.customersId],
         ["Project ID", e.projectsId ?? null],
         ["Service ID", isTimeEntry(e) ? e.servicesId : null],
-        ["Billable", e.billable === 1 ? "Yes" : e.billable === 2 ? "Billed" : "No"]
+        ["Billable", formatBillable(e.billable)]
       ],
       opts
     );
   });
-  entries.command("create").description("Create a time entry").requiredOption("--from <datetime>", "Start time (e.g., '2024-01-15 09:00' or '09:00')").requiredOption("--to <datetime>", "End time (e.g., '2024-01-15 17:00' or '17:00')").option("-c, --customer <id>", "Customer ID", parseIntStrict).option("-p, --project <id>", "Project ID", parseIntStrict).option("-s, --service <id>", "Service ID", parseIntStrict).option("-t, --text <description>", "Entry description").option("-b, --billable", "Mark as billable").action(async (cmdOpts) => {
+  entries.command("create").description("Create a time entry").requiredOption("--from <datetime>", "Start time (e.g., '2024-01-15 09:00' or '09:00')").requiredOption("--to <datetime>", "End time (e.g., '2024-01-15 17:00' or '17:00')").option("-c, --customer <id>", "Customer ID", parseIntStrict).option("-p, --project <id>", "Project ID", parseIntStrict).option("-s, --service <id>", "Service ID", parseIntStrict).option("-t, --text <description>", "Entry description").option("-b, --billable", "Mark as billable").option("--no-billable", "Mark as not billable").action(async (cmdOpts) => {
     const opts = program2.opts();
     const mode = resolveOutputMode(opts);
     const client = getClient();
@@ -900,10 +1040,20 @@ function registerEntriesCommands(program2) {
         "Use --customer and --service flags, or set defaults via: clockodo config set"
       );
     }
+    let billable;
+    if (cmdOpts.billable !== void 0) {
+      billable = cmdOpts.billable ? Billability3.Billable : Billability3.NotBillable;
+    } else if (projectsId) {
+      const { data: project } = await client.getProject({ id: projectsId });
+      billable = project.billableDefault ? Billability3.Billable : Billability3.NotBillable;
+    } else {
+      const { data: customer } = await client.getCustomer({ id: customersId });
+      billable = customer.billableDefault ? Billability3.Billable : Billability3.NotBillable;
+    }
     const result = await client.addEntry({
       customersId,
       servicesId,
-      billable: cmdOpts.billable ? 1 : 0,
+      billable,
       timeSince: parseDateTime(cmdOpts.from),
       timeUntil: parseDateTime(cmdOpts.to),
       ...projectsId && { projectsId },
@@ -914,20 +1064,24 @@ function registerEntriesCommands(program2) {
       return;
     }
     const entry = result.entry;
-    const duration = getEntryDurationUntilNow(entry);
+    const duration = getEntryDurationUntilNow2(entry);
     printSuccess(`Entry created (ID: ${entry.id})`);
     console.log(
       `  ${formatTime(entry.timeSince)} \u2014 ${entry.timeUntil ? formatTime(entry.timeUntil) : "?"} (${formatDuration(duration)})`
     );
   });
-  entries.command("update <id>").description("Update a time entry").option("--from <datetime>", "New start time").option("--to <datetime>", "New end time").option("-t, --text <description>", "New description").option("-b, --billable", "Mark as billable").option("--no-billable", "Mark as not billable").action(async (id, cmdOpts) => {
+  entries.command("update <id>").description("Update a time entry").option("--from <datetime>", "New start time").option("--to <datetime>", "New end time").option("-t, --text <description>", "New description").option("-c, --customer <id>", "New customer ID", parseIntStrict).option("--project <id>", "New project ID", parseIntStrict).option("-s, --service <id>", "New service ID", parseIntStrict).option("-b, --billable", "Mark as billable").option("--no-billable", "Mark as not billable").action(async (id, cmdOpts) => {
     const opts = program2.opts();
     const client = getClient();
     const updates = { id: parseId(id) };
     if (cmdOpts.from) updates.timeSince = parseDateTime(cmdOpts.from);
     if (cmdOpts.to) updates.timeUntil = parseDateTime(cmdOpts.to);
     if (cmdOpts.text !== void 0) updates.text = cmdOpts.text;
-    if (cmdOpts.billable !== void 0) updates.billable = cmdOpts.billable ? 1 : 0;
+    if (cmdOpts.customer !== void 0) updates.customersId = cmdOpts.customer;
+    if (cmdOpts.project !== void 0) updates.projectsId = cmdOpts.project;
+    if (cmdOpts.service !== void 0) updates.servicesId = cmdOpts.service;
+    if (cmdOpts.billable !== void 0)
+      updates.billable = cmdOpts.billable ? Billability3.Billable : Billability3.NotBillable;
     const result = await client.editEntry(updates);
     const mode = resolveOutputMode(opts);
     if (mode !== "human") {
@@ -940,10 +1094,10 @@ function registerEntriesCommands(program2) {
     const opts = program2.opts();
     const client = getClient();
     if (!cmdOpts.force && process.stdout.isTTY) {
-      const confirm3 = await p4.confirm({
+      const confirm6 = await p5.confirm({
         message: `Delete entry ${id}?`
       });
-      if (!confirm3 || p4.isCancel(confirm3)) return;
+      if (!confirm6 || p5.isCancel(confirm6)) return;
     }
     const entryId = parseId(id);
     await client.deleteEntry({ id: entryId });
@@ -989,7 +1143,7 @@ function groupEntries(entries, key) {
       groupValue = val != null ? String(val) : "(none)";
     }
     const existing = map.get(groupValue);
-    const duration = getEntryDurationUntilNow(e);
+    const duration = getEntryDurationUntilNow2(e);
     if (existing) {
       existing.count++;
       existing.seconds += duration;
@@ -999,8 +1153,19 @@ function groupEntries(entries, key) {
   }
   return [...map.entries()].map(([k, v]) => ({ key: k, ...v })).sort((a, b) => b.seconds - a.seconds);
 }
+function formatBillable(value) {
+  switch (value) {
+    case Billability3.Billable:
+      return "Yes";
+    case Billability3.Billed:
+      return "Billed";
+    default:
+      return "No";
+  }
+}
 
 // src/commands/projects.ts
+import * as p6 from "@clack/prompts";
 function registerProjectsCommands(program2) {
   const projects = program2.command("projects").description("Manage projects");
   projects.command("list", { isDefault: true }).description("List projects").option("--customer <id>", "Filter by customer ID", parseIntStrict).option("--active", "Show only active projects").option("--search <text>", "Search by name").action(async (cmdOpts) => {
@@ -1015,17 +1180,25 @@ function registerProjectsCommands(program2) {
     );
     const items = result.data ?? [];
     const mode = resolveOutputMode(opts);
+    if (items.length === 0) {
+      if (mode !== "human") {
+        printResult({ data: [], meta: { count: 0 } }, opts);
+      } else {
+        printInfo("No projects found.");
+      }
+      return;
+    }
     if (mode !== "human") {
       printResult({ data: items, meta: { count: items.length } }, opts);
       return;
     }
-    const rows = items.map((p5) => [
-      String(p5.id),
-      p5.name,
-      p5.number ?? "\u2014",
-      String(p5.customersId),
-      p5.active ? "Yes" : "No",
-      p5.completed ? "Yes" : "No"
+    const rows = items.map((proj) => [
+      String(proj.id),
+      proj.name,
+      proj.number ?? "\u2014",
+      String(proj.customersId),
+      proj.active ? "Yes" : "No",
+      proj.completed ? "Yes" : "No"
     ]);
     printTable(["ID", "Name", "Number", "Customer", "Active", "Completed"], rows, opts);
   });
@@ -1033,39 +1206,212 @@ function registerProjectsCommands(program2) {
     const opts = program2.opts();
     const client = getClient();
     const result = await client.getProject({ id: parseId(id) });
-    const p5 = result.data;
+    const proj = result.data;
     const mode = resolveOutputMode(opts);
     if (mode !== "human") {
-      printResult({ data: p5 }, opts);
+      printResult({ data: proj }, opts);
       return;
     }
     printDetail(
       [
-        ["ID", p5.id],
-        ["Name", p5.name],
-        ["Number", p5.number ?? null],
-        ["Customer ID", p5.customersId],
-        ["Active", p5.active],
-        ["Completed", p5.completed],
-        ["Budget", p5.budget?.amount ?? null],
-        ["Budget Type", p5.budget?.monetary ? "Money" : "Hours"],
-        ["Note", p5.note ?? null]
+        ["ID", proj.id],
+        ["Name", proj.name],
+        ["Number", proj.number ?? null],
+        ["Customer ID", proj.customersId],
+        ["Active", proj.active],
+        ["Completed", proj.completed],
+        ["Budget", proj.budget?.amount ?? null],
+        ["Budget Type", proj.budget?.monetary ? "Money" : "Hours"],
+        ["Note", proj.note ?? null]
       ],
       opts
     );
   });
+  projects.command("create").description("Create a project").requiredOption("--name <name>", "Project name").requiredOption("--customer <id>", "Customer ID", parseIntStrict).option("--number <text>", "Project number").option("--note <text>", "Note").option("--active", "Set as active (default)").option("--no-active", "Set as inactive").option("--billable", "Set as billable by default").option("--no-billable", "Set as not billable by default").action(async (cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const params = {
+      name: cmdOpts.name,
+      customersId: cmdOpts.customer,
+      ...cmdOpts.number != null && { number: cmdOpts.number },
+      ...cmdOpts.note != null && { note: cmdOpts.note },
+      ...cmdOpts.active !== void 0 && { active: cmdOpts.active },
+      ...cmdOpts.billable !== void 0 && {
+        billableDefault: cmdOpts.billable
+      }
+    };
+    const result = await client.addProject(params);
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.data }, opts);
+      return;
+    }
+    printSuccess(`Project created (ID: ${result.data.id})`);
+    console.log(`  ${result.data.name}`);
+  });
+  projects.command("update <id>").description("Update a project").option("--name <name>", "New name").option("--customer <id>", "New customer ID", parseIntStrict).option("--number <text>", "New number").option("--note <text>", "New note").option("--active", "Set as active").option("--no-active", "Set as inactive").option("--billable", "Set as billable by default").option("--no-billable", "Set as not billable by default").action(async (id, cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const params = {
+      id: parseId(id),
+      ...cmdOpts.name != null && { name: cmdOpts.name },
+      ...cmdOpts.customer != null && { customersId: cmdOpts.customer },
+      ...cmdOpts.number != null && { number: cmdOpts.number },
+      ...cmdOpts.note != null && { note: cmdOpts.note },
+      ...cmdOpts.active !== void 0 && { active: cmdOpts.active },
+      ...cmdOpts.billable !== void 0 && {
+        billableDefault: cmdOpts.billable
+      }
+    };
+    const result = await client.editProject(params);
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.data }, opts);
+      return;
+    }
+    printSuccess(`Project ${id} updated`);
+  });
+  projects.command("delete <id>").description("Delete a project").option("-f, --force", "Skip confirmation").action(async (id, cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    if (!cmdOpts.force && process.stdout.isTTY) {
+      const confirm6 = await p6.confirm({
+        message: `Delete project ${id}?`
+      });
+      if (!confirm6 || p6.isCancel(confirm6)) return;
+    }
+    const projectId = parseId(id);
+    await client.deleteProject({ id: projectId });
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: { success: true, id: projectId } }, opts);
+      return;
+    }
+    printSuccess(`Project ${id} deleted`);
+  });
 }
 
 // src/commands/report.ts
 import { styleText as styleText5 } from "util";
+import { getEntryDurationUntilNow as getEntryDurationUntilNow3 } from "clockodo";
+var GROUP_ALIASES = {
+  customer: "customers_id",
+  customers: "customers_id",
+  customers_id: "customers_id",
+  project: "projects_id",
+  projects: "projects_id",
+  projects_id: "projects_id",
+  service: "services_id",
+  services: "services_id",
+  services_id: "services_id",
+  text: "text",
+  description: "text"
+};
+function resolveReportGroupKey(input) {
+  const resolved = GROUP_ALIASES[input.toLowerCase()];
+  if (!resolved) {
+    throw new CliError(
+      `Unknown group field: "${input}". Valid options: customer, project, service, text`,
+      ExitCode.INVALID_ARGS
+    );
+  }
+  return resolved;
+}
+function groupEntriesByText(entries) {
+  const map = /* @__PURE__ */ new Map();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  for (const e of entries) {
+    const groupKey = e.text || "(no description)";
+    const duration = getEntryDurationUntilNow3(e);
+    const existing = map.get(groupKey);
+    const timeRange = { since: e.timeSince, until: e.timeUntil ?? now };
+    if (existing) {
+      existing.count++;
+      existing.seconds += duration;
+      existing.timeRanges.push(timeRange);
+    } else {
+      map.set(groupKey, {
+        key: groupKey,
+        count: 1,
+        seconds: duration,
+        timeRanges: [timeRange]
+      });
+    }
+  }
+  return [...map.values()].sort((a, b) => b.seconds - a.seconds);
+}
+function buildFilter(cmdOpts) {
+  const filter = {};
+  if (cmdOpts.customer !== void 0) filter.customersId = cmdOpts.customer;
+  if (cmdOpts.project !== void 0) filter.projectsId = cmdOpts.project;
+  if (cmdOpts.service !== void 0) filter.servicesId = cmdOpts.service;
+  if (cmdOpts.text !== void 0) filter.text = cmdOpts.text;
+  if (cmdOpts.user !== void 0) filter.usersId = cmdOpts.user;
+  return Object.keys(filter).length > 0 ? filter : void 0;
+}
+async function runTextReport(program2, since, until, cmdOpts) {
+  const opts = program2.opts();
+  const client = getClient();
+  const filter = buildFilter(cmdOpts);
+  const result = await client.getEntries({
+    timeSince: toClockodoDateTime(since),
+    timeUntil: toClockodoDateTime(until),
+    ...filter && { filter }
+  });
+  const entryList = result.entries ?? [];
+  const groups = groupEntriesByText(entryList);
+  const totalSeconds = groups.reduce((sum, g) => sum + g.seconds, 0);
+  const mode = resolveOutputMode(opts);
+  if (mode !== "human") {
+    printResult(
+      {
+        data: {
+          period: { since: formatDate(since), until: formatDate(until) },
+          groups,
+          total: { seconds: totalSeconds, formatted: formatDuration(totalSeconds) }
+        }
+      },
+      opts
+    );
+    return;
+  }
+  printReportHeader(since, until);
+  if (groups.length === 0) {
+    console.log(styleText5("dim", "  No entries found for this period."));
+    return;
+  }
+  const rows = groups.map((g) => {
+    const ranges = g.timeRanges.map((r) => `${formatTime(r.since)}\u2013${formatTime(r.until)}`).join(", ");
+    return [g.key, formatDuration(g.seconds), formatDecimalHours(g.seconds), ranges];
+  });
+  printTable(["Description", "Duration", "Hours", "Time Ranges"], rows, opts);
+  printReportTotal(totalSeconds);
+}
+function printReportHeader(since, until) {
+  console.log();
+  console.log(`  ${styleText5("bold", "Report")}: ${formatDate(since)} \u2014 ${formatDate(until)}`);
+  console.log();
+}
+function printReportTotal(totalSeconds) {
+  console.log();
+  console.log(
+    `  ${styleText5("bold", "Total")}: ${formatDuration(totalSeconds)} (${formatDecimalHours(totalSeconds)})`
+  );
+  console.log();
+}
 async function runReport(program2, since, until, cmdOpts) {
+  const groupField = resolveReportGroupKey(cmdOpts.group ?? "project");
+  if (groupField === "text") {
+    return runTextReport(program2, since, until, cmdOpts);
+  }
   const opts = program2.opts();
   const client = getClient();
-  const grouping = [cmdOpts.group ?? "projects_id"];
+  const filter = buildFilter(cmdOpts);
   const result = await client.getEntryGroups({
     timeSince: toClockodoDateTime(since),
     timeUntil: toClockodoDateTime(until),
-    grouping
+    grouping: [groupField],
+    ...filter && { filter }
   });
   const groups = result.groups ?? [];
   const totalSeconds = groups.reduce((sum, g) => sum + (g.duration ?? 0), 0);
@@ -1083,9 +1429,7 @@ async function runReport(program2, since, until, cmdOpts) {
     );
     return;
   }
-  console.log();
-  console.log(`  ${styleText5("bold", "Report")}: ${formatDate(since)} \u2014 ${formatDate(until)}`);
-  console.log();
+  printReportHeader(since, until);
   if (groups.length === 0) {
     console.log(styleText5("dim", "  No entries found for this period."));
     return;
@@ -1096,33 +1440,39 @@ async function runReport(program2, since, until, cmdOpts) {
     formatDecimalHours(g.duration ?? 0)
   ]);
   printTable(["Name", "Duration", "Hours"], rows, opts);
-  console.log();
-  console.log(
-    `  ${styleText5("bold", "Total")}: ${formatDuration(totalSeconds)} (${formatDecimalHours(totalSeconds)})`
-  );
-  console.log();
+  printReportTotal(totalSeconds);
+}
+function addFilterOptions(cmd) {
+  return cmd.option("--customer <id>", "Filter by customer ID", parseIntStrict).option("--project <id>", "Filter by project ID", parseIntStrict).option("--service <id>", "Filter by service ID", parseIntStrict).option("--text <text>", "Filter by description text").option("--user <id>", "Filter by user ID", parseIntStrict);
 }
 function registerReportCommands(program2) {
   const report = program2.command("report").description("Aggregated time reports");
-  report.command("today", { isDefault: true }).description("Today's summary").option(
-    "-g, --group <field>",
-    "Group by: projects_id, customers_id, services_id",
-    "projects_id"
+  addFilterOptions(
+    report.command("today", { isDefault: true }).description("Today's summary").option("-g, --group <field>", "Group by: customer, project, service, text", "project")
   ).action(async (cmdOpts) => {
     const now = /* @__PURE__ */ new Date();
     await runReport(program2, startOfDay(now), endOfDay(now), cmdOpts);
   });
-  report.command("week").description("This week's summary (Mon-Sun)").option("-g, --group <field>", "Group by field", "projects_id").action(async (cmdOpts) => {
+  addFilterOptions(
+    report.command("week").description("This week's summary (Mon-Sun)").option("-g, --group <field>", "Group by: customer, project, service, text", "project")
+  ).action(async (cmdOpts) => {
     const now = /* @__PURE__ */ new Date();
     await runReport(program2, startOfWeek(now), endOfWeek(now), cmdOpts);
   });
-  report.command("month").description("This month's summary").option("-g, --group <field>", "Group by field", "projects_id").action(async (cmdOpts) => {
+  addFilterOptions(
+    report.command("month").description("This month's summary").option("-g, --group <field>", "Group by: customer, project, service, text", "project")
+  ).action(async (cmdOpts) => {
     const now = /* @__PURE__ */ new Date();
     await runReport(program2, startOfMonth(now), endOfMonth(now), cmdOpts);
   });
-  report.command("custom").description("Custom date range report").requiredOption("--since <date>", "Start date").requiredOption("--until <date>", "End date").option("-g, --group <field>", "Group by field", "projects_id").action(async (cmdOpts) => {
+  addFilterOptions(
+    report.command("custom").description("Custom date range report").requiredOption("--since <date>", "Start date").requiredOption("--until <date>", "End date").option("-g, --group <field>", "Group by: customer, project, service, text", "project")
+  ).action(async (cmdOpts) => {
     const since = new Date(parseDateTime(cmdOpts.since));
-    const until = new Date(parseDateTime(cmdOpts.until));
+    const until = new Date(parseDateTimeUntil(cmdOpts.until));
+    if (since >= until) {
+      throw new CliError("--since must be before --until", ExitCode.INVALID_ARGS);
+    }
     await runReport(program2, since, until, cmdOpts);
   });
 }
@@ -1159,6 +1509,7 @@ function registerSchemaCommand(program2) {
 }
 
 // src/commands/services.ts
+import * as p7 from "@clack/prompts";
 function registerServicesCommands(program2) {
   const services = program2.command("services").description("Manage services");
   services.command("list", { isDefault: true }).description("List services").option("--active", "Show only active services").option("--search <text>", "Search by name").action(async (cmdOpts) => {
@@ -1172,6 +1523,14 @@ function registerServicesCommands(program2) {
     );
     const items = result.data ?? [];
     const mode = resolveOutputMode(opts);
+    if (items.length === 0) {
+      if (mode !== "human") {
+        printResult({ data: [], meta: { count: 0 } }, opts);
+      } else {
+        printInfo("No services found.");
+      }
+      return;
+    }
     if (mode !== "human") {
       printResult({ data: items, meta: { count: items.length } }, opts);
       return;
@@ -1205,16 +1564,94 @@ function registerServicesCommands(program2) {
       opts
     );
   });
+  services.command("create").description("Create a service").requiredOption("--name <name>", "Service name").option("--number <text>", "Service number").option("--note <text>", "Note").option("--active", "Set as active (default)").option("--no-active", "Set as inactive").action(async (cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const params = {
+      name: cmdOpts.name,
+      ...cmdOpts.number != null && { number: cmdOpts.number },
+      ...cmdOpts.note != null && { note: cmdOpts.note },
+      ...cmdOpts.active !== void 0 && { active: cmdOpts.active }
+    };
+    const result = await client.addService(params);
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.data }, opts);
+      return;
+    }
+    printSuccess(`Service created (ID: ${result.data.id})`);
+    console.log(`  ${result.data.name}`);
+  });
+  services.command("update <id>").description("Update a service").option("--name <name>", "New name").option("--number <text>", "New number").option("--note <text>", "New note").option("--active", "Set as active").option("--no-active", "Set as inactive").action(async (id, cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    const params = {
+      id: parseId(id),
+      ...cmdOpts.name != null && { name: cmdOpts.name },
+      ...cmdOpts.number != null && { number: cmdOpts.number },
+      ...cmdOpts.note != null && { note: cmdOpts.note },
+      ...cmdOpts.active !== void 0 && { active: cmdOpts.active }
+    };
+    const result = await client.editService(params);
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: result.data }, opts);
+      return;
+    }
+    printSuccess(`Service ${id} updated`);
+  });
+  services.command("delete <id>").description("Delete a service").option("-f, --force", "Skip confirmation").action(async (id, cmdOpts) => {
+    const opts = program2.opts();
+    const client = getClient();
+    if (!cmdOpts.force && process.stdout.isTTY) {
+      const confirm6 = await p7.confirm({
+        message: `Delete service ${id}?`
+      });
+      if (!confirm6 || p7.isCancel(confirm6)) return;
+    }
+    const serviceId = parseId(id);
+    await client.deleteService({ id: serviceId });
+    const mode = resolveOutputMode(opts);
+    if (mode !== "human") {
+      printResult({ data: { success: true, id: serviceId } }, opts);
+      return;
+    }
+    printSuccess(`Service ${id} deleted`);
+  });
 }
 
 // src/commands/status.ts
 import { styleText as styleText6 } from "util";
 import { isTimeEntry as isTimeEntry2 } from "clockodo";
 function registerStatusCommand(program2) {
-  program2.command("status").description("Show running clock and today's summary").action(async () => {
+  program2.command("status").description("Show running clock and today's summary").option("--prompt", "Single-line output for shell prompts (p10k, starship)").action(async (cmdOpts) => {
     const opts = program2.opts();
     const client = getClient();
     const mode = resolveOutputMode(opts);
+    if (cmdOpts.prompt) {
+      const clock = await client.getClock();
+      const running2 = clock.running;
+      const elapsed = running2 ? elapsedSince(running2.timeSince) : 0;
+      if (mode !== "human") {
+        printResult(
+          {
+            data: {
+              running: !!running2,
+              text: running2?.text ?? null,
+              elapsed,
+              formatted: formatDuration(elapsed)
+            }
+          },
+          opts
+        );
+        return;
+      }
+      if (running2) {
+        const parts = [running2.text, formatDuration(elapsed)].filter(Boolean);
+        console.log(parts.join(" "));
+      }
+      return;
+    }
     const now = /* @__PURE__ */ new Date();
     const [clockResult, entriesResult] = await Promise.all([
       client.getClock(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liebig-technology/clockodo-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "AI-friendly CLI for the Clockodo time tracking API",
   "type": "module",
   "bin": {
@@ -13,17 +13,6 @@
   "engines": {
     "node": ">=22.0.0"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check .",
-    "lint:fix": "biome check --write .",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build",
-    "prepare": "husky"
-  },
   "keywords": [
     "clockodo",
     "time-tracking",
@@ -62,5 +51,14 @@
     "*": [
       "biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
     ]
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}