# Install wx-cli with Homebrew

WeChat 4.x local data CLI with daemon architecture. Version 0.3.0 via Homebrew; verified 2026-07-17.

## Install

```sh
sudo av install brew:wx-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install wx-cli
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:wx-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/wx-cli>
- **Version:** 0.3.0
- **Source summary:** WeChat 4.x local data CLI with daemon architecture
- **Homepage:** <https://github.com/jackwener/wx-cli>
- **Repository:** <https://github.com/jackwener/wx-cli>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/jackwener/wx-cli/archive/refs/tags/v0.3.0.tar.gz>
- **Last updated:** 2026-07-17T17:22:03+09:00
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- wx (cli)
- wx (alias)

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 0.3.0
- Package-manager updated: 2026-07-17
- Local data: ok
- Upstream repository: https://github.com/jackwener/wx-cli
- Upstream latest detected: v0.3.0 (current)
## Project history and usage

wx-cli is a modern Rust command-line tool for querying local WeChat 4.x data. Its README frames it as a local-only CLI with a daemon architecture for chats, contacts, group members, favorites, statistics, export, and agent-friendly JSON/YAML output.

### Project history

The public GitHub repository presents wx-cli as a single-binary, cross-platform tool for local WeChat data. The project is young compared with the other packages in this batch; GitHub currently shows a small release history with v0.3.0 marked latest on May 15, 2026.

The README says the project was inspired by ylytdeng/wechat-decrypt but redesigned around wx-cli's own daemon, cache, and query commands. Its technical focus is WeChat 4.x SQLCipher databases, extracting keys from local process memory, and reusing decrypted database shards when file modification times are unchanged.

### Adoption history

Despite its youth, wx-cli had visible GitHub interest by 2026, with thousands of stars and over a thousand forks shown on the repository page. That adoption appears tied to agent and local-data workflows: the README explicitly documents installation as an AI Agent Skill for Claude Code, Cursor, Codex, and similar tools.

### How it is used

Users initialize wx-cli while WeChat is running, then query sessions, unread messages, chat history, full-text search, contacts, group members, favorites, statistics, social-feed data, official-account articles, and attachments. The daemon starts on first use and keeps decrypted databases under ~/.wx-cli/cache for faster subsequent queries.

The tool is designed for local inspection rather than cloud sync. The README warns that it is for learning and research on one's own WeChat data and documents platform-specific memory-reading mechanisms on macOS, Linux, and Windows.

### Why package nerds care

wx-cli is package-nerd significant as a 2020s example of CLIs built explicitly for local personal data and AI-agent consumption. The package exposes messy desktop-app state as stable command output, with metadata fields that help scripts and agents reason about freshness and source coverage.

### Timeline

- 2026-05-15: GitHub shows v0.3.0 as the latest release.
- 2026: README documents AI Agent Skill installation and daemon-backed querying of WeChat 4.x local data.

### Related projects

- wx-cli is related to WeChat local database decryptors, ylytdeng/wechat-decrypt, SQLCipher tooling, and local-first personal-data command-line tools.

### Sources

- <https://github.com/jackwener/wx-cli>
- <https://github.com/jackwener/wx-cli#readme>


## Security Notes

No matching local secret-handling manifest was found for wx-cli. Package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.wx-cli/config.json

## Credential files

- Unix: ~/.wx-cli/all_keys.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** wx-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** yes
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [rust](https://pkg.so/brew/rust/) - Build dependency declared by Homebrew.
- [sqlite](https://pkg.so/brew/sqlite/) - Shares pkgdb curated category or tags: cli, data, database.
- [redis](https://pkg.so/brew/redis/) - Shares pkgdb curated category or tags: cli, data, database.
- [gdbm](https://pkg.so/brew/gdbm/) - Shares pkgdb curated category or tags: cli, data, database.
- [mysql](https://pkg.so/brew/mysql/) - Shares pkgdb curated category or tags: cli, data, database.
- [postgresql@14](https://pkg.so/brew/postgresql-14/) - Shares pkgdb curated category or tags: cli, data, database.
- [postgresql@16](https://pkg.so/brew/postgresql-16/) - Shares pkgdb curated category or tags: cli, data, database.
- [postgresql@17](https://pkg.so/brew/postgresql-17/) - Shares pkgdb curated category or tags: cli, data, database.
- [postgresql@18](https://pkg.so/brew/postgresql-18/) - Shares pkgdb curated category or tags: cli, data, database.
- [ccm](https://pkg.so/brew/ccm/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, data, database, local.
- [bee](https://pkg.so/brew/bee/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, data, database.
- [cql-proxy](https://pkg.so/brew/cql-proxy/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, data, database.

## Combined YAML source

View the package source record on GitHub. [combined/wx-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/wx-cli.yml)


## Sources

- pkg.so package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph
