podcast-guest-crm-cli 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +63 -0
  2. package/package.json +1 -1
package/README.md ADDED
@@ -0,0 +1,63 @@
1
+ # podcast-guest-crm-cli
2
+
3
+ Command-line client for [Podcast Guest CRM](https://github.com/RudrenduPaul/podcast-guest-crm): manage the guest lifecycle (discover, outreach, scheduled, recorded, published, follow_up), draft AI outreach emails, and pull pipeline analytics from your terminal or an agent. This package wraps the project's real Fastify API, no invented endpoints.
4
+
5
+ ![Login and first command](https://raw.githubusercontent.com/RudrenduPaul/podcast-guest-crm/main/docs/demo.gif)
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npm install -g podcast-guest-crm-cli
11
+ # or run without installing:
12
+ npx podcast-guest-crm-cli --help
13
+ ```
14
+
15
+ Python-first environments can `pip install podcast-guest-crm-cli` instead, a thin wrapper that shells out to this same package via `npx`.
16
+
17
+ ## Login
18
+
19
+ ```bash
20
+ podcast-guest-crm-cli login
21
+ ```
22
+
23
+ `login` authenticates directly against Supabase's own REST auth endpoint (`POST <SUPABASE_URL>/auth/v1/token?grant_type=password`), the same identity provider the web app uses. The resulting session is cached to `~/.config/podcast-guest-crm-cli/credentials.json` (permissions `0600`) and refreshed silently with the stored refresh token when it expires.
24
+
25
+ ## Commands
26
+
27
+ ```bash
28
+ podcast-guest-crm-cli guest list --stage published --limit 5
29
+ podcast-guest-crm-cli guest show <id>
30
+ podcast-guest-crm-cli guest add --name "Ada Lovelace" --email ada@example.com --title "Engineer" --company "Analytical Engines"
31
+ podcast-guest-crm-cli guest stage <id> outreach --reason "replied positively"
32
+ podcast-guest-crm-cli outreach draft <guestId> --episode-angle "AI safety"
33
+ podcast-guest-crm-cli analytics summary
34
+ podcast-guest-crm-cli analytics pipeline
35
+ ```
36
+
37
+ Add `--json` to any data-returning command for machine-readable output, meant for scripts and agents:
38
+
39
+ ```bash
40
+ podcast-guest-crm-cli guest list --stage discover --json
41
+ ```
42
+
43
+ ![CLI guest list and analytics summary](https://raw.githubusercontent.com/RudrenduPaul/podcast-guest-crm/main/docs/usage.gif)
44
+
45
+ ## FAQ
46
+
47
+ **What is this, and how is it different from calling the API directly?**
48
+ A typed CLI over the same Fastify API the web dashboard uses, with persistent login and a `--json` flag on every data command, so an agent or script can drive the guest pipeline without hand-rolling HTTP requests or a bearer token.
49
+
50
+ **Where are my credentials stored?**
51
+ `~/.config/podcast-guest-crm-cli/credentials.json`, file mode `0600`. Nothing is sent anywhere except Supabase's own auth endpoint and the API URL you configure.
52
+
53
+ **Does this work on Windows, macOS, and Linux?**
54
+ Yes. No compiled dependencies, pure Node 18+.
55
+
56
+ **What's the licensing situation?**
57
+ This CLI ships from the same repository as, and under the same license as, Podcast Guest CRM itself: proprietary, copyright Rudrendu Paul and Sourav Nandy. See [LICENSE](https://github.com/RudrenduPaul/podcast-guest-crm/blob/main/LICENSE).
58
+
59
+ See the [main README](https://github.com/RudrenduPaul/podcast-guest-crm#readme) for the full API reference and product FAQ.
60
+
61
+ ## License
62
+
63
+ Proprietary. See [LICENSE](https://github.com/RudrenduPaul/podcast-guest-crm/blob/main/LICENSE) in the parent repository for full terms.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "podcast-guest-crm-cli",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Command-line client for Podcast Guest CRM: manage the guest lifecycle (discover, outreach, scheduled, recorded, published, follow_up), draft AI outreach emails, and pull pipeline analytics from your terminal or an agent.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",