edays-cli

Command-line client for the eDays leave/absence system. Read your own or your team's calendar, and book or cancel Holiday / Home Office absences without opening the web app.

• Works with any eDays instance — the instance URL, absence types and team roster live in your local config file, nothing is hard-coded.
• Signs in through your organisation's normal SSO in a real browser window; the captured session is reused until it expires.
• JSON output by default (script- and AI-agent-friendly), tables with --pretty.

Install

uv tool install edays-cli
edays install-browser        # one-time: downloads Chromium for the SSO login

or pip install edays-cli. Requires Python 3.11+.

Quick start

edays read                   # first run creates ~/.edays-cli/config.toml and says so
# edit the config: set [edays] base_url to your eDays address
edays login                  # sign in via SSO in the browser window
edays --pretty absence-types # list bookable types, then map the ones you use:
edays absence-types --add holiday=123 --add "home-office=Home Office"
edays --pretty team sync     # managers: add your direct reports to the roster
edays --pretty read --month 2026-11
edays book holiday 2026-12-22 --to 2026-12-31 --dry-run
edays book home-office 2026-11-05 --day-part pm   # half day (afternoon)

Global flags (--pretty, --quiet, --config) go before the subcommand.

Documentation

Full installation, configuration and command reference: docs/manual.md.

Development

git clone https://github.com/xdoko01/edays-cli && cd edays-cli
uv run --extra dev pytest                    # offline unit tests
uv run --extra dev pytest -m integration     # live test; needs `edays login` first

Disclaimer

Unofficial tool, not affiliated with or endorsed by eDays. It uses the same internal API as the eDays web application, which may change without notice.

License

MIT