ProjeQtOr CLI

Small, read-only CLI for listing and viewing tickets assigned to the signed-in ProjeQtOr resource.

Install

python -m venv .venv
. .venv/bin/activate
pip install -e '.[test]'

Copy config.example.yaml to ~/.config/projeqtor/config.yaml and set the ProjeQtOr installation URL. SAML and identity-provider settings remain configured in ProjeQtOr; they are not duplicated in the CLI.

YAML is provided by the PyYAML dependency; it is not part of Python's standard library.

Usage

projeqtor auth login
projeqtor auth status
projeqtor tickets list
projeqtor tickets list --all --json
projeqtor tickets show 345
projeqtor tickets open 345
projeqtor auth logout

Environment variables override YAML values. Command-line configuration overrides both:

PROJEQTOR_CONFIG
PROJEQTOR_URL
PROJEQTOR_AUTH_CACHE
PROJEQTOR_RESOURCE_ID
PROJEQTOR_TIMEOUT

projeqtor auth login opens the ProjeQtOr SAML login in the system browser and listens on a loopback callback. The resulting API credential is stored in the OS keyring, never in YAML. The ProjeQtOr SAML ACS/API gateway must support the cli_callback, state, and returned credential hand-off. A normal browser session cookie cannot be used by the CLI process. The CLI remains read-only.