askpplx 1.2.1 → 1.3.0

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 +13 -4
  2. package/package.json +12 -12
package/README.md CHANGED
@@ -36,11 +36,20 @@ askpplx "What are breaking changes in React 19 that affect this code? $(cat src/
36
36
  Add this rule to your `CLAUDE.md` or `AGENTS.md` to enable automatic Perplexity lookups, no need to configure MCPs:
37
37
 
38
38
  ```markdown
39
- # Rule: askpplx CLI Usage
39
+ # Rule: `askpplx` CLI Usage
40
40
 
41
- Use `askpplx` to query Perplexity, an AI search engine combining real-time web search with advanced language models. Run it via `npx -y askpplx`.
41
+ **MANDATORY:** Run `npx -y askpplx --help` at the start of every agent session to learn available options and confirm the tool is working.
42
42
 
43
- Use concise prompts for quick facts and focused questions for deeper topics. If results are unexpected, refine your query and ask again.
43
+ Use `askpplx` to query Perplexity, an AI search engine combining real-time web search with advanced language models.
44
44
 
45
- Verification is fast and cheap, so prefer looking up information over making assumptions. Before first use, run `npx -y askpplx --help`.
45
+ ## Why This Matters
46
+
47
+ - **Ground your knowledge:** Your training data has a cutoff date. Real-time search ensures you work with current information—correct API signatures, latest versions, up-to-date best practices.
48
+ - **Save time and resources:** A quick lookup is far cheaper than debugging hallucinated code or explaining why an approach failed. When in doubt, verify first.
49
+ - **Reduce false confidence:** Even when you feel certain, external verification catches subtle errors before they compound into larger problems.
50
+ - **Stay current:** Libraries change, APIs deprecate, patterns evolve. What was correct six months ago may be wrong today.
51
+
52
+ ## Usage Guidelines
53
+
54
+ Use concise prompts for quick facts and focused questions for deeper topics. If results are unexpected, refine your query and ask again. Verification is fast and cheap—prefer looking up information over making assumptions.
46
55
  ```
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "askpplx",
3
3
  "author": "Łukasz Jerciński",
4
4
  "license": "MIT",
5
- "version": "1.2.1",
5
+ "version": "1.3.0",
6
6
  "description": "Minimal Unix-style CLI for querying Perplexity Sonar API.",
7
7
  "repository": {
8
8
  "type": "git",
@@ -36,26 +36,26 @@
36
36
  "fta:check": "fta-check"
37
37
  },
38
38
  "keywords": [],
39
- "packageManager": "pnpm@10.23.0+sha512.21c4e5698002ade97e4efe8b8b4a89a8de3c85a37919f957e7a0f30f38fbc5bbdd05980ffe29179b2fb6e6e691242e098d945d1601772cad0fef5fb6411e2a4b",
39
+ "packageManager": "pnpm@10.24.0",
40
40
  "engines": {
41
41
  "node": ">=22.14.0"
42
42
  },
43
43
  "dependencies": {
44
44
  "@ai-sdk/perplexity": "^2.0.21",
45
- "ai": "^5.0.106",
45
+ "ai": "^5.0.108",
46
46
  "commander": "^14.0.2",
47
47
  "conf": "^15.0.2",
48
48
  "zod": "^4.1.13"
49
49
  },
50
50
  "devDependencies": {
51
- "@commitlint/cli": "^20.1.0",
52
- "@commitlint/config-conventional": "^20.0.0",
53
- "@eslint/compat": "^1.4.1",
51
+ "@commitlint/cli": "^20.2.0",
52
+ "@commitlint/config-conventional": "^20.2.0",
53
+ "@eslint/compat": "^2.0.0",
54
54
  "@eslint/js": "^9.39.1",
55
55
  "@total-typescript/ts-reset": "^0.6.1",
56
56
  "@types/node": "^24.10.1",
57
- "@vitest/coverage-v8": "^3.2.4",
58
- "@vitest/eslint-plugin": "^1.4.4",
57
+ "@vitest/coverage-v8": "^4.0.15",
58
+ "@vitest/eslint-plugin": "^1.5.1",
59
59
  "eslint": "^9.39.1",
60
60
  "eslint-config-prettier": "^10.1.8",
61
61
  "eslint-plugin-unicorn": "^62.0.0",
@@ -63,11 +63,11 @@
63
63
  "fta-cli": "^3.0.0",
64
64
  "globals": "^16.5.0",
65
65
  "husky": "^9.1.7",
66
- "knip": "^5.70.1",
67
- "prettier": "3.6.2",
66
+ "knip": "^5.71.0",
67
+ "prettier": "3.7.4",
68
68
  "semantic-release": "^25.0.2",
69
69
  "typescript": "^5.9.3",
70
- "typescript-eslint": "^8.47.0",
71
- "vitest": "^3.2.4"
70
+ "typescript-eslint": "^8.48.1",
71
+ "vitest": "^4.0.15"
72
72
  }
73
73
  }