agent-tool-openproject-cli 0.2.1__tar.gz → 0.3.0__tar.gz

{agent_tool_openproject_cli-0.2.1/src/agent_tool_openproject_cli.egg-info → agent_tool_openproject_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-tool-openproject-cli
-Version: 0.2.1
+Version: 0.3.0
 Summary: Agent-ready command-line interface for OpenProject (work packages, projects, time, costs, search, and more). Installs the `openproject` command.
 Author: Zierhut IT, Alexander Zierhut
 License: MIT
@@ -31,19 +31,23 @@ Provides-Extra: build
 Requires-Dist: pyinstaller>=6; extra == "build"
 Dynamic: license-file
 
-# openproject-cli — the agent-ready OpenProject command-line interface
+# openproject — the agent-ready OpenProject CLI
 
 > A fast, scriptable **OpenProject CLI** for managing work packages, projects,
 > time tracking, comments, and per-person cost reports from your terminal — and
 > the first OpenProject command-line tool designed to be driven by **AI agents**
 > (Claude, Cursor, LLM tool-loops) as well as humans.
 
+[![PyPI](https://img.shields.io/pypi/v/agent-tool-openproject-cli)](https://pypi.org/project/agent-tool-openproject-cli/)
 [![CI](https://github.com/alexander-zierhut/agent-tool-openproject-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/alexander-zierhut/agent-tool-openproject-cli/actions/workflows/ci.yml)
-![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![Python](https://img.shields.io/pypi/pyversions/agent-tool-openproject-cli)
 ![License: MIT](https://img.shields.io/badge/license-MIT-green)
 ![Agent ready](https://img.shields.io/badge/agent-ready-8A2BE2)
 
-`openproject-cli` is a Python command-line interface for the
+**Install:** `pipx install agent-tool-openproject-cli` — then run `openproject guide`.
+
+[**agent-tool-openproject-cli**](https://pypi.org/project/agent-tool-openproject-cli/)
+(the installed command is `openproject`) is a Python command-line interface for the
 [OpenProject](https://www.openproject.org/) REST API v3. It covers the whole
 day-to-day workflow — **work packages** (create/update/delete/move), assignees,
 custom fields, projects, comments, **time entries**, a genuinely good
@@ -59,8 +63,13 @@ first-class JSON output so it slots straight into automation and AI agents.
 - 🔎 **Discoverable search** — filter with plain flags (`--mine`, `--overdue`,
   `--updated-since 7d`), one-word presets (`search mine`), or `--where` expressions.
   Never memorise filter JSON: `search fields`, `search operators`, `search values`.
-- 🖇️ **Three output formats** — `json` (default), `table`, and `markdown`; pick per
-  command with `-f`, set a default, or select exact `--fields`.
+- 🖇️ **Four output formats** — `json` (default), `table`, `markdown`, and `csv`;
+  pick per command with `-f`, set a default, select exact `--fields`, or `--stream`
+  NDJSON for big result sets.
+- 🧪 **Safe by default** — `--dry-run` previews any write; the client retries
+  transient failures; and `openproject context` gives sticky per-session defaults.
+- 💶 **Invoicing extras** — per-person cost reports, and a detailed CSV export that
+  includes **time-entry custom fields** (which OpenProject's own reports can't).
 - 🔐 **Safe credentials** — API token stored in the OS keyring (Secret Service /
   macOS Keychain / Windows Credential Locker), with a `0600` file fallback.
 - 🧰 **Escape hatch** — `openproject raw` calls any endpoint the typed commands
@@ -74,6 +83,26 @@ first-class JSON output so it slots straight into automation and AI agents.
 work package automation, time tracking CLI, project management CLI, AI agent tool,
 LLM tooling, Claude, DevOps automation, invoicing.
 
+## Compatibility
+
+- **OpenProject API:** the stable REST **API v3** (HAL+JSON).
+- **Tested against:** OpenProject **13, 14, 15, 16, and 17** (Community, all-in-one).
+  The full integration suite passes on every one — the CLI covers the whole feature
+  set across all five majors. (15.x also runs in CI on every push; the `compat`
+  workflow re-runs the 13–17 matrix.)
+- **Version notes uncovered by testing:**
+  - **v16+** — time entries require a work package. Logging time against a *project*
+    only (`time add --project` with no `--work-package`) is rejected with
+    "Logged for can't be blank"; log against a work package instead.
+  - **v17** — the Docker image needs a real `SECRET_KEY_BASE` env var to boot
+    (a container-config change, unrelated to the CLI).
+  - The time-entry work-package **filter** name differs across versions
+    (`work_package_id` on ≤15 vs the newer `entity_*` form); the CLI detects and
+    adapts automatically.
+- **Python:** 3.10+.
+
+Anything version-specific can be reached directly with `openproject raw <method> <path>`.
+
 ---
 
 ## Quick start
@@ -82,16 +111,16 @@ LLM tooling, Claude, DevOps automation, invoicing.
 
 Pick whichever fits your target:
 
-**a) `pipx` (recommended — isolated, `openproject` on PATH, needs Python 3.10+)**
+**a) `pipx` (recommended — isolated, puts `openproject` on your PATH, needs Python 3.10+)**
 ```bash
-pipx install agent-tool-openproject-cli          # from PyPI (installs the `openproject` command)
-pipx install git+https://github.com/alexander-zierhut/agent-tool-openproject-cli.git  # or straight from git
+pipx install agent-tool-openproject-cli          # installs the `openproject` command
 ```
 
-**b) `pip` into a venv (for development)**
+**b) `pip`**
 ```bash
-python3 -m venv .venv && . .venv/bin/activate
-pip install -e .          # from this directory
+pip install agent-tool-openproject-cli           # from PyPI
+# or, for local development from a clone:
+python3 -m venv .venv && . .venv/bin/activate && pip install -e .
 ```
 
 **c) Single self-contained binary (no Python on the target)**
@@ -305,6 +334,17 @@ openproject cost report --from 2026-07-01 --to 2026-07-31 --user jane.doe --rate
 Without `--rates` it reports hours only. Most specific rate wins:
 project+user → project default → user → global default.
 
+**Detailed export with time-entry custom fields** — one row per entry, including
+the time entry's custom fields (something OpenProject's own reports can't export).
+Perfect for invoicing spreadsheets:
+
+```bash
+openproject cost report --month 2026-07 --rates rates.json --detailed -o csv > july.csv
+# columns: date,user,project,workPackage,activity,hours,rate,amount,comment,Cost Center,Billable,…
+```
+
+Set the custom fields when logging: `openproject time add 2 -w 42 --custom-fields '{"customField3":"CC-1000","customField4":true}'` (discover them with `openproject cf time`).
+
 ### Notifications — `openproject notify`
 
 ```bash
@@ -369,19 +409,45 @@ openproject auth logout --name prod
 
 ### Output format & settings — `openproject settings`
 
-Three output formats: **`json`** (default, best for scripts/agents),
-**`table`** (human-readable terminal tables), and **`markdown`** (paste into
-docs/PRs). Choose per command, or set a persistent default.
+Four output formats: **`json`** (default), **`table`**, **`markdown`**, and
+**`csv`**. Choose per command, or set a persistent default.
 
 ```bash
 openproject wp list -o table                 # global flag (before the command)
 openproject wp list --format markdown        # --format/-f works AFTER any command too
-openproject wp get 42 -f md
+openproject search wp --mine -o csv          # spreadsheet export
+openproject wp get 42 --fields id,subject,assignee.name    # pick exact fields (dotted ok)
 
 openproject settings set-format table        # persist a default
 openproject settings show                    # current default, config path, profiles
 ```
 
+**Preview & scale flags** (work anywhere on the line):
+
+```bash
+openproject wp update 42 --status Closed --dry-run   # prints the request, sends nothing
+openproject search wp --project big --stream          # NDJSON, one object per line, as fetched
+```
+
+The client also **retries** transient failures (429 rate-limits + 5xx on reads)
+with backoff, honoring `Retry-After`.
+
+### Session context — `openproject context`
+
+Stop repeating `--project`/`--user`/filters: set them once and they apply to
+later commands as defaults (explicit flags always win; `--no-context` bypasses).
+
+```bash
+openproject context set --project webshop --assignee me
+openproject context show               # see the active defaults
+openproject wp list                    # behaves like: wp list --project webshop --assignee me
+openproject wp list --project other    # explicit flag wins
+openproject --no-context wp list       # ignore the context for one command
+
+openproject context save sprint        # name it, switch between saved contexts
+openproject context use sprint
+```
+
 On the **first interactive run** the CLI asks which default format you'd like and
 saves your choice. Non-interactive runs (pipes, CI, agents) never prompt — they
 default to `json`. Precedence: `--format`/`-f` → `-o/--output` → `$OPCLI_FORMAT`

{agent_tool_openproject_cli-0.2.1 → agent_tool_openproject_cli-0.3.0}/README.md

@@ -1,16 +1,20 @@
-# openproject-cli — the agent-ready OpenProject command-line interface
+# openproject — the agent-ready OpenProject CLI
 
 > A fast, scriptable **OpenProject CLI** for managing work packages, projects,
 > time tracking, comments, and per-person cost reports from your terminal — and
 > the first OpenProject command-line tool designed to be driven by **AI agents**
 > (Claude, Cursor, LLM tool-loops) as well as humans.
 
+[![PyPI](https://img.shields.io/pypi/v/agent-tool-openproject-cli)](https://pypi.org/project/agent-tool-openproject-cli/)
 [![CI](https://github.com/alexander-zierhut/agent-tool-openproject-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/alexander-zierhut/agent-tool-openproject-cli/actions/workflows/ci.yml)
-![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![Python](https://img.shields.io/pypi/pyversions/agent-tool-openproject-cli)
 ![License: MIT](https://img.shields.io/badge/license-MIT-green)
 ![Agent ready](https://img.shields.io/badge/agent-ready-8A2BE2)
 
-`openproject-cli` is a Python command-line interface for the
+**Install:** `pipx install agent-tool-openproject-cli` — then run `openproject guide`.
+
+[**agent-tool-openproject-cli**](https://pypi.org/project/agent-tool-openproject-cli/)
+(the installed command is `openproject`) is a Python command-line interface for the
 [OpenProject](https://www.openproject.org/) REST API v3. It covers the whole
 day-to-day workflow — **work packages** (create/update/delete/move), assignees,
 custom fields, projects, comments, **time entries**, a genuinely good
@@ -26,8 +30,13 @@ first-class JSON output so it slots straight into automation and AI agents.
 - 🔎 **Discoverable search** — filter with plain flags (`--mine`, `--overdue`,
   `--updated-since 7d`), one-word presets (`search mine`), or `--where` expressions.
   Never memorise filter JSON: `search fields`, `search operators`, `search values`.
-- 🖇️ **Three output formats** — `json` (default), `table`, and `markdown`; pick per
-  command with `-f`, set a default, or select exact `--fields`.
+- 🖇️ **Four output formats** — `json` (default), `table`, `markdown`, and `csv`;
+  pick per command with `-f`, set a default, select exact `--fields`, or `--stream`
+  NDJSON for big result sets.
+- 🧪 **Safe by default** — `--dry-run` previews any write; the client retries
+  transient failures; and `openproject context` gives sticky per-session defaults.
+- 💶 **Invoicing extras** — per-person cost reports, and a detailed CSV export that
+  includes **time-entry custom fields** (which OpenProject's own reports can't).
 - 🔐 **Safe credentials** — API token stored in the OS keyring (Secret Service /
   macOS Keychain / Windows Credential Locker), with a `0600` file fallback.
 - 🧰 **Escape hatch** — `openproject raw` calls any endpoint the typed commands
@@ -41,6 +50,26 @@ first-class JSON output so it slots straight into automation and AI agents.
 work package automation, time tracking CLI, project management CLI, AI agent tool,
 LLM tooling, Claude, DevOps automation, invoicing.
 
+## Compatibility
+
+- **OpenProject API:** the stable REST **API v3** (HAL+JSON).
+- **Tested against:** OpenProject **13, 14, 15, 16, and 17** (Community, all-in-one).
+  The full integration suite passes on every one — the CLI covers the whole feature
+  set across all five majors. (15.x also runs in CI on every push; the `compat`
+  workflow re-runs the 13–17 matrix.)
+- **Version notes uncovered by testing:**
+  - **v16+** — time entries require a work package. Logging time against a *project*
+    only (`time add --project` with no `--work-package`) is rejected with
+    "Logged for can't be blank"; log against a work package instead.
+  - **v17** — the Docker image needs a real `SECRET_KEY_BASE` env var to boot
+    (a container-config change, unrelated to the CLI).
+  - The time-entry work-package **filter** name differs across versions
+    (`work_package_id` on ≤15 vs the newer `entity_*` form); the CLI detects and
+    adapts automatically.
+- **Python:** 3.10+.
+
+Anything version-specific can be reached directly with `openproject raw <method> <path>`.
+
 ---
 
 ## Quick start
@@ -49,16 +78,16 @@ LLM tooling, Claude, DevOps automation, invoicing.
 
 Pick whichever fits your target:
 
-**a) `pipx` (recommended — isolated, `openproject` on PATH, needs Python 3.10+)**
+**a) `pipx` (recommended — isolated, puts `openproject` on your PATH, needs Python 3.10+)**
 ```bash
-pipx install agent-tool-openproject-cli          # from PyPI (installs the `openproject` command)
-pipx install git+https://github.com/alexander-zierhut/agent-tool-openproject-cli.git  # or straight from git
+pipx install agent-tool-openproject-cli          # installs the `openproject` command
 ```
 
-**b) `pip` into a venv (for development)**
+**b) `pip`**
 ```bash
-python3 -m venv .venv && . .venv/bin/activate
-pip install -e .          # from this directory
+pip install agent-tool-openproject-cli           # from PyPI
+# or, for local development from a clone:
+python3 -m venv .venv && . .venv/bin/activate && pip install -e .
 ```
 
 **c) Single self-contained binary (no Python on the target)**
@@ -272,6 +301,17 @@ openproject cost report --from 2026-07-01 --to 2026-07-31 --user jane.doe --rate
 Without `--rates` it reports hours only. Most specific rate wins:
 project+user → project default → user → global default.
 
+**Detailed export with time-entry custom fields** — one row per entry, including
+the time entry's custom fields (something OpenProject's own reports can't export).
+Perfect for invoicing spreadsheets:
+
+```bash
+openproject cost report --month 2026-07 --rates rates.json --detailed -o csv > july.csv
+# columns: date,user,project,workPackage,activity,hours,rate,amount,comment,Cost Center,Billable,…
+```
+
+Set the custom fields when logging: `openproject time add 2 -w 42 --custom-fields '{"customField3":"CC-1000","customField4":true}'` (discover them with `openproject cf time`).
+
 ### Notifications — `openproject notify`
 
 ```bash
@@ -336,19 +376,45 @@ openproject auth logout --name prod
 
 ### Output format & settings — `openproject settings`
 
-Three output formats: **`json`** (default, best for scripts/agents),
-**`table`** (human-readable terminal tables), and **`markdown`** (paste into
-docs/PRs). Choose per command, or set a persistent default.
+Four output formats: **`json`** (default), **`table`**, **`markdown`**, and
+**`csv`**. Choose per command, or set a persistent default.
 
 ```bash
 openproject wp list -o table                 # global flag (before the command)
 openproject wp list --format markdown        # --format/-f works AFTER any command too
-openproject wp get 42 -f md
+openproject search wp --mine -o csv          # spreadsheet export
+openproject wp get 42 --fields id,subject,assignee.name    # pick exact fields (dotted ok)
 
 openproject settings set-format table        # persist a default
 openproject settings show                    # current default, config path, profiles
 ```
 
+**Preview & scale flags** (work anywhere on the line):
+
+```bash
+openproject wp update 42 --status Closed --dry-run   # prints the request, sends nothing
+openproject search wp --project big --stream          # NDJSON, one object per line, as fetched
+```
+
+The client also **retries** transient failures (429 rate-limits + 5xx on reads)
+with backoff, honoring `Retry-After`.
+
+### Session context — `openproject context`
+
+Stop repeating `--project`/`--user`/filters: set them once and they apply to
+later commands as defaults (explicit flags always win; `--no-context` bypasses).
+
+```bash
+openproject context set --project webshop --assignee me
+openproject context show               # see the active defaults
+openproject wp list                    # behaves like: wp list --project webshop --assignee me
+openproject wp list --project other    # explicit flag wins
+openproject --no-context wp list       # ignore the context for one command
+
+openproject context save sprint        # name it, switch between saved contexts
+openproject context use sprint
+```
+
 On the **first interactive run** the CLI asks which default format you'd like and
 saves your choice. Non-interactive runs (pipes, CI, agents) never prompt — they
 default to `json`. Precedence: `--format`/`-f` → `-o/--output` → `$OPCLI_FORMAT`

{agent_tool_openproject_cli-0.2.1 → agent_tool_openproject_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-tool-openproject-cli"
-version = "0.2.1"
+version = "0.3.0"
 description = "Agent-ready command-line interface for OpenProject (work packages, projects, time, costs, search, and more). Installs the `openproject` command."
 readme = "README.md"
 requires-python = ">=3.10"

{agent_tool_openproject_cli-0.2.1 → agent_tool_openproject_cli-0.3.0/src/agent_tool_openproject_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-tool-openproject-cli
-Version: 0.2.1
+Version: 0.3.0
 Summary: Agent-ready command-line interface for OpenProject (work packages, projects, time, costs, search, and more). Installs the `openproject` command.
 Author: Zierhut IT, Alexander Zierhut
 License: MIT
@@ -31,19 +31,23 @@ Provides-Extra: build
 Requires-Dist: pyinstaller>=6; extra == "build"
 Dynamic: license-file
 
-# openproject-cli — the agent-ready OpenProject command-line interface
+# openproject — the agent-ready OpenProject CLI
 
 > A fast, scriptable **OpenProject CLI** for managing work packages, projects,
 > time tracking, comments, and per-person cost reports from your terminal — and
 > the first OpenProject command-line tool designed to be driven by **AI agents**
 > (Claude, Cursor, LLM tool-loops) as well as humans.
 
+[![PyPI](https://img.shields.io/pypi/v/agent-tool-openproject-cli)](https://pypi.org/project/agent-tool-openproject-cli/)
 [![CI](https://github.com/alexander-zierhut/agent-tool-openproject-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/alexander-zierhut/agent-tool-openproject-cli/actions/workflows/ci.yml)
-![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![Python](https://img.shields.io/pypi/pyversions/agent-tool-openproject-cli)
 ![License: MIT](https://img.shields.io/badge/license-MIT-green)
 ![Agent ready](https://img.shields.io/badge/agent-ready-8A2BE2)
 
-`openproject-cli` is a Python command-line interface for the
+**Install:** `pipx install agent-tool-openproject-cli` — then run `openproject guide`.
+
+[**agent-tool-openproject-cli**](https://pypi.org/project/agent-tool-openproject-cli/)
+(the installed command is `openproject`) is a Python command-line interface for the
 [OpenProject](https://www.openproject.org/) REST API v3. It covers the whole
 day-to-day workflow — **work packages** (create/update/delete/move), assignees,
 custom fields, projects, comments, **time entries**, a genuinely good
@@ -59,8 +63,13 @@ first-class JSON output so it slots straight into automation and AI agents.
 - 🔎 **Discoverable search** — filter with plain flags (`--mine`, `--overdue`,
   `--updated-since 7d`), one-word presets (`search mine`), or `--where` expressions.
   Never memorise filter JSON: `search fields`, `search operators`, `search values`.
-- 🖇️ **Three output formats** — `json` (default), `table`, and `markdown`; pick per
-  command with `-f`, set a default, or select exact `--fields`.
+- 🖇️ **Four output formats** — `json` (default), `table`, `markdown`, and `csv`;
+  pick per command with `-f`, set a default, select exact `--fields`, or `--stream`
+  NDJSON for big result sets.
+- 🧪 **Safe by default** — `--dry-run` previews any write; the client retries
+  transient failures; and `openproject context` gives sticky per-session defaults.
+- 💶 **Invoicing extras** — per-person cost reports, and a detailed CSV export that
+  includes **time-entry custom fields** (which OpenProject's own reports can't).
 - 🔐 **Safe credentials** — API token stored in the OS keyring (Secret Service /
   macOS Keychain / Windows Credential Locker), with a `0600` file fallback.
 - 🧰 **Escape hatch** — `openproject raw` calls any endpoint the typed commands
@@ -74,6 +83,26 @@ first-class JSON output so it slots straight into automation and AI agents.
 work package automation, time tracking CLI, project management CLI, AI agent tool,
 LLM tooling, Claude, DevOps automation, invoicing.
 
+## Compatibility
+
+- **OpenProject API:** the stable REST **API v3** (HAL+JSON).
+- **Tested against:** OpenProject **13, 14, 15, 16, and 17** (Community, all-in-one).
+  The full integration suite passes on every one — the CLI covers the whole feature
+  set across all five majors. (15.x also runs in CI on every push; the `compat`
+  workflow re-runs the 13–17 matrix.)
+- **Version notes uncovered by testing:**
+  - **v16+** — time entries require a work package. Logging time against a *project*
+    only (`time add --project` with no `--work-package`) is rejected with
+    "Logged for can't be blank"; log against a work package instead.
+  - **v17** — the Docker image needs a real `SECRET_KEY_BASE` env var to boot
+    (a container-config change, unrelated to the CLI).
+  - The time-entry work-package **filter** name differs across versions
+    (`work_package_id` on ≤15 vs the newer `entity_*` form); the CLI detects and
+    adapts automatically.
+- **Python:** 3.10+.
+
+Anything version-specific can be reached directly with `openproject raw <method> <path>`.
+
 ---
 
 ## Quick start
@@ -82,16 +111,16 @@ LLM tooling, Claude, DevOps automation, invoicing.
 
 Pick whichever fits your target:
 
-**a) `pipx` (recommended — isolated, `openproject` on PATH, needs Python 3.10+)**
+**a) `pipx` (recommended — isolated, puts `openproject` on your PATH, needs Python 3.10+)**
 ```bash
-pipx install agent-tool-openproject-cli          # from PyPI (installs the `openproject` command)
-pipx install git+https://github.com/alexander-zierhut/agent-tool-openproject-cli.git  # or straight from git
+pipx install agent-tool-openproject-cli          # installs the `openproject` command
 ```
 
-**b) `pip` into a venv (for development)**
+**b) `pip`**
 ```bash
-python3 -m venv .venv && . .venv/bin/activate
-pip install -e .          # from this directory
+pip install agent-tool-openproject-cli           # from PyPI
+# or, for local development from a clone:
+python3 -m venv .venv && . .venv/bin/activate && pip install -e .
 ```
 
 **c) Single self-contained binary (no Python on the target)**
@@ -305,6 +334,17 @@ openproject cost report --from 2026-07-01 --to 2026-07-31 --user jane.doe --rate
 Without `--rates` it reports hours only. Most specific rate wins:
 project+user → project default → user → global default.
 
+**Detailed export with time-entry custom fields** — one row per entry, including
+the time entry's custom fields (something OpenProject's own reports can't export).
+Perfect for invoicing spreadsheets:
+
+```bash
+openproject cost report --month 2026-07 --rates rates.json --detailed -o csv > july.csv
+# columns: date,user,project,workPackage,activity,hours,rate,amount,comment,Cost Center,Billable,…
+```
+
+Set the custom fields when logging: `openproject time add 2 -w 42 --custom-fields '{"customField3":"CC-1000","customField4":true}'` (discover them with `openproject cf time`).
+
 ### Notifications — `openproject notify`
 
 ```bash
@@ -369,19 +409,45 @@ openproject auth logout --name prod
 
 ### Output format & settings — `openproject settings`
 
-Three output formats: **`json`** (default, best for scripts/agents),
-**`table`** (human-readable terminal tables), and **`markdown`** (paste into
-docs/PRs). Choose per command, or set a persistent default.
+Four output formats: **`json`** (default), **`table`**, **`markdown`**, and
+**`csv`**. Choose per command, or set a persistent default.
 
 ```bash
 openproject wp list -o table                 # global flag (before the command)
 openproject wp list --format markdown        # --format/-f works AFTER any command too
-openproject wp get 42 -f md
+openproject search wp --mine -o csv          # spreadsheet export
+openproject wp get 42 --fields id,subject,assignee.name    # pick exact fields (dotted ok)
 
 openproject settings set-format table        # persist a default
 openproject settings show                    # current default, config path, profiles
 ```
 
+**Preview & scale flags** (work anywhere on the line):
+
+```bash
+openproject wp update 42 --status Closed --dry-run   # prints the request, sends nothing
+openproject search wp --project big --stream          # NDJSON, one object per line, as fetched
+```
+
+The client also **retries** transient failures (429 rate-limits + 5xx on reads)
+with backoff, honoring `Retry-After`.
+
+### Session context — `openproject context`
+
+Stop repeating `--project`/`--user`/filters: set them once and they apply to
+later commands as defaults (explicit flags always win; `--no-context` bypasses).
+
+```bash
+openproject context set --project webshop --assignee me
+openproject context show               # see the active defaults
+openproject wp list                    # behaves like: wp list --project webshop --assignee me
+openproject wp list --project other    # explicit flag wins
+openproject --no-context wp list       # ignore the context for one command
+
+openproject context save sprint        # name it, switch between saved contexts
+openproject context use sprint
+```
+
 On the **first interactive run** the CLI asks which default format you'd like and
 saves your choice. Non-interactive runs (pipes, CI, agents) never prompt — they
 default to `json`. Precedence: `--format`/`-f` → `-o/--output` → `$OPCLI_FORMAT`

{agent_tool_openproject_cli-0.2.1 → agent_tool_openproject_cli-0.3.0}/src/agent_tool_openproject_cli.egg-info/SOURCES.txt

@@ -27,6 +27,7 @@ src/opcli/commands/_shared.py
 src/opcli/commands/attachments.py
 src/opcli/commands/auth.py
 src/opcli/commands/comments.py
+src/opcli/commands/context.py
 src/opcli/commands/costs.py
 src/opcli/commands/custom_fields.py
 src/opcli/commands/filelinks.py
@@ -42,8 +43,10 @@ src/opcli/commands/users.py
 src/opcli/commands/wiki.py
 src/opcli/commands/workpackages.py
 tests/test_attachments.py
+tests/test_client_retry.py
 tests/test_comments.py
 tests/test_config_unit.py
+tests/test_context.py
 tests/test_cost.py
 tests/test_credentials_unit.py
 tests/test_guide_unit.py

{agent_tool_openproject_cli-0.2.1 → agent_tool_openproject_cli-0.3.0}/src/opcli/__init__.py

@@ -1,3 +1,3 @@
 """opcli — an agent-friendly command-line interface for OpenProject."""
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"