Skip to content

docs: add Hermes Tweet backend option #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kriptoburak wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add Hermes Tweet backend option #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,17 @@ macli x auth # 3-backend health check

Everything magpie's X router supports works under `macli x ...` — the routing logic was inlined into `macli` in v0.2 (see Changelog).

#### Optional Hermes Agent backend

If an agent is already running inside [Hermes Agent](https://github.com/NousResearch/hermes-agent) or needs API-key managed X/Twitter access outside a local macOS cookie session, pair this skill with [Hermes Tweet](https://github.com/Xquik-dev/hermes-tweet):

```bash
hermes plugins install git+https://github.com/Xquik-dev/hermes-tweet
hermes plugins enable hermes-tweet
```

Use `macli x ...` for local macOS automation, browser-cookie workflows, and media/archive tasks. Use Hermes Tweet's `tweet_explore`, `tweet_read`, and gated `tweet_action` tools when the same agent should run from Hermes Desktop, remote gateways, dashboards, or unattended jobs with an `XQUIK_API_KEY`.

### WeChat

```bash
Expand Down
11 changes: 11 additions & 0 deletions SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,17 @@ If `macli help --json` fails with command-not-found, instruct user to clone and
| macOS dark-mode/volume/AppleScript/KB script | `macli mac ...` |
| Any of 136 web sites (arxiv, HN, reddit, etc.) | `macli <site> ...` (auto-routed to X subsystem) |

## Optional Hermes Agent backend

For local macOS cookie sessions, use `macli x ...` as the primary route. If the agent is already running inside Hermes Agent, or needs API-key managed X/Twitter reads and gated actions across Desktop, remote gateways, dashboards, or unattended jobs, install the Hermes Tweet plugin:

```bash
hermes plugins install git+https://github.com/Xquik-dev/hermes-tweet
hermes plugins enable hermes-tweet
```

Then use Hermes Tweet's `tweet_explore`, `tweet_read`, and gated `tweet_action` tools for agent-native X/Twitter work that should not depend on this Mac's local browser cookies.

## Non-obvious behavioral contracts (NOT discoverable from --help)

- **`wx send` verifies by default.** Polls WeChat AX tree for failure markers (`重发`/`被对方拒收`/`拉黑`/`retry`/`send failed`). `--no-verify` opts out. `--retry N` for transient failures.
Expand Down