Releases: Wpnx330/pharos-cli
Release list
v1.1.0 — Wave-1: drift detection, receipts v2, trust signals, MSIX Claude Desktop, windows CI
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.directoryas a sixth registry source — 1,700+ additional packages synced- Lockfile entries record which clients received each server (
clientsfield), 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 | bashExisting 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
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
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 | shPlatforms
- 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)