argorant 0.14.0 → 0.15.0

package/README.md

@@ -138,21 +138,33 @@ credits, `4` rate limit with the wait time in the message).
 
 ## Filters
 
-Combine free text with structured filters:
+Every filter-taking command (`count`, `search`, `reveal`, `export`, `list create`, `lists create`,
+`lists add`, `companies`, `company`, `campaigns leads add`) takes the same filters, with the same
+meaning as the app, the API and the Claude connector. Each list filter has an include flag and an
+exclude flag, and you can use both together. A comma means any of them.
 
 ```
---keywords --title --exclude-title --seniority --department --industry
---country --geography --state --city --company --domain
+--title / --exclude-title          --title-match words|exact|contains
+--keywords / --exclude-keywords    --keyword-scope company|people|any
+--industry / --exclude-industry    --country / --exclude-country (regions too)
+--state / --exclude-state          --city / --exclude-city
+--seniority / --exclude-seniority  --department / --exclude-department
+--domain / --exclude-domain        --company
+--employees, --employees-min, --employees-max
+--revenue, --revenue-min, --revenue-max
+--near <place id or lat,lon> --radius <n> [--radius-unit mi|km] [--radius-target person|company]
+--gender, --income                 (estimates; not for lending audiences)
 --has-phone --has-linkedin --has-email --verified-only
 ```
 
-`--keywords` is the widest, most reliable filter (comma = OR) - prefer it over
-`--industry`. `--country`/`--geography` accept regions (Europe, EMEA, DACH,
-Nordics, APAC, LATAM, GCC…).
+`--title-match words` (the default) matches whole words, so excluding "Data" does not drop
+"Database Administrator". `exact` matches the whole job title ("CEO" does not match
+"Founder & CEO"); `contains` matches the text anywhere. `--keyword-scope company` (the default)
+looks only at the company's tags, industry and description; `people` at the person's skills and
+profile text; `any` at both plus job title and company name.
 
-`--exclude-title` currently applies fully to `export` and `list create`; on
-`count`/`search`/`reveal` it's a platform-side gap and the CLI prints a note
-to stderr rather than silently dropping your filter.
+`argorant filters` lists every filter, its values and which filters can be used right now.
+A filter that is not ready yet is refused with a plain message, never ignored.
 
 Options: `-n/--limit`, `-o/--output`, `--json`, `-y/--yes`, `--base`,
 `--grade <valid|valid-plus-catchall>`.
@@ -252,10 +264,12 @@ npx argorant webhooks rm 3 --yes
 ```
 
 `credits buy` shows the quote first and only buys after a yes: at a terminal it asks, anywhere
-else it needs `--yes`. When your workspace saved its card for API and agent purchases and the
-purchase fits the limits you set in Settings, that card is charged right away. Otherwise you get a
-payment link to pay yourself, and the credits are added once the payment goes through.
-`--pay-with link` always gives the link. Bought credits stay valid for 365 days.
+else it needs `--yes`. An agent that runs the CLI for someone passes that person's own words with
+`--confirmation "yes, buy 5,000 credits"`; every purchase records how it was confirmed. When the
+account owner allowed purchases with the saved card in Settings > Billing (up to a monthly limit)
+and the purchase fits, that card is charged right away. Otherwise you get a payment link to pay
+yourself, and the credits are added once the payment goes through. `--pay-with link` always gives
+the link. Bought credits stay valid for 365 days.
 
 `lists rm` and `webhooks rm` work the same way: they ask at a terminal and need `--yes` anywhere
 else. A webhook's signing secret is shown once, when you add it.