Enum Commands 

pub enum Commands {
    Post {
        text: String,
        media_ids: Vec<String>,
        common: CommonFlags,
    },
    Reply {
        post_id: String,
        text: String,
        media_ids: Vec<String>,
        common: CommonFlags,
    },
    Quote {
        post_id: String,
        text: String,
        common: CommonFlags,
    },
    Delete {
        post_id: String,
        force: bool,
        common: CommonFlags,
    },
    Read {
        post_id: String,
        common: CommonFlags,
    },
    Search {
        query: String,
        max_results: Option<i32>,
        common: CommonFlags,
    },
    Whoami {
        common: CommonFlags,
    },
    User {
        target_username: String,
        common: CommonFlags,
    },
    Timeline {
        max_results: Option<i32>,
        common: CommonFlags,
    },
    Mentions {
        max_results: Option<i32>,
        common: CommonFlags,
    },
    Like {
        post_id: String,
        common: CommonFlags,
    },
    Unlike {
        post_id: String,
        common: CommonFlags,
    },
    Repost {
        post_id: String,
        common: CommonFlags,
    },
    Unrepost {
        post_id: String,
        common: CommonFlags,
    },
    Bookmark {
        post_id: String,
        common: CommonFlags,
    },
    Unbookmark {
        post_id: String,
        common: CommonFlags,
    },
    Bookmarks {
        max_results: Option<i32>,
        common: CommonFlags,
    },
    Likes {
        max_results: Option<i32>,
        common: CommonFlags,
    },
    Follow {
        target_username: String,
        common: CommonFlags,
    },
    Unfollow {
        target_username: String,
        common: CommonFlags,
    },
    Following {
        max_results: Option<i32>,
        of: Option<String>,
        common: CommonFlags,
    },
    Followers {
        max_results: Option<i32>,
        of: Option<String>,
        common: CommonFlags,
    },
    Mute {
        target_username: String,
        common: CommonFlags,
    },
    Unmute {
        target_username: String,
        common: CommonFlags,
    },
    Usage {
        common: CommonFlags,
    },
    Dm {
        target_username: String,
        text: String,
        common: CommonFlags,
    },
    Dms {
        max_results: Option<i32>,
        common: CommonFlags,
    },
    Auth {
        command: AuthCommands,
    },
    Media {
        command: MediaCommands,
    },
    Skill {
        cmd: SkillCmd,
    },
    Schema {
        command: Option<String>,
        list: bool,
        all: bool,
        envelope: bool,
    },
    Completions {
        shell: Shell,
    },
    Version,
    Examples,
    Validate {
        file: Option<String>,
        schema: Option<String>,
    },
}

All subcommands.

Variants

Post

Post to X

Fields

text: String

The text to post

media_ids: Vec<String>

Media ID(s) to attach (repeatable)

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Reply

Reply to a post

Fields

post_id: String

Post ID or URL to reply to

text: String

The reply text

media_ids: Vec<String>

Media ID(s) to attach (repeatable)

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Quote

Quote a post

Fields

post_id: String

Post ID or URL to quote

text: String

The quote text

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Delete

Delete a post

Fields

post_id: String

Post ID or URL to delete

force: bool

Skip the confirmation prompt; required under --no-interactive

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Read

Read a post

Fields

post_id: String

Post ID or URL to read

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Search

Search recent posts

Fields

query: String

Search query

max_results: Option<i32>

Number of results (1-100). Overrides global --limit when set.

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Whoami

Show the authenticated user’s profile

Fields

common: CommonFlags

Shortcut flags shared with every other shortcut command.

User

Look up a user by username

Fields

target_username: String

Username to look up

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Timeline

Show your home timeline

Fields

max_results: Option<i32>

Number of results (1-100). Overrides global --limit when set.

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Mentions

Show your recent mentions

Fields

max_results: Option<i32>

Number of results (5-100). Overrides global --limit when set.

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Like

Like a post

Fields

post_id: String

Post ID or URL

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Unlike

Unlike a post

Fields

post_id: String

Post ID or URL

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Repost

Repost a post

Fields

post_id: String

Post ID or URL

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Unrepost

Undo a repost

Fields

post_id: String

Post ID or URL

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Bookmark

Bookmark a post

Fields

post_id: String

Post ID or URL

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Unbookmark

Remove a bookmark

Fields

post_id: String

Post ID or URL

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Bookmarks

List your bookmarks

Fields

max_results: Option<i32>

Number of results (1-100). Overrides global --limit when set.

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Likes

List your liked posts

Fields

max_results: Option<i32>

Number of results (1-100). Overrides global --limit when set.

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Follow

Follow a user

Fields

target_username: String

Username to follow

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Unfollow

Unfollow a user

Fields

target_username: String

Username to unfollow

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Following

List users you follow

Fields

max_results: Option<i32>

Number of results (1-1000). Overrides global --limit when set.

of: Option<String>

Username to list following for (default: you)

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Followers

List your followers

Fields

max_results: Option<i32>

Number of results (1-1000). Overrides global --limit when set.

of: Option<String>

Username to list followers for (default: you)

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Mute

Mute a user

Fields

target_username: String

Username to mute

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Unmute

Unmute a user

Fields

target_username: String

Username to unmute

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Usage

Show API usage (tweet caps, daily breakdown)

Fields

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Dm

Send a direct message

Fields

target_username: String

Username to DM

text: String

Message text

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Dms

List recent direct messages

Fields

max_results: Option<i32>

Number of results (1-100). Overrides global --limit when set.

common: CommonFlags

Shortcut flags shared with every other shortcut command.

Auth

Authentication management

Fields

command: AuthCommands

auth subcommand to dispatch (oauth2, oauth1, app, …).

Media

Media upload operations

Fields

command: MediaCommands

media subcommand to dispatch (upload or status).

Skill

Install or manage the xurl-rs skill bundle

Namespace for bundle operations. xr skill install <host> shallow-clones the xurl-rs repository into a host’s canonical skills directory so the bundled AGENTS.md becomes discoverable to local agents.

Fields

cmd: SkillCmd

skill subcommand to dispatch (install or update).

Schema

Show JSON Schema for a command’s response type

Fields

command: Option<String>

Command name to get the schema for (e.g. “post”, “whoami”, “envelope”)

list: bool

List all commands and their response types

all: bool

Output all schemas as a single JSON document

envelope: bool

Output the canonical agent-native output envelope schema

Completions

Generate shell completion script

Fields

shell: Shell

Shell to generate completions for

Version

Show xurl version information

Examples

Print a curated gallery of invocation examples grouped by use case

Validate

Validate a JSON document against a bundled response schema.

Reads JSON from stdin (when no file argument is given or - is passed) or from the supplied file, deserializes it into the requested typed response, and emits an ok / validation-failed envelope. Use --schema to pin a specific shape (e.g. tweet, user); without it the command auto-detects from the top-level shape.

Fields

file: Option<String>

File path to read JSON from. Pass - or omit to read from stdin.

schema: Option<String>

Schema name to validate against (tweet, tweets, user, users, dm, dms, usage, envelope). Omit for auto-detection.

Trait Implementations

impl Debug for Commands

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Commands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Commands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand