salesprompter-cli 0.1.3 → 0.1.4

package/README.md

@@ -12,6 +12,59 @@
 - Analyze upstream lead-list and domain-enrichment bottlenecks
 - Replace opaque Pipedream logic with deterministic CLI workflows
 
+It is built for two users at the same time:
+
+- humans working in a terminal
+- coding agents such as Codex, Claude Code, and other LLM-driven shell workflows
+
+## Start Here
+
+If someone discovers Salesprompter from a vague prompt, the first thing they need is the shortest working path.
+
+```bash
+npx salesprompter-cli@latest --help
+```
+
+Or install it globally:
+
+```bash
+npm install -g salesprompter-cli
+salesprompter --help
+```
+
+## Prompt To Command
+
+If the user says something like "I need to determine the ICP of deel.com", there are two different meanings.
+
+### 1. They want leads at Deel itself
+
+This means Deel is the target account.
+
+```bash
+salesprompter account:resolve --domain deel.com --company-name Deel --out ./data/deel-account.json
+salesprompter leads:generate --icp ./data/icp.json --count 5 --domain deel.com --company-name Deel --out ./data/deel-leads.json
+```
+
+### 2. They sell for Deel and need Deel's ideal customer profile
+
+This means Deel is the vendor, not the target account.
+
+```bash
+salesprompter icp:vendor --vendor deel --market dach --out ./data/deel-icp.json
+salesprompter leads:lookup:bq --icp ./data/deel-icp.json --limit 100 --execute --out ./data/deel-leads-raw.json --lead-out ./data/deel-leads.json
+salesprompter leads:enrich --in ./data/deel-leads.json --out ./data/deel-enriched.json
+salesprompter leads:score --icp ./data/deel-icp.json --in ./data/deel-enriched.json --out ./data/deel-scored.json
+```
+
+### 3. They want the LLM to call the CLI directly
+
+Use the same commands, but prefer machine-readable output:
+
+```bash
+salesprompter --json icp:vendor --vendor deel --market dach --out ./data/deel-icp.json
+salesprompter --json leads:lookup:bq --icp ./data/deel-icp.json --limit 100 --lead-out ./data/deel-leads.json
+```
+
 ## Documentation
 
 This repository now includes a Mintlify docs site for the wider Salesprompter universe, including the app contract, CLI surface, Chrome extension contract, and the main warehouse-backed workflows.
@@ -24,6 +77,8 @@ This repository now includes a Mintlify docs site for the wider Salesprompter un
 - Chrome extension: `./platform/chrome-extension.mdx`
 - Domain finder: `./workflows/domain-finder.mdx`
 - Command reference: `./reference/cli.mdx`
+- Environment variables: `./reference/environment-variables.mdx`
+- Troubleshooting: `./operations/troubleshooting.mdx`
 
 Run the docs locally with:
 
@@ -94,6 +149,7 @@ salesprompter auth:login --token "<token-from-app>" --api-url "https://salesprom
 
 - Every command reads and writes plain JSON.
 - Output is machine-readable and composable (`--json` for compact transport).
+- The top-level use cases map ambiguous prompts like "determine the ICP of deel.com" into explicit command paths.
 - Domain contracts are explicit and validated with `zod`.
 - External integrations are behind narrow provider interfaces.
 - Lead generation reports which provider and mode produced the result.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.3",
-  "description": "CLI for defining ICPs, generating leads, enriching them, scoring them, and syncing to GTM tools.",
+  "version": "0.1.4",
+  "description": "JSON-first sales prospecting CLI for ICP definition, lead generation, enrichment, scoring, and CRM/outreach sync.",
   "type": "module",
   "bin": {
     "salesprompter": "dist/cli.js"
@@ -13,19 +13,39 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc --noEmit -p tsconfig.json",
-    "docs:dev": "npx mint dev",
-    "docs:broken-links": "npx mint broken-links",
-    "docs:a11y": "npx mint a11y",
+    "docs:dev": "mint dev",
+    "docs:broken-links": "mint broken-links",
+    "docs:a11y": "mint a11y",
     "start": "node ./dist/cli.js",
     "test": "npm run build && tsc -p tsconfig.test.json && node --test dist-tests/tests/**/*.test.js"
   },
   "keywords": [
     "sales",
+    "salesprompter",
     "cli",
+    "icp",
+    "ideal-customer-profile",
+    "prospecting",
     "lead-generation",
+    "lead-enrichment",
+    "lead-scoring",
+    "sales-intelligence",
     "crm",
-    "outreach"
+    "outreach",
+    "instantly",
+    "hubspot",
+    "llm",
+    "ai-agent",
+    "codex"
   ],
+  "homepage": "https://salesprompter.ai/docs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danielsinewe/salesprompter-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/danielsinewe/salesprompter-cli/issues"
+  },
   "license": "MIT",
   "dependencies": {
     "commander": "^14.0.1",
@@ -33,6 +53,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
+    "mint": "^4.2.420",
     "typescript": "^5.9.2"
   }
 }