AI Agent CLI Toolkit

Engineering tools designed for agent consumption: md2wechat / md2wechat-lite / md2wechat-mcp-server (WeChat formatting and publishing), gcli (Gmail read-only), imgcli (CGO-free image processing), jina-cli (URL → Markdown), tanso (Chinese web signals), go-cli-ship (CLI release automation), and github-topics-trending (open-source trend reports). Each tool exits cleanly, emits structured output where needed, and works in automation.

Frequently Asked Questions

How is md2wechat different from md2wechat-lite?

md2wechat is the full toolkit, it includes AI humanization, AI images, readiness inspection, draft push, 40 themes, and 43 advanced layout modules. md2wechat-lite is a lighter CLI focused on formatting and upload without the extra AI layer.

What is the install command?

brew install geekjourneyx/tap/md2wechat

Does it work on Windows?

No. md2wechat targets macOS and Linux. Windows users can run it inside WSL2.

What does md2wechat-mcp-server enable?

It exposes md2wechat publishing capabilities through MCP so an agent can format and prepare WeChat articles from its tool layer.

Why is MCP useful here?

MCP gives coding agents a stable interface instead of relying on manual shell steps or copied instructions.

Is it only for Claude Code?

No. Claude Code is the main target, but any MCP-compatible agent environment can integrate it.

What sources does Tanso query?

Tanso can query Bocha, Volcengine Ark, and Zhihu through provider APIs, then normalize the results for humans or agents.

Why is Tanso agent-friendly?

It avoids scraping and browser sessions, supports JSON output, and keeps configuration explicit so automation can call it predictably.

How do I install it?

Run: npm install -g @geekjourneyx/tanso

What does go-cli-ship help with?

It helps package, release, and distribute Go CLIs with repeatable agent-guided steps.

Why does a CLI need a shipping skill?

A CLI is not done when it compiles. Users need install paths, releases, checksums, and clear update flows.

What stack does it target?

It targets Go command-line tools with GitHub Releases, GitHub Actions, and optional npm distribution.

Why is gcli read-only?

Read-only scope limits the OAuth permission surface, a CLI that can only read email is safer to deploy on shared or cloud servers than one with full mailbox access.

Does it work on cloud servers without a browser?

Yes. gcli uses the PKCE flow which supports out-of-band device auth, you complete the OAuth step on your local machine once and the token is stored for subsequent server use.

What is the install command?

curl -fsSL https://raw.githubusercontent.com/geekjourneyx/gcli/main/scripts/install.sh | bash

What does CGO-free mean and why does it matter?

CGO-free means the binary has no C library dependencies, it compiles to a single static binary that runs on any Linux or macOS machine without installing libvips, ImageMagick, or any system library.

What image operations does it support?

Inspect metadata, compose/stitch images, convert formats (JPEG, PNG, WebP), apply smart padding, and batch-export pages to PDF.

What is the install command?

curl -fsSL https://raw.githubusercontent.com/geekjourneyx/imgcli/main/scripts/install.sh | bash

Do I need a Jina API key?

Jina Reader has a free tier that works without a key for moderate usage. For higher volume, set the JINA_API_KEY environment variable to use an authenticated key.

What does the output look like?

Clean Markdown, headings, paragraphs, code blocks, and links preserved. Ads, navigation, and boilerplate are stripped so the LLM receives only the page's content.

What is the install command?

curl -fsSL https://raw.githubusercontent.com/geekjourneyx/jina-cli/main/scripts/install.sh | bash

What does github-topics-trending track?

It tracks popular repositories under selected GitHub topics, then compares rankings, star growth, new entries, and active projects.

What does the report include?

The report includes clickable repositories, AI one-line summaries, detailed notes, problem labels, growth lists, new entries, and trend statistics.

How do I start from the source?

Clone the repository, configure GitHub and AI provider credentials, then run it locally or through GitHub Actions.

How is md2wechat-lite different from md2wechat?

md2wechat-lite is curl-installable and skips the AI humanization module, ideal for teams that only need formatting and draft push without the extra AI layer.

Does it support batch upload?

Yes. You can point it at a directory of Markdown files and it will format and upload all of them to the WeChat draft box in sequence.

What is the install command?

curl -fsSL https://raw.githubusercontent.com/geekjourneyx/md2wechat-lite/main/cli/scripts/install.sh | sh