Skip to content

Releases: Wpnx330/pharos-cli

v1.1.0 — Wave-1: drift detection, receipts v2, trust signals, MSIX Claude Desktop, windows CI

Choose a tag to compare

@Wpnx330 Wpnx330 released this 04 Sep 12:27

Pharos CLI v1.1.0 — the Wave-1 release

Six features, three adversarial review cycles, and a new Windows CI matrix later: everything in the v1.1 parity-plus plan is shipped and battle-tested.

Highlights

🩺 pharos doctor --diff — config drift detection (B3)

Compare every managed MCP client config against the pharos lockfile baseline. MISSING (deleted), MODIFIED (field-level: command/args/env/transport/url), and EXTRA (hand-added) findings per client, with JSON output parity and full read-only guarantees. Hardened through a dedicated adversarial-review fix loop: case-variant renames now surface instead of slipping through, partial opt-in installs no longer produce phantom MISSING reports, and Aider/Claude Desktop remote skips match install semantics exactly.

🧾 Deterministic install receipts v2 (C5)

Every install writes a complete, honest receipt: per-client write results, dependency rows with added/replaced semantics, and a status: partial + error list when anything fails — no more silent success on partial writes.

🔎 Search trust signals (B2)

pharos search now shows OWNER and CATEGORY columns, humanized download counts (1.2k), and (stale) version markers, with pharos info showing publisher/category meta — so you can judge a package before installing it.

🤖 Agent automation contract (A7)

PHAROS_JSON=1 env contract, non-interactive-safe behavior, and a machine-readable docs/llm.txt surface — pharos is now fully drivable by AI agents without human-scale output parsing.

🪟 Microsoft Store (MSIX) Claude Desktop support (W1.4.1)

Claude Desktop installed from the Microsoft Store keeps its config in an MSIX package directory (%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\) that classic detection missed entirely. Pharos now probes both locations, classic-first, and treats a dual install as two independent clients. Store installs that have never been launched are skipped by design — launch once, then install.

🖥️ Windows CI + cross-platform hardening (W1.4.2)

CI now runs the full test suite on windows-latest alongside Ubuntu. The first windows run exposed 38 POSIX-assumption test failures across 7 packages — all fixed, with one real windows bug found and fixed along the way (pharos daemon reload misbehaving on invalid PIDs).

Also in this release

  • mcp.directory as a sixth registry source — 1,700+ additional packages synced
  • Lockfile entries record which clients received each server (clients field), powering accurate per-client drift checks
  • Numeric env/args comparison fixes for TOML-based clients (Grok)

Install / upgrade

# Windows (PowerShell)
irm https://getpharos.dev/install.ps1 | iex
# macOS / Linux
curl -fsSL https://getpharos.dev/install.sh | bash

Existing installs: pharos update (or re-run the install command) picks up v1.1.0 automatically.

Full Changelog: v1.0.0...v1.1.0

v1.0.0

Choose a tag to compare

@Wpnx330 Wpnx330 released this 18 Aug 08:12

Pharos v1.0.0

Search, install, and remove MCP servers. Auto-configure clients.

Install the linux/amd64 or linux/arm64 binary, or:

go install github.com/Wpnx330/pharos-cli@v1.0.0

Windows amd64 is included. It has not been E2E-tested on this release.

Do not apt-install python-is-python3. Spawn resolves python → python3 when needed.

v0.0.9 — Pre-release

Choose a tag to compare

@Wpnx330 Wpnx330 released this 12 Aug 02:33

Pharos CLI v0.0.9 (Pre-release)

Initial binary release for testing. Not yet ready for public launch.

Install

curl -fsSL https://getpharos.dev/install | sh

Platforms

  • linux/amd64 ✅
  • linux/arm64 ✅
  • darwin/amd64 (Intel Mac) ✅
  • darwin/arm64 (Apple Silicon) ✅
  • windows/amd64 ❌ (coming soon — syscall compat issue)

What's Included

  • 26 CLI commands (search, install, publish, init, lock, list, remove, login, etc.)
  • Semantic versioning with dependency resolution
  • Circular dependency detection
  • Multi-client support (Claude Desktop, Hermes, Cline, LibreChat)
  • GitHub OAuth authentication
  • Safe config writes (copy-validate-swap pattern)