add Dockerfile for CLI image

[jgarte]

Closes #24

Note that this Docker image requires using the Kimai config on the host machine.

That is, I ran kimai config from the CLI in the container in order to generate the config on the host's filesystem at ~/.config.

Running kimai cli with the version flag

$ podman run --rm --network none kimai-cli:local --version
Kimai - Remote Console version 2.0.0 2026-09-09 10:27:44 UTC (#21345e3)

Running the kimai cli with the list subcommand

jgart@framework-laptop:~/Code/php/cli$ podman run --rm --network none kimai-cli:local list
 _  _____ __  __    _    ___
| |/ /_ _|  \/  |  / \  |_ _|
| ' / | || |\/| | / _ \  | |
| . \ | || |  | |/ ___ \ | |
|_|\_\___|_|  |_/_/   \_\___|

Kimai - Remote Console version 2.0.0 2026-09-09 10:27:44 UTC (#21345e3)

Usage:
  command [options] [arguments]

Options:
  -h, --help            Display help for the given command. When no command is given display help for the list command
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
  -n, --no-interaction  Do not ask any interactive question
      --profile         Display timing and memory usage information
      --csv             Render raw data instead of styled tables
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
  active         List active timesheets, update description and tags
  configuration  Handle the Kimai configuration file
  help           Display help for a command
  list           List commands
  start          Starts a new timesheet
  stop           Stop running timesheets, set description and tags
  version        Show the Kimai version
 activity
  activity:list  List available activities
 customer
  customer:list  List available customers
 project
  project:list   List available projects

[kevinpapst]

Nice approach, thanks for starting the discussion 👍

I will post more details later on, just as a starter:
I relaxed the composer requirement in the composer.json, so we can switch to PHP 8.5

And we need to document the usage with docker (native please, not podman).
Are you open to create a PR there to explain it in this file: https://github.com/kimai/www.kimai.org/blob/main/collections/_documentation/cli.md ?

[jgarte]

Nice approach, thanks for starting the discussion 👍

I will post more details later on, just as a starter: I relaxed the composer requirement in the composer.json, so we can switch to PHP 8.5

And we need to document the usage with docker (native please, not podman). Are you open to create a PR there to explain it in this file: https://github.com/kimai/www.kimai.org/blob/main/collections/_documentation/cli.md ?

Hi @kevinpapst Yes, I can do that in a separate PR. How does that sound?

[jgarte]

Hi @kevinpapst Yes, I can do that in a separate PR. How does that sound?

Separate PR created here: kimai/www.kimai.org#768