xAI has published a full setup guide showing users how to connect xurl, the official command-line client from the X Developer Platform, to Nous Research’s open-source terminal AI agent Hermes Agent. Once installed, Hermes can handle X account actions through plain-language instructions, including posting, search, direct messages, bookmark retrieval, and list management. Nous Research later amplified the guide on X.
The release came only days after Hermes Agent’s major v0.14.0 update. According to the source material, Nous Research had pushed 808 commits for that release four days earlier, and this week added xurl as a new X integration path. xAI published the documentation on May 20, while Hermes co-founder Teknium brought xurl into the project through PR #12303.
Official X CLI Replaces a Third-Party Wrapper
Before this change, Hermes relied on a third-party skill called xitter, which wrapped Infatoshi/x-cli underneath. The new implementation switches Hermes to xdevplatform/xurl, a repository maintained by the X Developer Platform itself. In practice, that moves Hermes from a third-party wrapper to an official CLI maintained by X. The source says xurl covers all X API v2 endpoints, supporting tasks such as posting, search, DMs, bookmarks, and lists.
Installation is available through four methods: shell scripts for Linux and macOS, Homebrew, npm, and Go. Authentication uses the OAuth 2.0 PKCE flow. Users must first register an app on the X Developer Platform, obtain a Client ID and Client Secret, and then run xurl auth oauth2 --app my-app locally to complete authorization. Tokens are stored persistently in a YAML file under ~/.xurl, separated by application and refreshed automatically when they expire.
Documentation Flags a Common Auth Failure
The guide also calls out a frequent setup mistake. If users leave out the --app flag during authorization, the OAuth token is saved into the built-in default profile, but that profile does not contain a client-id. Later commands then fail on authentication. The documented fix is simple: rerun the authorization command with the correct app flag.
Hermes Converts JSON Responses Into Readable Language
After xurl is connected, Hermes users do not need to memorize API endpoints or work directly with raw JSON responses from X. Hermes translates those responses into readable language and can chain actions from there. The source also notes that users who run Hermes on xAI’s Grok model need an active SuperGrok subscription. Those using Claude or ChatGPT can connect through the hermes proxy feature introduced in the previous major update.
Based on the published details, the core change is not a new X capability by itself. The main shift is that Hermes now routes X operations through an official X-maintained CLI, replacing its earlier dependence on a third-party wrapper and pairing that move with a documented installation and authorization flow.