# CLI reference Install: `npm install -g funnelkeeper` (or `npx funnelkeeper …`). The binary is `fk`. Credentials live in `~/.config/funnelkeeper/config.json` (created `0600` by `fk login`). ## fk signup create a funnelkeeper account (sends a verification email). ``` fk signup ``` ``` fk signup ``` ## fk login sign in and store an api key in ~/.config/funnelkeeper (0600). ``` fk login [flags] ``` | Flag | Type | Required | Description | |---|---|---|---| | `--key` | boolean | no | paste an existing api key instead of using a password | | `--api-url` | string | no | api base url (default `https://funnelkeeper.fly.dev`) | ``` fk login ``` ``` fk login --key ``` ``` fk login --api-url http://localhost:3100 ``` ## fk logout delete the stored api key. ``` fk logout ``` ``` fk logout ``` ## fk account show the signed-in account. ``` fk account ``` ``` fk account ``` ## fk product create create a product in your account. ``` fk product create [flags] ``` | Flag | Type | Required | Description | |---|---|---|---| | `--name` | string | yes | display name | | `--slug` | string | yes | url-safe id (lowercase, hyphens) | | `--currency` | string | no | iso currency code (default `USD`) | | `--domain` | string | no | product domain | ``` fk product create --name "Demo" --slug demo --currency AUD ``` ## fk connect connect ga4 | gtm | google-ads (browser auth) or semrush (api key). ``` fk connect [flags] ``` | Flag | Type | Required | Description | |---|---|---|---| | `--product` | string | yes | product slug | ``` fk connect ga4 --product demo ``` ``` fk connect semrush --product demo ``` ## fk connect test verify a connected source can actually deliver data. ``` fk connect test [flags] ``` | Flag | Type | Required | Description | |---|---|---|---| | `--product` | string | yes | product slug | ``` fk connect test ga4 --product demo ``` ## fk status pipeline health: jobs, sources, queue backlog. ``` fk status ``` ``` fk status ``` ## fk portfolio one row per product: spend, revenue, cac, ltv:cac. ``` fk portfolio ``` ``` fk portfolio ``` ## fk queue list pending keeper cards. ``` fk queue list ``` ``` fk queue list ``` ## fk queue approve approve a card (asks for typed confirmation — this can move money). ``` fk queue approve ``` ``` fk queue approve 3f1c… ``` ## fk queue reject dismiss a card. ``` fk queue reject ``` ``` fk queue reject 3f1c… ``` ## fk queue snooze snooze a card. ``` fk queue snooze [flags] ``` | Flag | Type | Required | Description | |---|---|---|---| | `--hours` | number | no | snooze duration (default `24`) | ``` fk queue snooze 3f1c… --hours 48 ```