Befehlszeile (CLI)

curl -fsSL https://granttool.de/xapi2/cli/install.sh | bash

grantscli login --token pat_…

Help me write scripts using `grantscli`, the CLI for the Grants app.

Install:
  macOS/Linux:  curl -fsSL https://granttool.de/xapi2/cli/install.sh | bash
  Windows PS:   irm https://granttool.de/xapi2/cli/install.ps1 | iex

Sign in (required before any data command):
  grantscli login --token pat_…    # personal access token
  grantscli login                  # interactive (token or email + password)

Commands per model:
  grantscli derived_doc { list | get | create | update | delete | upsert }
    fields: --grant-id --kind --based-on-version --status --formats --latest-blob-id --latest-format
  grantscli feedback_item { list | get | create | update | delete | upsert }
    fields: --grant-id --source-type --who --subject --body --urgent --unread --status --due-date
  grantscli feedback_point { list | get | create | update | delete | upsert }
    fields: --grant-id --feedback-item-id --chapter-key --kind --excerpt --suggestion --applied --applied-at
  grantscli file { list | get | create | update | delete | upsert }
    fields: --name --kind --content --doc --grant-id --folder-id --is-root --blob-id --mime-type --size-bytes --sort-order --chapter-type --chapter-answers --ai-messages --import-status --import-gaps --import-at
  grantscli folder { list | get | create | update | delete | upsert }
    fields: --name --grant-id --parent-folder-id --sort-order
  grantscli grant { list | get | create | update | delete | upsert }
    fields: --grant-type-key --title --description --funder --program --deadline --requested-amount --currency --status --compiler --root-file-id --tags --notes --color --intake-blob-id --intake-url --intake-extracted --import-status --import-started-at --import-finished-at --intake-extracted-by-source --intake-sources --awarded-amount --awarded-at --profile --team-size --baseline-score
  grantscli lead { list | get | create | update | delete | upsert }
    fields: --first-name --last-name --gender --company --position --fair-location --phone --email --linkedin --website --city --country --lead-status --note --tags --inferred-gender --inferred-country --inferred-domain --account-id --lead-source-id --last-contacted-at
  grantscli loi { list | get | create | update | delete | upsert }
    fields: --grant-id --lead-id --partner-id --status --scope-months --exclusive --body --blob-id
  grantscli review_note { list | get | create | update | delete | upsert }
    fields: --grant-id --chapter-key --who --role --body --resolved --resolved-at
  grantscli version_snapshot { list | get | create | update | delete | upsert }
    fields: --grant-id --label --score --summary --snapshot --feedback-trigger --derived-keys

Output + flags:
  - stdout is JSON (one object, or {data:[...], meta:{...}} on list).
  - errors go to stderr; non-zero exit (3=auth, 5=not found, 6=validation, 7=conflict, 8=rate-limited).
  - --filter name=Foo (friendly key, repeatable) on `list`.
  - --all auto-paginates; --fields id,name projects; --cache N caches list/get for N s.
  - writes accept --json '{...}', --file path.json (arrays = bulk), --stdin, or --csv path [--map k=COL,…].
  - upsert needs --unique <field>; --dry-run previews any write.
  - --retry N --backoff exp survives 429/5xx; --stderr-json gives machine-readable errors.

Field schemas + constraints per model: https://granttool.de/docs/types/<model>
Full CLI reference:                    https://granttool.de/docs/cli

Task: <describe what you want to do>

grantscli login --token pat_…
grantscli whoami

# items.csv has columns: grant_id,Full Name,status
# --map renames CSV headers to API field names; missing cells skipped.
grantscli derived_doc create \
    --csv items.csv \
    --map name=Full Name \
    --continue-on-error \
    --retry 3 --backoff exp