公开记录中等
软件健康报告模式 0.23.0 · 指标 1.13.0 · 2026-07-21 21:11 UTC
jacob-bd / perplexity-web-mcp
MCP server and Anthropic API-compatible interface for Perplexity AI web interface
jacob-bd/perplexity-web-mcp 的健康指数为 100 分中的 60 分，处于「中等」区间。 其得分最高的类别是Vitality（82/100），最低的是Security（27/100）。 最近一次更新在今天。 近期的大部分工作由 1 位贡献者完成。
60
总分 / 100软件健康指数
指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 49（有风险）的上限。AI 就绪度不计入总体分。
60
优秀85-100堪称典范；基本满足所有检验标准
良好70-84健康；仅有轻微不足
中等50-69可接受，但存在明显不足；建议进行审查
存在风险30-49存在重大薄弱环节；采用时应保持审慎
危急1-29问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
评分画像
每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。
所有权
软件包生态系统
| 注册表 | 软件包 | 版本 | 月下载量 | 版本数 | 最近发布 | 标签 |
|---|---|---|---|---|---|---|
| PyPI | perplexity-web-mcp-cli | 0.14.2 | 1,799 | 45 | 6 天前 | perplexityaimcpanthropicapiclient |
按类别列示的指标
活力
项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？
82
开发活跃度
76良好
评分方式
| 36/36 | 推送新近度 — 最近一次推送于 0 天前 |
| 12.5/36 | 提交节奏 — 52 周中有 18 周有提交 |
| 18/18 | 提交量 — 最近一年 148 次提交 |
| 10/10 | OpenSSF Scorecard：Maintained — 30 commit(s) and 13 issue activity found in the last 90 days -- score normalized to 10 |
所用输入
| commits_last_year | 148 |
| human_commit_share | 1 |
| days_since_last_push | 0 |
| active_weeks_last_year | 18 |
发布纪律
90优秀
评分方式
| 27/27 | 有发布版本 — 已发布 47 个发布版本 |
| 36/36 | 发布时效 — 最近一次发布版本于 6 天前 |
| 27/27 | 发布节奏 — 约每 7.3 天发布一次 |
| 0/10 | OpenSSF Scorecard：Signed-Releases — Project has not signed or included provenance with any releases. |
所用输入
| releases_count | 47 |
| latest_release_tag | v0.14.2 |
| releases_from_tags | 否 |
| days_since_latest_release | 6 |
| mean_days_between_releases | 7.3 |
社区与采用
项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？
49
流行度与采用
46存在风险
评分方式
| 35.2/60 | 星标 — 149 个星标 |
| 10.8/25 | 复刻 — 21 个复刻 |
| 0/15 | 关注者 — 2 位关注者 |
所用输入
| forks | 21 |
| stars | 149 |
| watchers | 2 |
| growth_state | organic |
| growth_factor_pct | 100 |
社区健康
50中等
评分方式
| 22.5/22.5 | README |
| 22.5/22.5 | 许可证 — 可识别的许可证（MIT） |
| 0/18 | CONTRIBUTING 指南 |
| 0/13.5 | 行为准则 |
| 0/7.2 | 议题模板 |
| 0/6.3 | PR 模板 |
所用输入
| has_readme | 是 |
| has_license | 是 |
| has_contributing | 否 |
| has_issue_template | 否 |
| has_code_of_conduct | 否 |
| has_pull_request_template | 否 |
生态采用（下载量）
54中等
评分方式
| 43.4/80 | 月度下载量 — pypi 合计每月 1,799 次下载 |
| 0/20 | 注册表被依赖数 — 该生态系统不报告此项 |
所用输入
| packages | perplexity-web-mcp-cli |
| dependents | — |
| ecosystems | pypi |
| total_downloads | — |
| monthly_downloads | 1,799 |
已排除计分（无数据或不适用）：注册表被依赖数。 其余权重已重新归一化。
可持续性与治理
项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？
60
维护者韧性（巴士系数）
10危急
评分方式
| 9/54 | 巴士系数 — 1 位贡献者贡献了半数提交 |
| 0/22.5 | 提交分布 — 头号贡献者编写了 100% 的提交 |
| 1.4/13.5 | 贡献者广度 — 1 位贡献者 |
| 0/10 | OpenSSF Scorecard：Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
所用输入
| bus_factor | 1 |
| contributors_sampled | 1 |
| top_contributor_share | 1 |
议题与 PR 响应能力
85优秀
评分方式
| 46.8/46.8 | 议题解决 — 100% 的议题已关闭 |
| 38.2/38.3 | PR 接受 — 已裁定的 PR 中 2/2 已合并 |
| 0/15 | OpenSSF Scorecard：Code-Review — Found 1/30 approved changesets -- score normalized to 0 |
所用输入
| merged_prs | 2 |
| open_issues | 0 |
| closed_issues | 14 |
| issue_closed_ratio | 1 |
| closed_unmerged_prs | 0 |
所有权与托管责任
62中等
评分方式
| 10/30 | 所有权背书 — 个人（用户）账户 |
| 0/20 | 已验证域名 — 不适用于个人账户 |
| 18.2/25 | 所有者影响力 — jacob-bd 有 336 位关注者 |
| 21.5/25 | 既往记录 — 19 个公开仓库，账户约 7 年 |
所用输入
| followers | 336 |
| owner_type | User |
| is_verified | — |
| owner_login | jacob-bd |
| public_repos | 19 |
| account_age_days | 2,714 |
已排除计分（无数据或不适用）：已验证域名。 其余权重已重新归一化。
软件包维护
100优秀
评分方式
| 25/25 | 已发布且可解析 — pypi 上有 1 个软件包 |
| 35/35 | 发布时效 — 最近一次发布于 6 天前 |
| 20/20 | 版本历史 — 45 个已发布版本 |
| 20/20 | 未被弃用 — 活跃，未被弃用或撤回 |
所用输入
| packages | perplexity-web-mcp-cli |
| ecosystems | pypi |
| any_deprecated | 否 |
| min_days_since_publish | 6 |
工程质量
基础的工程与文档实践是否到位？
70
工程实践
74良好
评分方式
| 24/24 | CI 工作流 — 2 个工作流 |
| 24/24 | 存在测试 |
| 16/16 | Linter 配置 |
| 9.6/9.6 | Pre-commit 钩子 |
| 0/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard：CI-Tests — 0 out of 1 merged PRs checked by a CI test -- score normalized to 0 |
所用输入
| has_ci | 是 |
| has_tests | 是 |
| has_editorconfig | 否 |
| has_linter_config | 是 |
| has_precommit_config | 是 |
文档
65中等
评分方式
| 30/30 | README |
| 25/25 | 文档目录 |
| 0/15 | 文档 / 主页站点 |
| 10/10 | 仓库描述 |
| 0/10 | 主题标签 |
| 0/10 | Wiki |
所用输入
| topics | — |
| has_wiki | 否 |
| homepage | — |
| has_readme | 是 |
| has_docs_dir | 是 |
| has_description | 是 |
安全
可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？
27
安全态势
27危急
评分方式
| 0/7.5 | Binary-Artifacts — binaries present in source code |
| 0/7.5 | Branch-Protection — branch protection not enabled on development/release branches |
| 0/2.5 | CI-Tests — 0 out of 1 merged PRs checked by a CI test -- score normalized to 0 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 1/30 approved changesets -- score normalized to 0 |
| 0/2.5 | Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | 许可证 — license file detected |
| 7.5/7.5 | Maintained — 30 commit(s) and 13 issue activity found in the last 90 days -- score normalized to 10 |
| 0/5 | Packaging — 无数据 |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 0/5 | Security-Policy — security policy file not detected |
| 0/7.5 | Signed-Releases — Project has not signed or included provenance with any releases. |
| 6.8/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 48 existing vulnerabilities detected |
所用输入
| source | openssf_scorecard |
| checks_evaluated | 17 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 1 |
| scorecard_aggregate | 2.7 |
已排除计分（无数据或不适用）：packaging。 其余权重已重新归一化。
AI 就绪度
该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？这是一枚独立的实验性徽章——权重为 0.0，因此单独呈现，不影响总体健康评分。
72
AI 代理上下文与指引
85优秀
评分方式
| 45/45 | 代理指令 — AGENTS.md, CLAUDE.md |
| 0/15 | 机器可读文档（llms.txt） |
| 40/40 | 可读的提交历史 — 100 次人类提交中有 89 次说明了意图（结构化标题或解释性正文） |
所用输入
| has_llms_txt | 否 |
| legible_history_share | 0.89 |
| agent_instruction_files | AGENTS.md, CLAUDE.md |
| agent_instruction_max_bytes | 3,987 |
评分方式
| 18/18 | 一条命令的引导启动 — Justfile |
| 22/22 | 自动化测试 |
| 11/11 | Lint / 格式化配置 |
| 11/11 | 静态类型检查 — pyrightconfig.json, src/perplexity_web_mcp/py.typed |
| 10/10 | 可复现环境 — lockfile |
| 10/10 | 已体现的代理实践 — 最近 100 次提交中有 19 次由代理编写或署名代理 |
| 0/8 | 自动化维护 — 未观察到自动依赖更新 |
| 0/10 | OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
所用输入
| has_nix | 否 |
| has_tests | 是 |
| lockfiles | uv.lock |
| has_dockerfile | 否 |
| typed_language | 否 |
| bootstrap_files | Justfile |
| has_devcontainer | 否 |
| has_linter_config | 是 |
| typecheck_configs | pyrightconfig.json, src/perplexity_web_mcp/py.typed |
| agent_commit_share | 0.19 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
面向模型的代码可读性
71良好
评分方式
| 27/45 | 可类型检查的代码 — JavaScript，已配置类型检查（pyrightconfig.json, src/perplexity_web_mcp/py.typed） |
| 43.7/55 | 可控的文件大小 — 采样的 1,966 个源文件中有 404 个超过 60KB |
所用输入
| primary_language | JavaScript |
| largest_source_bytes | 4,197,994 |
| source_files_sampled | 1,966 |
| oversized_source_files | 404 |
机器可读接口
20危急
评分方式
| 0/40 | API 模式（OpenAPI/GraphQL/proto） |
| 20/20 | MCP 服务器 |
| 0/40 | 可运行示例 |
所用输入
| example_dirs | — |
| has_mcp_signal | 是 |
| api_schema_files | — |
关键数据
149GitHub 星标
1贡献者
148最近 12 个月提交数
0距最近推送天数
47发布版本数
1巴士系数（bus factor）
0开放议题
PyPI软件包生态系统数
数据采集警告
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
- deps.dev does not index pypi:perplexity-web-mcp-cli@0.14.2; advisories assessed against the repository dependency graph instead
更多细节
Star 与 Fork 历史 149 ★ / 21 ⇿
149Star
21Fork
21发布
每颗 star 和每个 fork 的添加时间，来自 GitHub 并按天汇总。累计增长位于其构成来源——每日新增——的正上方，二者可相互对照：稳定的自然增长与短暂的突增形态截然不同。当这一差别可被衡量时，它会作为增长真实性予以报告。
主版本 0次版本 5修订 16
OpenSSF Scorecard 2.7 / 10
2.7综合
来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。
| 0 | Binary-Artifacts | binaries present in source code |
| 0 | Branch-Protection | branch protection not enabled on development/release branches |
| 0 | CI-Tests | 0 out of 1 merged PRs checked by a CI test -- score normalized to 0 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 1/30 approved changesets -- score normalized to 0 |
| 0 | Contributors | project has 0 contributing companies or organizations -- score normalized to 0 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 30 commit(s) and 13 issue activity found in the last 90 days -- score normalized to 10 |
| 不适用 | Packaging | packaging workflow not detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 0 | Security-Policy | security policy file not detected |
| 0 | Signed-Releases | Project has not signed or included provenance with any releases. |
| 9 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 48 existing vulnerabilities detected |
直接依赖 13
| 注册表 | 软件包 | 版本约束 | 清单文件 |
|---|---|---|---|
| PyPI | curl-cffi | >=0.15.0,<1.0 | pyproject.toml |
| PyPI | loguru | >=0.7.3,<1.0 | pyproject.toml |
| PyPI | orjson | >=3.11.6,<4.0 | pyproject.toml |
| PyPI | pydantic | >=2.12.5,<3.0 | pyproject.toml |
| PyPI | tenacity | >=9.1.2,<10.0 | pyproject.toml |
| PyPI | tomli | >=2.0.0,<3.0 | pyproject.toml |
| PyPI | python-dotenv | >=1.0.0,<2.0 | pyproject.toml |
| PyPI | rich | >=13.0.0,<15.0 | pyproject.toml |
| PyPI | rich-click | >=1.8 | pyproject.toml |
| PyPI | fastmcp | >=2.14.4,<3.0 | pyproject.toml |
| PyPI | fastapi | >=0.115.0,<1.0 | pyproject.toml |
| PyPI | uvicorn | >=0.30.0,<1.0 | pyproject.toml |
| PyPI | httpx | >=0.27.0,<1.0 | pyproject.toml |
全部依赖 未采集
本报告未能采集到解析后的依赖集合：GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
原始 JSON 报告 机器可读
{
"data": {
"repo": {
"topics": [],
"is_fork": false,
"size_kb": 156396,
"has_wiki": false,
"homepage": null,
"languages": {
"CSS": 16550,
"HTML": 9096,
"Just": 290,
"Python": 655895,
"PureBasic": 3236,
"JavaScript": 14792718
},
"pushed_at": "2026-07-21T21:06:58Z",
"created_at": "2026-02-04T01:26:17Z",
"owner_type": "User",
"updated_at": "2026-07-21T21:07:19Z",
"description": "MCP server and Anthropic API-compatible interface for Perplexity AI web interface",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "JavaScript",
"significant_languages": [
"JavaScript"
]
},
"owner": {
"blog": "https://t.me/genaispot",
"name": "Jacob BD",
"type": "User",
"login": "jacob-bd",
"company": null,
"location": "Toronto, ON, Canada",
"followers": 336,
"avatar_url": "https://avatars.githubusercontent.com/u/47641890?v=4",
"created_at": "2019-02-14T18:22:29Z",
"is_verified": null,
"public_repos": 19,
"account_age_days": 2714
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v0.14.2",
"kind": "patch",
"published_at": "2026-07-15T02:37:25Z"
},
{
"tag": "v0.14.1",
"kind": "patch",
"published_at": "2026-07-07T21:01:56Z"
},
{
"tag": "v0.14.0",
"kind": "minor",
"published_at": "2026-07-03T19:24:37Z"
},
{
"tag": "v0.13.0",
"kind": "minor",
"published_at": "2026-06-29T21:53:03Z"
},
{
"tag": "v0.12.4",
"kind": "patch",
"published_at": "2026-06-14T20:11:38Z"
},
{
"tag": "v0.12.3",
"kind": "patch",
"published_at": "2026-06-14T14:33:37Z"
},
{
"tag": "v0.12.2",
"kind": "patch",
"published_at": "2026-06-10T14:28:56Z"
},
{
"tag": "v0.12.1",
"kind": "patch",
"published_at": "2026-05-22T20:13:55Z"
},
{
"tag": "v0.12.0",
"kind": "minor",
"published_at": "2026-05-17T18:25:06Z"
},
{
"tag": "v0.11.2",
"kind": "patch",
"published_at": "2026-05-09T23:39:10Z"
},
{
"tag": "v0.11.1",
"kind": "patch",
"published_at": "2026-05-09T21:54:59Z"
},
{
"tag": "v0.11.0",
"kind": "minor",
"published_at": "2026-05-09T21:44:44Z"
},
{
"tag": "v0.10.8",
"kind": "patch",
"published_at": "2026-05-08T00:52:12Z"
},
{
"tag": "v0.10.7",
"kind": "patch",
"published_at": "2026-04-27T19:15:38Z"
},
{
"tag": "v0.10.6",
"kind": "patch",
"published_at": "2026-04-26T16:53:43Z"
},
{
"tag": "v0.10.5",
"kind": "patch",
"published_at": "2026-04-23T02:11:01Z"
},
{
"tag": "v0.10.4",
"kind": "patch",
"published_at": "2026-04-22T21:16:39Z"
},
{
"tag": "v0.10.3",
"kind": "patch",
"published_at": "2026-04-21T21:23:39Z"
},
{
"tag": "v0.10.2",
"kind": "patch",
"published_at": "2026-04-14T20:13:16Z"
},
{
"tag": "v0.10.1",
"kind": "patch",
"published_at": "2026-04-14T17:44:32Z"
},
{
"tag": "v0.10.0",
"kind": "minor",
"published_at": "2026-03-21T20:19:43Z"
},
{
"tag": "v0.9.5",
"kind": "patch",
"published_at": "2026-03-16T18:21:11Z"
},
{
"tag": "v0.9.4",
"kind": "patch",
"published_at": "2026-03-14T23:44:50Z"
},
{
"tag": "v0.9.3",
"kind": "patch",
"published_at": "2026-03-13T22:02:20Z"
},
{
"tag": "v0.9.2",
"kind": "patch",
"published_at": "2026-03-12T19:23:23Z"
},
{
"tag": "v0.9.1",
"kind": "patch",
"published_at": "2026-03-12T01:54:04Z"
},
{
"tag": "v0.9.0",
"kind": "minor",
"published_at": "2026-03-11T16:38:01Z"
},
{
"tag": "v0.8.3",
"kind": "patch",
"published_at": "2026-03-08T18:34:44Z"
},
{
"tag": "v0.8.2",
"kind": "patch",
"published_at": "2026-03-05T23:03:33Z"
},
{
"tag": "v0.8.1",
"kind": "patch",
"published_at": "2026-03-05T21:12:26Z"
},
{
"tag": "v0.8.0",
"kind": "minor",
"published_at": "2026-03-05T20:44:26Z"
},
{
"tag": "v0.7.2",
"kind": "patch",
"published_at": "2026-03-01T19:17:40Z"
},
{
"tag": "v0.7.1",
"kind": "patch",
"published_at": "2026-02-25T16:57:49Z"
},
{
"tag": "v0.7.0",
"kind": "minor",
"published_at": "2026-02-25T04:34:12Z"
},
{
"tag": "v0.6.0",
"kind": "minor",
"published_at": "2026-02-20T04:27:19Z"
},
{
"tag": "v0.5.9",
"kind": "patch",
"published_at": "2026-02-20T03:34:25Z"
},
{
"tag": "v0.5.8",
"kind": "patch",
"published_at": "2026-02-20T02:10:12Z"
},
{
"tag": "v0.5.7",
"kind": "patch",
"published_at": "2026-02-20T02:02:05Z"
},
{
"tag": "v0.5.6",
"kind": "patch",
"published_at": "2026-02-20T00:48:26Z"
},
{
"tag": "v0.5.5",
"kind": "patch",
"published_at": "2026-02-18T00:50:54Z"
},
{
"tag": "v0.5.4",
"kind": "patch",
"published_at": "2026-02-16T22:38:15Z"
},
{
"tag": "v0.5.3",
"kind": "patch",
"published_at": "2026-02-16T22:13:20Z"
},
{
"tag": "v0.5.2",
"kind": "patch",
"published_at": "2026-02-16T21:49:00Z"
},
{
"tag": "v0.5.1",
"kind": "patch",
"published_at": "2026-02-16T21:40:28Z"
},
{
"tag": "v0.5.0",
"kind": "minor",
"published_at": "2026-02-16T21:33:31Z"
},
{
"tag": "v0.4.1",
"kind": "patch",
"published_at": "2026-02-16T21:21:40Z"
},
{
"tag": "v0.4.0",
"kind": "minor",
"published_at": "2026-02-16T21:12:40Z"
}
],
"recent_commits": [
{
"oid": "480920557fe16eda4173e6cf0a4bf8fa96d57362",
"body": null,
"is_bot": false,
"headline": "Pin setup-uv action release",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-21T21:06:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "26bb51674a3a445c9ce24c4483dfcb1299f09104",
"body": null,
"is_bot": false,
"headline": "Stabilize CI environment checks",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-21T21:06:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e23d5c098d974f183613b7f4d2f8d93d70381e68",
"body": null,
"is_bot": false,
"headline": "Fix authentication and add CI",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-21T21:02:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8393214e56fe9f0de593e7ef588b0818b6759dbf",
"body": null,
"is_bot": false,
"headline": "Fix Cloudflare 403 headers and add library toggle (#15)",
"author_name": "Vitamin4107",
"author_login": "Vitamin4107",
"committed_at": "2026-07-21T20:53:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "93cf577cfea208b621555927035ed294f6d5b8d6",
"body": null,
"is_bot": false,
"headline": "chore: release 0.14.2",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-15T02:36:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c8f4f6e28d5f1d5353fff5fb7e1f5d342190ab5a",
"body": null,
"is_bot": false,
"headline": "minor readme update",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-15T01:56:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ac9b85c2381336a5400b92a1a2a36829992a809f",
"body": null,
"is_bot": false,
"headline": "docs: plan model roster sync",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-15T01:55:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "866bfe795b08d154e242c1561ad73ff1c3d5c1c5",
"body": null,
"is_bot": false,
"headline": "docs: design strict model roster sync",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-15T01:40:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ed38b5d9a4641cec104f99bb6f717cee80dd926c",
"body": null,
"is_bot": false,
"headline": "chore: release 0.14.1",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-07T21:01:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ce27c3896e9ec9e801bc81b8c3d9eed09f109c99",
"body": "- Catch SourceResolutionError in pplx_council and return formatted string\n- Validate source_focus in pplx_deep_research_start before spawning thread\n- Exclude builtin sources from connector listing via get_connector_sources()\n- Deduplicate connector filter into shared get_connector_sources() helper\n- Fix whitespace-only source_focus defaulting to web instead of raising\n- Tighten connector ID regex to reject trailing underscores\n- Check _BUILTIN_SOURCE_IDS and regex before blocking network call",
"is_bot": false,
"headline": "fix: connector source routing edge cases",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-03T17:56:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "06c8fb7c8b6f518a4355b50a8b6e782973582c73",
"body": null,
"is_bot": false,
"headline": "chore: prepare 0.14.0 release",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-03T00:21:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b83ec56dff356dcdd6d3a0eeed0f302bcd5cdd99",
"body": null,
"is_bot": false,
"headline": "merge: connector source routing",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-03T00:17:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "111f2da1c91ddc8055cd48db0828251319bd77c1",
"body": null,
"is_bot": false,
"headline": "chore: format cli imports",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:20:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ae7af5e9dd8cdd5193dd3cb9e48d4f1d7ad612be",
"body": null,
"is_bot": false,
"headline": "docs: document connector source routing",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:18:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6d3db0293f8c8a0d14a334a0e5f1ea4a6080b689",
"body": null,
"is_bot": false,
"headline": "feat: expose connector source ids to mcp clients",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:15:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8ee387e12ae2ee01b37807bcfe254b080d95744e",
"body": null,
"is_bot": false,
"headline": "feat: list and validate connector sources",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:14:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2c9862de2a72e66e37f00727ad948b8cc1b1eed9",
"body": null,
"is_bot": false,
"headline": "feat: route council through connector sources",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:12:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c65cacf00e128001d7a90e75161adc15957893c0",
"body": null,
"is_bot": false,
"headline": "feat: pass connector source ids in query payload",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:12:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d7e772c48147cda1f11fbd4ffe6553d70ee694a8",
"body": null,
"is_bot": false,
"headline": "feat: resolve connector source ids",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:11:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0b15ada012d110b7bbbf6cb2c7811fee74e205fe",
"body": null,
"is_bot": false,
"headline": "feat: align Perplexity search models",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-07-02T23:09:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fe562c6b613f33ee644b0db7fede26076472c949",
"body": "… models (v0.13.0)",
"is_bot": false,
"headline": "feat: Add thread library CLI and MCP tools, switch to strict Pydantic…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-29T21:52:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "77c512485639f25b375a3f10d27267bb5c6c29f9",
"body": null,
"is_bot": false,
"headline": "chore: release 0.12.5 and fix CI formatting",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-26T00:00:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "eedf6d9b049aadc47b69987407e30c8c4e491c01",
"body": null,
"is_bot": false,
"headline": "Fix antigravity MCP config path and test mapping (#11)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-25T22:51:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "03596d9d76e7a4e2a2298afe23e8b5a4291a60b2",
"body": null,
"is_bot": false,
"headline": "chore: release 0.12.4 — doctor connectivity check",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-14T20:10:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b830c79328e13e21ced32b603af94b518cc28aa5",
"body": "Tests /search/new before declaring the installation healthy.\nSurfaces 403s caused by VPN/proxy interference that auth checks miss.\nRefactors cmd_doctor into section helpers to stay under lint limits.",
"is_bot": false,
"headline": "fix: add connectivity check to pwm doctor",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-14T20:10:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "47d16f8c45f21b0ecd54e34aab68e6bfae7f4370",
"body": "Nemotron 3 Ultra has replaced Nemotron 3 Super in Perplexity's model roster.\nRetains Super identifier in models.py for reference.",
"is_bot": false,
"headline": "feat: upgrade nemotron to Nemotron 3 Ultra 550B (nv_nemotron_3_ultra)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-14T14:32:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2a2b528d88b5ea5998562163bfb62239e99816fa",
"body": "…odel snapshot",
"is_bot": false,
"headline": "docs: update all references from Claude Opus 4.7 to 4.8 and refresh m…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-14T14:27:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7c88107a22e12aee3982f4daa936cb180d29ec82",
"body": null,
"is_bot": false,
"headline": "chore: release 0.12.3 — Claude Opus 4.8 and ask command fix",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-14T14:24:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6167883a9a257ff5821f3fa25072cd430b8c8be2",
"body": "…sion\n\nrich_click 1.9.8 stopped stripping the _cmd suffix from function names\nwhen deriving CLI command names, causing pwm ask to appear as pwm ask-cmd.",
"is_bot": false,
"headline": "fix: pin ask command name explicitly to avoid rich_click 1.9.8 regres…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-14T14:14:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "160ff1c993e78e762a4a00c61d634bd641faa76e",
"body": "…heck",
"is_bot": false,
"headline": "style: wrap long line in ai_doc.py to satisfy ruff E501 line length c…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-10T14:14:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "db07708946528420875f00a03302bdaf72763393",
"body": "…mentation to v0.12.2",
"is_bot": false,
"headline": "fix: resolve Sonar 2 fallback grounding issues and update skills/docu…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-10T14:01:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "155c3b904570054bef558f2debde9c997e9d174b",
"body": null,
"is_bot": false,
"headline": "docs: add PyPI and Buy Me a Coffee badges",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-06-08T21:47:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5ffd6d5e0223e65f9f0362ccff4665c1c1f4d0bf",
"body": null,
"is_bot": false,
"headline": "chore: release 0.12.1",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-22T20:12:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3468b578e748e63d7164aa15217b027044f7386c",
"body": "…pport, test fixes",
"is_bot": false,
"headline": "chore: release 0.12.0 — council model roster unification, kimi_k26 su…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-17T18:24:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2fa27282c440989d2d418e80c15e06caa2fc3a66",
"body": "…able as council member",
"is_bot": false,
"headline": "fix: derive COUNCIL_MODEL_NAMES from MODEL_NAMES so kimi_k26 is avail…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-17T18:24:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "29a1677640b5445d34731e2e53e1f92ea760afda",
"body": "Fix false-negative tool detection in `pwm skill install all` by replacing\nthe old directory-content heuristic with a two-signal check (binary on PATH\nor root config dir exists). Add Hermes Agent (NousResearch) as a supported\nskill platform. Verified OpenCode uses ~/.config/opencode on both macOS and\nWindows via live SSH check. 11 new unit tests.\n\nCo-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "chore: release 0.11.3 — fix skill detection, add Hermes Agent support",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-12T01:05:28Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "d1afb83c889416ee9e78567e2f4b324bbb9c83bc",
"body": "…ase v0.11.2",
"is_bot": false,
"headline": "feat: implement /v1/responses fallback for Codex CLI support and rele…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T23:38:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cf641eb8e4bb8f907bb8fb661d500f10f7de11c3",
"body": null,
"is_bot": false,
"headline": "chore: release 0.11.1 with refactoring cleanup",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T21:54:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "86b35d0c0e46564b52231a89644102733c2f4b91",
"body": null,
"is_bot": false,
"headline": "docs: update CHANGELOG with missing 0.10.8 notes and recent fixes",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T21:45:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7b8b77b7a69467991c1c92933e86129cf9f87853",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 0.11.0 for multi-turn release",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T21:44:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c90a382d35213fa728f4b3d19d3019090ebf66d7",
"body": null,
"is_bot": false,
"headline": "docs: add multi-turn context support to AI docs (pwm --ai)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T21:42:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "890c7c489469981edc40cd807059b7fbd7cba335",
"body": "Resolves #6 by adding persistent session state using UUIDs and conversational context retention across queries.",
"is_bot": false,
"headline": "feat: implement multi-turn conversational context",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T20:38:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e23d9c712bd507cc80ff03eb30a7123239003b1e",
"body": "curl_cffi 0.14.0's TLS fingerprints are now detected and blocked by\nPerplexity's Cloudflare protection, causing 403 Forbidden errors on all\nqueries. Version 0.15.0 has updated browser fingerprints that pass.\n\nThis was the root cause of the persistent 403 errors reported in #5 —\nthe session token was valid, but the HTTP client's TLS handshake was\nbeing rejected at the CDN level.",
"is_bot": false,
"headline": "fix: bump curl-cffi minimum to >=0.15.0 (fixes #5)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T19:41:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5c93f070955bac2a65300c18d43704f98b1bf560",
"body": "- CLI: add rich spinner to research command for visual feedback\n- CLI: write JSON error to stdout on auth/rate-limit failure with --json\n- MCP: add pplx_deep_research_start/pplx_research_status async polling tools\n- MCP: thread-safe task tracking with cleanup on retrieval\n- Keep synchronous pplx_deep_research for backwards compatibility",
"is_bot": false,
"headline": "fix: deep research timeout and CLI UX (issue #2)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T19:30:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3c941cc90faa590d85e5187d82f2cc3891ed21d5",
"body": null,
"is_bot": false,
"headline": "docs: update README with new video preview",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-09T18:44:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f242a624c1da743f0c8db09dc4e19ef33a33ecbd",
"body": "Changes:\n- fix(setup): add claude-desktop to CLIENT_REGISTRY (was missing, causing\n 'Unknown client' error on pwm setup add claude-desktop)\n- style: auto-fix 254 ruff lint issues (imports, whitespace, __all__ sorting)\n- chore: bump version to 0.10.8 in pyproject.toml and manifest.json\n\nAll 381 tests pass. Build verified.",
"is_bot": false,
"headline": "release: v0.10.8 — fix claude-desktop setup, auto-fix lint, version bump",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-08T00:51:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9d811e1c7ffdc9bc37ca1b6861cefe3b9a26500b",
"body": "The config path function _claude_desktop_config_path() existed but\nclaude-desktop was never registered in CLIENT_REGISTRY, causing\n'pwm setup add claude-desktop' to fail with 'Unknown client'.\n\n- Add claude-desktop entry to CLIENT_REGISTRY\n- Add detection logic so it appears in 'pwm setup add all'",
"is_bot": false,
"headline": "fix(setup): add claude-desktop to CLIENT_REGISTRY",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-05-08T00:49:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d3fd889326732ee0a49412bcb137edb0e6a7313c",
"body": "Perplexity renamed Sonar to Sonar 2 (API id still `experimental`). Live\ntesting confirmed Sonar queries consume 1 Pro Search — all docs, skills,\nMCP tool descriptions, CLI help, cost tables, and council math corrected.\nDefault council now documented as 4 Pro Searches (3 models + synthesis).\n\nAdded integration test that verifies Sonar Pro Search consumption by\ncomparing remaining_pro before and after a live query.\n\nMade-with: Cursor",
"is_bot": false,
"headline": "Release v0.10.7: Sonar 2 rename, fix Sonar Pro Search cost documentation",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-27T18:42:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a7babd97447fed4d5567d6630daac16a4a8e8371",
"body": "- Add GPT-5.5 (gpt55/gpt55_thinking) — Max tier, thinking toggle, council support\n- Add --chairman/chairman param to council for custom synthesis model\n- Fix GPT-5.4 description (latest → versatile), Claude Opus 4.6 → 4.7 in CLI\n- Move COUNCIL_DISPLAY_NAMES and THINKING_TOGGLEABLE to shared.py (single source of truth)\n- Fix kimi_k26 missing from CLI thinking-toggle check\n- Update reference model config snapshot",
"is_bot": false,
"headline": "Release v0.10.6: GPT-5.5 model, configurable council chairman",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-26T16:52:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "77437833cd48037c6f84c0bab963c7b8c79bfebd",
"body": null,
"is_bot": false,
"headline": "docs: add v0.10.5 changelog",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-23T02:10:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "02925d1fbf19f363fa79c188c750f5137f05e5a0",
"body": "- Add Moonshot Kimi K2.6 model (standard + thinking variants)\n- Upgrade Claude Opus 4.6 → 4.7 across all layers\n- Remove pre-flight rate limit block (Perplexity API reports inaccurate zeros)\n- Fix pwm usage crash when subscription_tier is None\n- Hoist council display names and thinking-toggleable set to module level\n- Remove dead council pre-flight loop and redundant invalidate_rate_limits call\n- Update SKILL.md and models.md with Kimi, Claude 4.7, and cost clarification",
"is_bot": false,
"headline": "Release v0.10.5: Kimi K2.6, Claude 4.7 Opus, rate limit fix",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-23T02:08:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3208ee47c73923e6c255db3bb1490ad8d445a19a",
"body": "- Update model registry definitions in models.py\n- Update council configurations to use 4.7 Opus\n- Update CLI, API, and MCP server mappings\n- Sync model maps in shared.py\n- Fix test assertions in test_council.py, test_rate_limits.py, and test_shared.py",
"is_bot": false,
"headline": "chore: migrate Claude model configuration from 4.6 to 4.7 Opus",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-23T01:18:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5752b6b7c6d07062bc051f4776f78f633c7c3ad7",
"body": "Enable extended thinking for all council models via --thinking / -t flag\n(CLI) or thinking=True (MCP tool). When enabled with default models, uses\nCOUNCIL_DEFAULT_MODELS_THINKING (GPT-5.4 Thinking, Claude Opus 4.6\nThinking, Gemini 3.1 Pro). Custom model lists resolve each model with\nthe thinking flag via resolve_model(). 10 new tests.\n\nMade-with: Cursor",
"is_bot": false,
"headline": "feat: add thinking control to Model Council (v0.10.4)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-22T21:16:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "12515ff199e952117b8a514fb18889fafd00c19d",
"body": "…t fix\n\n- fix: pwm hack claude -m flag passthrough (Issue #4, thanks @garthgoodson)\n- feat: inject type/status frontmatter for alef-agent skill installs\n- fix: relax upload_limit assertion in integration test (>= 0 not > 0)",
"is_bot": false,
"headline": "Release v0.10.3: fix hack -m passthrough, Alef Agent frontmatter, tes…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-21T21:23:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9449fbf39d8ca1b109df5abbe8f0648af728e89a",
"body": "Updates skill target name, path (~/.alef-agent/workspace/skills/),\nand all references across CLI, README, and CHANGELOG.",
"is_bot": false,
"headline": "feat: rename cc-claw to alef-agent skill platform (v0.10.2)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-14T20:08:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "23179f383e0cc84bc000378c07bbd6ac670ebeed",
"body": "- Rename skill from querying-perplexity to perplexity-web-mcp to match folder name\n- Collapse multi-line YAML block scalar (>-) to single quoted string for CC-Claw compatibility\n- Sync SKILL.md metadata version to 0.10.1",
"is_bot": false,
"headline": "fix: correct skill frontmatter — name and description format",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-04-14T17:44:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6f4fb1edffdb16ace9da8a63afeba0b88293dc48",
"body": null,
"is_bot": false,
"headline": "docs: credit @dangeReis for Model Council (PR #1)",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-21T20:18:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f00f3b45d46aeab59b60ac5871124715595302f3",
"body": "- Model Council: parallel multi-model queries with Sonar synthesis\n - pplx_council MCP tool (17 tools total)\n - pwm council CLI command\n - Interactive model selection UX for AI agents\n- Usage-Based Credits: /rest/billing/credits endpoint\n - Credits/CreditGrant dataclasses with cached fetching\n \n[…]\nkdown\n- pwm usage: Rich tables with color-coded remaining counts\n- Updated: SKILL.md, ai_doc, CLAUDE.md, README, quickstart\n- 11 new council tests + updated usage tests\n- Version bump: 0.9.5 -> 0.10.0",
"is_bot": false,
"headline": "feat: Model Council + Usage-Based Credits + prettified pwm usage",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-21T20:18:18Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "d7a3b96d1a3f245e2c369446dd8a158bfe8abf4c",
"body": "feat: Model Council — parallel multi-model queries with synthesis",
"is_bot": false,
"headline": "Merge pull request #1 from dangeReis/feature/model-council",
"author_name": "Jacob Ben-David",
"author_login": "jacob-bd",
"committed_at": "2026-03-21T20:16:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "10fd45d2c30cab38334b8130873ad5472e01652e",
"body": "Adds a new pplx_council MCP tool that queries multiple AI models in parallel\n(default: GPT-5.4, Claude Opus 4.6, Gemini 3.1 Pro) and synthesizes their\nresponses into a unified consensus using Sonar (free, no Pro quota cost).\n\nKey features:\n- Concurrent model execution via ThreadPoolExecutor\n- Custom\n[…]\n_mcp/mcp/server.py: Add pplx_council tool\n- src/perplexity_web_mcp/shared.py: Add council_ask wrapper\n- src/perplexity_web_mcp/__init__.py: Export council types\n- tests/test_council.py (new): 22 tests",
"is_bot": false,
"headline": "feat: add Model Council — parallel multi-model queries with synthesis",
"author_name": "Ruslan Sivak",
"author_login": null,
"committed_at": "2026-03-21T04:13:25Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "b502f8feea70f696dcff8f2a6073cae020a27e09",
"body": null,
"is_bot": false,
"headline": "Update project title in README.md",
"author_name": "Jacob Ben-David",
"author_login": "jacob-bd",
"committed_at": "2026-03-20T21:59:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "674d40f90798ad4058a5e541e7b58c1d4a6ce99c",
"body": null,
"is_bot": false,
"headline": "docs: update repository social preview image",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-20T21:57:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d8b230d9b42d52ccb77e8786df2148e46fa47d55",
"body": null,
"is_bot": false,
"headline": "docs: add unofficial API disclaimer and risk warning to README",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-19T23:40:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7362af36084b0e6880555b8dddd4b144b1a120f1",
"body": null,
"is_bot": false,
"headline": "docs: move demo thumbnail below headline",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-17T15:36:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8bcebcfd540771728d645ad0edc7bfa0469473c1",
"body": null,
"is_bot": false,
"headline": "docs: add YouTube demo overview thumbnail to README",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-17T15:34:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9b935633277a8d8ce408647fc3aeaa6d4840612e",
"body": "- fix: pwm hack claude now preserves ~/.claude/settings.json (prevents /model corruption)\n- feat: OpenCode MCP setup support (pwm setup add/remove opencode)\n- feat: verify hints after claude-code and codex MCP setup\n- fix: Claude Code setup checks both stdout and stderr for 'already exists'\n- fix: README model count corrected\n- 5 new tests for settings guard (352 total)",
"is_bot": false,
"headline": "release: v0.9.5 — settings guard for pwm hack claude",
"author_name": "jacob-bd",
"author_login": null,
"committed_at": "2026-03-16T18:20:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0540ff8db4cc434c72fcd2dec5a7fb0abe86b97c",
"body": "OpenCode uses a different config format (mcp key, array commands,\ntype:local) at ~/.config/opencode/opencode.json, requiring custom\nhandlers analogous to Claude Code and Codex.\n\n- Add _opencode_config_path, _setup_opencode, _remove_opencode\n- Wire into all routing: setup_add, setup_remove, _setup_all,\n _remove_all, setup_list, _detect_tool, _is_already_configured\n- Add 3 new tests (add, already-configured, remove)\n- All 36 tests pass",
"is_bot": false,
"headline": "feat: add OpenCode support to pwm setup add/remove/list",
"author_name": "jacob-bd",
"author_login": null,
"committed_at": "2026-03-16T02:59:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "774de2caf820a1f19fc88e7365607d6d8b021eb3",
"body": "…ssage\n\nclaude mcp add returns exit code 1 with the 'already exists' message\non stdout (not stderr), causing setup to incorrectly report failure.",
"is_bot": false,
"headline": "fix: check both stdout and stderr for Claude Code 'already exists' me…",
"author_name": "jacob-bd",
"author_login": null,
"committed_at": "2026-03-16T02:21:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5a3d83ba234cb5f6d8f5003829c4605f33726b06",
"body": "Updated the number of models listed from 8 to 6.",
"is_bot": false,
"headline": "Correct model count in README",
"author_name": "Jacob Ben-David",
"author_login": "jacob-bd",
"committed_at": "2026-03-16T01:01:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "95d1dcab7795899c28d51ca0d33148a8229705ce",
"body": "CLI-based tools (claude mcp add, codex mcp add) now show a verify\ncommand hint after successful setup, matching the pattern of JSON-based\ntools that show their config file path.",
"is_bot": false,
"headline": "setup: show verify hints for Claude Code and Codex CLI after MCP add",
"author_name": "jacob-bd",
"author_login": null,
"committed_at": "2026-03-15T00:23:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "98ab894ef9a1758a9a454b57e59c9668def035ff",
"body": "…t fixes\n\nAdded:\n- CC-Claw as 9th skill platform (pwm skill install cc-claw)\n- docs/quickstart.md — install, auth, first query, MCP setup guide\n\nFixed:\n- Hardcoded personal path in model-update workflow\n- Desktop extension manifest version (0.9.0 → 0.9.4)\n- Skill SKILL.md and references synced from data/ (v0.9.1 → v0.9.4)\n\nChanged:\n- docs/ un-gitignored (only docs/plans/ remains ignored)\n- Internal planning documents removed",
"is_bot": false,
"headline": "v0.9.4: cc-claw skill platform, quickstart guide, public release audi…",
"author_name": "jacob-bd",
"author_login": null,
"committed_at": "2026-03-14T23:44:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8fe3018b6c168faea86702474964e5a09f6e1fd6",
"body": "Updated gemini-cli skill target from ~/.gemini/skills/ to ~/.agents/skills/ to align with Gemini CLI v0.33.1+ which prioritizes the .agents/skills/ directory. Detection now checks for the gemini binary in PATH.",
"is_bot": false,
"headline": "v0.9.3: Gemini CLI skill path migrated to .agents/skills/",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-13T22:01:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bde124eeb27db3a5bc032f3a1dc733eb45dc5b03",
"body": "Codex MCP setup now uses `codex mcp add` with config.toml fallback\ninstead of redirecting to skill install. Added \"other\" skill export\ntarget. README updated to reflect current models (8) and tools (16).\n\nMade-with: Cursor",
"is_bot": false,
"headline": "release: v0.9.2 — full tool parity for skill install and MCP setup",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-12T19:22:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ccec1f90eca1fe42c8edf5a328d9e314297e78c3",
"body": "Models removed (no longer in Perplexity UI):\n- GPT-5.2 (gpt52 / gpt52_thinking)\n- Gemini 3 Flash (gemini30flash / gemini30flash_high)\n- Grok 4.1 (grok41nonreasoning / grok41reasoning)\n- Kimi K2.5 (kimik25thinking)\n\nModel added:\n- NVIDIA Nemotron 3 Super 120B (nv_nemotron_3_super) — reasoning-only\n\nMCP tool count: 21 → 16 (removed 7, added 1)\n\nAlso adds:\n- scripts/detect_model_changes.py for automated model change detection\n- .agents/workflows/model-update.md workflow for future updates",
"is_bot": false,
"headline": "v0.9.1: Add Nemotron 3 Super, remove GPT-5.2/Gemini Flash/Grok/Kimi",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-12T01:53:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "634221cfd11d83ac8fef8b784e59cf604d1411d0",
"body": "Add comprehensive quota awareness across all AI-facing surfaces to prevent\nagents from exhausting Pro Search quotas on simple lookups.\n\n- Quota footer on every direct tool response (remaining counts + warnings)\n- Cost labels on all 17 MCP tool docstrings (FREE / 1 Pro / 1 Research)\n- Rewritten MCP s\n[…]\nd with cost table, classification rubric, decision flowchart\n- New QUOTA-AWARE QUERYING section in pwm --ai reference doc\n- mcp-tools.md reference updated with per-tool cost summary\n\nMade-with: Cursor",
"is_bot": false,
"headline": "release: v0.9.0 — quota-aware AI agent usage protocol",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-11T16:37:28Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ec6e5946c43faf604e59bd1a90e7c88d8b263c4f",
"body": "…CP extension\n\n- Convert entire CLI to Click + rich-click for colored help output\n- Add 'pwm setup add all' — interactive multi-tool MCP setup\n- Add 'pwm setup remove all' — batch removal with confirmation\n- Add Claude Desktop .mcpb extension (desktop-extension/ + scripts/build_mcpb.py)\n- Fix Codex \n[…]\nia .mcpb extension)\n- Update MCP tool count to 21 across all docs (was 17)\n- Add GPT-5.4 and pplx_smart_query to README and ai_doc.py\n- Publish workflow: auto-build and upload .mcpb to GitHub releases",
"is_bot": false,
"headline": "feat: v0.8.3 — rich-click CLI, setup add/remove all, Claude Desktop M…",
"author_name": "jacob-bd",
"author_login": null,
"committed_at": "2026-03-08T18:34:10Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c2d4f3e2c86f5a5f740378330e0f82dd267abd0a",
"body": "Made-with: Cursor",
"is_bot": false,
"headline": "ci: add workflow_dispatch trigger to publish workflow",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-05T22:46:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b058ffe21099bf328373f9a1c6788b556305dc34",
"body": "…elves\n\nMade-with: Cursor",
"is_bot": false,
"headline": "fix: skill install all detection — ignore directories we created ours…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-05T22:41:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "485abb64c2a2215c6b0b8bf1830ba2c2aabbe788",
"body": "- `pwm skill install all` installs to all detected tools on the system\n- `pwm skill update` now shows full breakdown (updated/current/not installed)\n- `pwm skill install --help` no longer errors as \"Unknown tool\"\n\nMade-with: Cursor",
"is_bot": false,
"headline": "feat: skill install all, improved update output, --help fix",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-05T21:11:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3ad4b302c7aa95bb245b70c6cd4964bc80adb53a",
"body": "Made-with: Cursor",
"is_bot": false,
"headline": "release: v0.8.0 — GPT-5.4 model support",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-05T20:44:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bd893e8c38ec8a226c16f6e80114fe4c9a2847ef",
"body": "Perplexity added OpenAI GPT-5.4 with thinking toggle. Adds gpt54/gpt54_thinking\nidentifiers, pplx_gpt54/pplx_gpt54_thinking MCP tools, API server aliases,\nCLI model selection, and updated docs/tests across all surfaces.\n\nMade-with: Cursor",
"is_bot": false,
"headline": "feat: add GPT-5.4 model support",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-05T20:43:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "55b707e4c3444fcd22f2763155d05b5de028dfdc",
"body": "…ements\n\nFeatures:\n- Add source_focus=\"none\" for model-only queries without web search\n- Add `pwm setup add json` interactive JSON config generator\n\nFixes (ported from sibling projects):\n- MCP isError propagation: auth/rate-limit errors now raise instead of\n returning plain text, so FastMCP sets is\n[…]\nt/skills/\n\nDocs & housekeeping:\n- Changelog backfilled for 0.7.0, 0.7.1, 0.7.2\n- SKILL.md, pwm --ai, MCP docstrings updated with none source option\n- Author name updated to Jacob BD\n\nMade-with: Cursor",
"is_bot": false,
"headline": "release: v0.7.2 — no-search mode, MCP error propagation, setup improv…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-03-01T19:17:14Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f7b3ded427dfb838aec5bb2691fa1bf69d0e472a",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "chore: bump version to 0.7.1",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T16:57:14Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "8a4268a2ced27d95a17a0adccb9da20b18ba00a5",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "refactor: merge pwm-api into main CLI as pwm api subcommand",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T16:56:39Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "a8b0d38113d59ef265e18ccd69a1c6001cf53cd8",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "chore: bump version to 0.7.0 for smart routing",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:33:45Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "07fa989f8de3535e73cbbf1496b16f837f8dbaed",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "feat: export router types from package",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:32:18Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "1f7ac6021c83c6d722262631649b976a769ff6c1",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "docs: update SKILL.md with smart routing guidance",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:31:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "889767c6552ee5ecdb3ee439b88bb8ced4f3247a",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "feat: CLI smart routing for pwm ask without -m, add --intent flag",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:30:20Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "51d856c234943f459d1f81a1cbe15858c093863a",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "feat: add pplx_smart_query MCP tool with quota-aware routing",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:27:33Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "bcb2113948db7d383de333272c6241af117341a1",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "feat: add smart_ask() with quota-aware routing",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:26:07Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "5f0e66f505dc24aea8f5d3084984bcbf8af590ad",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "feat: implement SmartRouter routing logic",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:23:48Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "e108a14a4db12329564fd0dd282776b9bf5216ae",
"body": "…esponse)\n\nUPPER_CASE enum members to match codebase conventions in enums.py.\n\nCo-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "feat: add router data structures (QuotaState, RoutingDecision, SmartR…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:21:01Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "7cedb9eb8128e86dad3aca2839922fc6037be0e0",
"body": "8-task TDD plan covering router module, smart_ask(), MCP tool,\nCLI integration, and skill updates.\n\nCo-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "docs: smart routing implementation plan",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:13:54Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "4752986a9ffa248a544e147ebba4ec21df6afb42",
"body": "Design for intelligent model/search routing based on current rate limits.\nCovers router module, MCP tool, CLI integration, and skill updates.\n\nCo-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "docs: smart quota-aware routing design",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-25T04:11:19Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "fa50e34a1bfb11516b62a6c1ffcc4c5617990495",
"body": "- Rewrite model selection to use --model directly (matching gemini-web-mcp pattern)\n- Remove ANTHROPIC_MODEL env var approach that prevented /model mid-session switching\n- Claude Code validates models against our /v1/models endpoint\n- Built-in /model aliases (sonnet, opus, haiku) mapped to Perplexity models server-side\n\nCo-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "Release 0.6.0: Fix hack claude model handling for /model switching",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-20T04:27:04Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "6fd22725d686c1a2b0078c0deddd8f57a7d284fc",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "Revert to --model approach matching gemini-web-mcp pattern",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-20T04:21:29Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "0882020440a89864ae759bd6df059756062f32e9",
"body": "…-session\n\nCo-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "Use --model instead of ANTHROPIC_MODEL to enable /model switching mid…",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-20T04:03:15Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "7c3fd6248a30f337ad01dda3b0ca170441286212",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "Use ANTHROPIC_MODEL env var to bypass Claude Code model allowlist",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-20T03:58:10Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "c804ee0283f2b1860a4a418feda69ae4c4dd070f",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "Bump version to 0.5.9 and update docs for hack claude flags",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-20T03:34:10Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "494be3390c6851ccc25b6bb7e5d20440d18b464d",
"body": "Co-authored-by: Cursor <cursoragent@cursor.com>",
"is_bot": false,
"headline": "Add help output and -m conversion to pwm hack claude",
"author_name": "jacob-bd",
"author_login": "jacob-bd",
"committed_at": "2026-02-20T03:31:23Z",
"body_truncated": false,
"is_coding_agent": true
}
],
"releases_count": 47,
"commits_last_year": 148,
"latest_release_at": "2026-07-15T02:37:25Z",
"latest_release_tag": "v0.14.2",
"releases_from_tags": false,
"days_since_last_push": 0,
"active_weeks_last_year": 18,
"days_since_latest_release": 6,
"mean_days_between_releases": 7.3
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": false,
"health_percentage": 42,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "perplexity-web-mcp-cli",
"exists": true,
"license": "MIT",
"keywords": [
"perplexity",
"ai",
"mcp",
"anthropic",
"api",
"client",
"Development Status :: 3 - Alpha",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Topic :: Internet :: WWW/HTTP",
"Topic :: Software Development :: Libraries :: Python Modules",
"Typing :: Typed"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/perplexity-web-mcp-cli/",
"is_deprecated": false,
"latest_version": "0.14.2",
"repository_url": "https://github.com/jacob-bd/perplexity-web-mcp.git",
"versions_count": 45,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 1799,
"first_published_at": "2026-02-16T21:33:28.247716Z",
"latest_published_at": "2026-07-15T02:37:19.261716Z",
"latest_version_yanked": null,
"days_since_latest_publish": 6
}
]
},
"popularity": {
"forks": 21,
"stars": 149,
"watchers": 2,
"fork_history": {
"days": [
{
"date": "2026-03-19",
"count": 1
},
{
"date": "2026-03-21",
"count": 2
},
{
"date": "2026-04-02",
"count": 1
},
{
"date": "2026-04-12",
"count": 1
},
{
"date": "2026-04-15",
"count": 1
},
{
"date": "2026-04-22",
"count": 1
},
{
"date": "2026-05-05",
"count": 1
},
{
"date": "2026-05-19",
"count": 1
},
{
"date": "2026-05-29",
"count": 1
},
{
"date": "2026-05-30",
"count": 1
},
{
"date": "2026-06-06",
"count": 2
},
{
"date": "2026-06-15",
"count": 1
},
{
"date": "2026-06-19",
"count": 1
},
{
"date": "2026-06-20",
"count": 1
},
{
"date": "2026-06-25",
"count": 1
},
{
"date": "2026-07-02",
"count": 1
},
{
"date": "2026-07-12",
"count": 1
},
{
"date": "2026-07-17",
"count": 1
},
{
"date": "2026-07-20",
"count": 1
}
],
"complete": true,
"collected": 21,
"total_forks": 21
},
"star_history": {
"days": [
{
"date": "2026-03-17",
"count": 1
},
{
"date": "2026-03-18",
"count": 2
},
{
"date": "2026-03-19",
"count": 3
},
{
"date": "2026-03-20",
"count": 4
},
{
"date": "2026-03-21",
"count": 6
},
{
"date": "2026-03-22",
"count": 3
},
{
"date": "2026-03-23",
"count": 3
},
{
"date": "2026-03-24",
"count": 1
},
{
"date": "2026-03-25",
"count": 1
},
{
"date": "2026-03-26",
"count": 2
},
{
"date": "2026-03-27",
"count": 2
},
{
"date": "2026-03-28",
"count": 1
},
{
"date": "2026-03-29",
"count": 1
},
{
"date": "2026-03-30",
"count": 1
},
{
"date": "2026-04-01",
"count": 1
},
{
"date": "2026-04-02",
"count": 1
},
{
"date": "2026-04-06",
"count": 2
},
{
"date": "2026-04-08",
"count": 2
},
{
"date": "2026-04-09",
"count": 3
},
{
"date": "2026-04-10",
"count": 1
},
{
"date": "2026-04-12",
"count": 1
},
{
"date": "2026-04-16",
"count": 1
},
{
"date": "2026-04-21",
"count": 1
},
{
"date": "2026-04-23",
"count": 2
},
{
"date": "2026-04-25",
"count": 2
},
{
"date": "2026-04-26",
"count": 1
},
{
"date": "2026-04-28",
"count": 1
},
{
"date": "2026-04-30",
"count": 1
},
{
"date": "2026-05-02",
"count": 1
},
{
"date": "2026-05-04",
"count": 3
},
{
"date": "2026-05-05",
"count": 6
},
{
"date": "2026-05-07",
"count": 2
},
{
"date": "2026-05-08",
"count": 1
},
{
"date": "2026-05-09",
"count": 5
},
{
"date": "2026-05-10",
"count": 6
},
{
"date": "2026-05-11",
"count": 1
},
{
"date": "2026-05-14",
"count": 1
},
{
"date": "2026-05-15",
"count": 2
},
{
"date": "2026-05-17",
"count": 2
},
{
"date": "2026-05-18",
"count": 2
},
{
"date": "2026-05-21",
"count": 3
},
{
"date": "2026-05-26",
"count": 1
},
{
"date": "2026-05-27",
"count": 1
},
{
"date": "2026-05-28",
"count": 1
},
{
"date": "2026-05-30",
"count": 1
},
{
"date": "2026-05-31",
"count": 2
},
{
"date": "2026-06-02",
"count": 1
},
{
"date": "2026-06-03",
"count": 3
},
{
"date": "2026-06-04",
"count": 2
},
{
"date": "2026-06-06",
"count": 1
},
{
"date": "2026-06-07",
"count": 2
},
{
"date": "2026-06-09",
"count": 1
},
{
"date": "2026-06-10",
"count": 1
},
{
"date": "2026-06-12",
"count": 1
},
{
"date": "2026-06-14",
"count": 1
},
{
"date": "2026-06-17",
"count": 2
},
{
"date": "2026-06-18",
"count": 3
},
{
"date": "2026-06-19",
"count": 2
},
{
"date": "2026-06-20",
"count": 1
},
{
"date": "2026-06-22",
"count": 1
},
{
"date": "2026-06-23",
"count": 1
},
{
"date": "2026-06-25",
"count": 2
},
{
"date": "2026-06-26",
"count": 1
},
{
"date": "2026-06-28",
"count": 1
},
{
"date": "2026-06-30",
"count": 1
},
{
"date": "2026-07-02",
"count": 12
},
{
"date": "2026-07-03",
"count": 2
},
{
"date": "2026-07-04",
"count": 1
},
{
"date": "2026-07-05",
"count": 2
},
{
"date": "2026-07-06",
"count": 1
},
{
"date": "2026-07-08",
"count": 2
},
{
"date": "2026-07-09",
"count": 2
},
{
"date": "2026-07-11",
"count": 2
},
{
"date": "2026-07-12",
"count": 2
},
{
"date": "2026-07-14",
"count": 1
},
{
"date": "2026-07-15",
"count": 1
},
{
"date": "2026-07-17",
"count": 1
}
],
"complete": true,
"collected": 149,
"total_stars": 149
},
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": true,
"bootstrap_files": [
"Justfile"
],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"pyrightconfig.json",
"src/perplexity_web_mcp/py.typed"
],
"toolchain_manifests": [],
"largest_source_bytes": 4197994,
"source_files_sampled": 1966,
"oversized_source_files": 404,
"agent_instruction_files": [
"AGENTS.md",
"CLAUDE.md"
],
"agent_instruction_max_bytes": 3987
},
"dependencies": {
"manifests": [
"pyproject.toml"
],
"advisories": {
"error": null,
"scope": null,
"source": null,
"findings": [],
"collected": false,
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 0,
"assessed_package": null,
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "curl-cffi",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.15.0,<1.0"
},
{
"name": "loguru",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.7.3,<1.0"
},
{
"name": "orjson",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=3.11.6,<4.0"
},
{
"name": "pydantic",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.12.5,<3.0"
},
{
"name": "tenacity",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=9.1.2,<10.0"
},
{
"name": "tomli",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.0.0,<3.0"
},
{
"name": "python-dotenv",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.0.0,<2.0"
},
{
"name": "rich",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=13.0.0,<15.0"
},
{
"name": "rich-click",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.8"
},
{
"name": "fastmcp",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.14.4,<3.0"
},
{
"name": "fastapi",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.115.0,<1.0"
},
{
"name": "uvicorn",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.30.0,<1.0"
},
{
"name": "httpx",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.27.0,<1.0"
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 2,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 14,
"closed_unmerged_prs": 0
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "jacob-bd",
"commits": 141,
"avatar_url": "https://avatars.githubusercontent.com/u/47641890?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml",
"publish.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"security_signals": {
"lockfiles": [
"uv.lock"
],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 0,
"reason": "binaries present in source code",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 0,
"reason": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 1/30 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 0,
"reason": "project has 0 contributing companies or organizations -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 13 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": 0,
"reason": "Project has not signed or included provenance with any releases.",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 9,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "48 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "480920557fe16eda4173e6cf0a4bf8fa96d57362",
"ran_at": "2026-07-21T21:10:24Z",
"aggregate_score": 2.7,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/jacob-bd/perplexity-web-mcp",
"host": "github.com",
"name": "perplexity-web-mcp",
"owner": "jacob-bd"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 60,
"inputs": {
"security": 27,
"vitality": 82,
"community": 49,
"governance": 60,
"engineering": 70
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 82,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 76,
"inputs": {
"commits_last_year": 148,
"human_commit_share": 1,
"days_since_last_push": 0,
"active_weeks_last_year": 18
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 0 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 0
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "18/52 weeks with commits",
"points": 12.5,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 18
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "148 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 148
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 13 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"releases_count": 47,
"latest_release_tag": "v0.14.2",
"releases_from_tags": false,
"days_since_latest_release": 6,
"mean_days_between_releases": 7.3
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "47 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 47
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 6 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 6
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~7.3 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 7.3
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "unverified",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": "repository_too_young",
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": null,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "maintenance record not established from the collected data",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_unverified",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 49,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "at_risk",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 46,
"inputs": {
"forks": 21,
"stars": 149,
"watchers": 2,
"growth_state": "organic",
"growth_factor_pct": 100
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "149 stars",
"points": 35.2,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 149
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "21 forks",
"points": 10.8,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 21
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "2 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 2
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 50,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "moderate",
"name": "Ecosystem adoption (downloads)",
"note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"registry_dependents"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 54,
"inputs": {
"packages": [
"perplexity-web-mcp-cli"
],
"dependents": null,
"ecosystems": "pypi",
"total_downloads": null,
"monthly_downloads": 1799
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "1,799 downloads/month across pypi",
"points": 43.4,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 1799,
"ecosystems": "pypi"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "not reported by this ecosystem",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_reported_by_this_ecosystem",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 60,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 10,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "excellent",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"merged_prs": 2,
"open_issues": 0,
"closed_issues": 14,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 0
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "100% of issues closed",
"points": 46.8,
"status": "met",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 100
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "2/2 decided PRs merged",
"points": 38.2,
"status": "met",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 2,
"decided": 2
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 1/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 62,
"inputs": {
"followers": 336,
"owner_type": "User",
"is_verified": null,
"owner_login": "jacob-bd",
"public_repos": 19,
"account_age_days": 2714
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "336 followers of jacob-bd",
"points": 18.2,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 336,
"login": "jacob-bd"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "19 public repos, account ~7 yr old",
"points": 21.5,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 19
}
},
{
"code": "account_age_years",
"params": {
"years": 7
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"perplexity-web-mcp-cli"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 6
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 6 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 6
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "45 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 45
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "good",
"name": "Engineering Quality",
"value": 70,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "good",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 74,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "2 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 2
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 16,
"status": "met",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 9.6,
"status": "met",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "moderate",
"name": "Documentation",
"note": null,
"notes": [],
"value": 65,
"inputs": {
"topics": [],
"has_wiki": false,
"homepage": null,
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "critical",
"name": "Security",
"value": 27,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "critical",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Packaging. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"packaging"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 27,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 17,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 1,
"scorecard_aggregate": 2.7
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "binaries present in source code",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 1/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 13 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 6.8,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "48 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 2
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "good",
"name": "AI Readiness",
"value": 72,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "excellent",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.89,
"agent_instruction_files": [
"AGENTS.md",
"CLAUDE.md"
],
"agent_instruction_max_bytes": 3987
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "AGENTS.md, CLAUDE.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "AGENTS.md, CLAUDE.md"
}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "89 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 89,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "good",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"uv.lock"
],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [
"Justfile"
],
"has_devcontainer": false,
"has_linter_config": true,
"typecheck_configs": [
"pyrightconfig.json",
"src/perplexity_web_mcp/py.typed"
],
"agent_commit_share": 0.19,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": "Justfile",
"points": 18,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Justfile"
}
}
],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 11,
"status": "met",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "pyrightconfig.json, src/perplexity_web_mcp/py.typed",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "pyrightconfig.json, src/perplexity_web_mcp/py.typed"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "19 of the last 100 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 19,
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 71,
"inputs": {
"primary_language": "JavaScript",
"largest_source_bytes": 4197994,
"source_files_sampled": 1966,
"oversized_source_files": 404
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "JavaScript with type-check config (pyrightconfig.json, src/perplexity_web_mcp/py.typed)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "pyrightconfig.json, src/perplexity_web_mcp/py.typed",
"language": "JavaScript"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "404/1966 source files over 60KB",
"points": 43.7,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 1966,
"oversized": 404
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "critical",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 20,
"inputs": {
"example_dirs": [],
"has_mcp_signal": true,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 20,
"status": "met",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"deps.dev does not index pypi:perplexity-web-mcp-cli@0.14.2; advisories assessed against the repository dependency graph instead"
],
"report_type": "repository",
"generated_at": "2026-07-21T21:11:08.562675Z",
"schema_version": "0.23.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/j/jacob-bd/perplexity-web-mcp.svg",
"full_name": "jacob-bd/perplexity-web-mcp",
"license_state": "standard",
"license_spdx": "MIT"
}