xsh / command reference

Documentation

Search, filter, and explore every command available in xsh. Each entry includes its usage, options, source file, and practical examples for terminal workflows.

Explore commands Get started

Commands indexed

119

Catalog snapshot

6b4d1f2

Command groups

xsh / global options

Global flags

These options are available across the command catalog and can be combined with command-specific flags.

Flag	Short	Description
--account	—	Use a specific stored account
--json	—	Output as JSON
--yaml	—	Output as YAML
--compact	-c	Compact output for AI agents
--verbose	-v	Show HTTP requests
--watch	-w	Refresh output every N seconds

--account

Use a specific stored account

—

--json

Output as JSON

—

--yaml

Output as YAML

—

--compact

Compact output for AI agents

-c

--verbose

Show HTTP requests

-v

--watch

Refresh output every N seconds

-w

xsh / complete inventory

All commands

Select a command to see its options and copy ready-to-run examples.

Search commands Group

119 commands / 119 indexed

Command	Group	Summary	Usage
accounts	Getting Started	List stored accounts	xsh accounts
auth	Getting Started	Manage authentication	xsh auth
auth status	Getting Started	Check authentication status	xsh auth status
auth login	Getting Started	Extract cookies from browser	xsh auth login
auth import	Getting Started	Import cookies from Cookie Editor JSON	xsh auth import [file]
auth set	Getting Started	Set authentication credentials manually	xsh auth set
auth accounts	Getting Started	List stored accounts	xsh auth accounts
auth switch	Getting Started	Switch the default account	xsh auth switch [account]
auth logout	Getting Started	Remove stored credentials	xsh auth logout [account]
auth whoami	Getting Started	Show current user information	xsh auth whoami
import	Getting Started	Import cookies from a file	xsh import [cookie-file] [account-name]
switch	Getting Started	Switch the default account	xsh switch [account-name]
community	Discover & Read	Community operations	xsh community
community explore	Discover & Read	Discover communities from X's discovery timeline	xsh community explore
community view	Discover & Read	View community details	xsh community view [community-id]
community tweets	Discover & Read	View community tweets	xsh community tweets [community-id]
community join	Discover & Read	Join a community	xsh community join [community-id]
community leave	Discover & Read	Leave a community	xsh community leave [community-id]
feed	Discover & Read	View your timeline	xsh feed
jobs	Discover & Read	Search job listings	xsh jobs
jobs search	Discover & Read	Search for jobs	xsh jobs search <keyword>
jobs view	Discover & Read	View job details	xsh jobs view <job-id>
notifications	Discover & Read	View your notifications	xsh notifications
pinned	Discover & Read	View a user's pinned tweet	xsh pinned [handle]
quotes	Discover & Read	View quote tweets	xsh quotes [tweet-id]
search	Discover & Read	Search for tweets	xsh search [query]
space	Discover & Read	View and search Spaces	xsh space
space view	Discover & Read	View Space details	xsh space view [space-id]
space search	Discover & Read	Search for Spaces	xsh space search [query]
thread	Discover & Read	View a full conversation thread	xsh thread [tweet-id]
trends	Discover & Read	View trending topics	xsh trends
tweet	Discover & Read	View and manage tweets	xsh tweet
tweet view	Discover & Read	View a tweet and its thread	xsh tweet view [id]
tweet get	Discover & Read	Fetch one tweet without its conversation thread	xsh tweet get <tweet-id>
tweet post	Discover & Read	Post a new tweet	xsh tweet post [text]
tweet note	Discover & Read	Publish a long-form post	xsh tweet note [text]
tweet delete	Discover & Read	Delete your tweet	xsh tweet delete [id]
tweet like	Engage	Like a tweet	xsh tweet like [id]
tweet unlike	Engage	Unlike a tweet	xsh tweet unlike [id]
tweet retweet	Engage	Retweet a tweet	xsh tweet retweet [id]
tweet unretweet	Engage	Undo a retweet	xsh tweet unretweet [id]
tweet bookmark	Organize & Export	Bookmark a tweet	xsh tweet bookmark [id]
tweet unbookmark	Organize & Export	Remove a bookmark	xsh tweet unbookmark [id]
unroll	Discover & Read	Unroll a thread into a readable document	xsh unroll [tweet-id]
user	Discover & Read	View a user's profile	xsh user [handle]
user tweets	Discover & Read	View a user's tweets	xsh user tweets [handle]
user likes	Discover & Read	View a user's liked tweets	xsh user likes [handle]
user media	Discover & Read	View a user's media posts	xsh user media [handle]
user followers	Discover & Read	View a user's followers	xsh user followers [handle]
user following	Discover & Read	View who a user follows	xsh user following [handle]
user followers-you-know	Discover & Read	View followers you may know	xsh user followers-you-know [handle]
user blue-verified-followers	Discover & Read	View blue-verified followers	xsh user blue-verified-followers [handle]
compose	Create & Schedule	Compose a tweet thread interactively	xsh compose
schedule	Create & Schedule	Schedule a tweet for future posting	xsh schedule <text>
scheduled	Create & Schedule	List scheduled tweets	xsh scheduled
unschedule	Create & Schedule	Cancel a scheduled tweet	xsh unschedule <scheduled-tweet-id>
block	Engage	Block a user	xsh block <handle>
follow	Engage	Follow a user	xsh follow <handle>
mute	Engage	Mute a user	xsh mute <handle>
social	Engage	View relationship lists	xsh social
social blocked	Engage	View blocked accounts	xsh social blocked
social muted	Engage	View muted accounts	xsh social muted
unblock	Engage	Unblock a user	xsh unblock <handle>
unfollow	Engage	Unfollow a user	xsh unfollow <handle>
unmute	Engage	Unmute a user	xsh unmute <handle>
bookmarks	Organize & Export	View your bookmarks	xsh bookmarks
bookmarks-folders	Organize & Export	List bookmark folders	xsh bookmarks-folders
bookmarks-folder	Organize & Export	View tweets in a bookmark folder	xsh bookmarks-folder <folder-id>
download	Organize & Export	Download media from a tweet	xsh download <tweet-id>
export	Organize & Export	Export tweets to files	xsh export
export feed	Organize & Export	Export timeline to a file	xsh export feed
export search	Organize & Export	Export search results to a file	xsh export search [query]
export bookmarks	Organize & Export	Export bookmarks to a file	xsh export bookmarks
gallery	Organize & Export	Batch download media	xsh gallery [handle\|query]
lists	Organize & Export	Manage Twitter lists	xsh lists
lists view	Organize & Export	View tweets from a list	xsh lists view <list-id>
lists create	Organize & Export	Create a new list	xsh lists create <name>
lists delete	Organize & Export	Delete a list	xsh lists delete <list-id>
lists members	Organize & Export	View list members	xsh lists members <list-id>
lists info	Organize & Export	View list details	xsh lists info <list-id>
lists update	Organize & Export	Update list metadata	xsh lists update <list-id>
lists memberships	Organize & Export	View lists you belong to	xsh lists memberships
lists add-member	Organize & Export	Add a member to a list	xsh lists add-member <list-id> <handle>
lists remove-member	Organize & Export	Remove a member from a list	xsh lists remove-member <list-id> <handle>
lists pin	Organize & Export	Pin a list	xsh lists pin <list-id>
lists unpin	Organize & Export	Unpin a list	xsh lists unpin <list-id>
dm	Messages	Send and manage direct messages	xsh dm
dm inbox	Messages	View the DM inbox	xsh dm inbox
dm send	Messages	Send a direct message	xsh dm send <handle> <message>
dm delete	Messages	Delete a DM message	xsh dm delete <message-id>
analytics	Automation & Data	View engagement analytics	xsh analytics [handle]
count	Automation & Data	Count tweet characters	xsh count [text]
multi	Automation & Data	Run an action across accounts	xsh multi <action> [args...]
stream	Automation & Data	Stream tweets as NDJSON	xsh stream [source]
tweets	Automation & Data	Fetch multiple tweets by ID	xsh tweets <tweet-id>...
users	Automation & Data	Fetch multiple user profiles by handle or numeric ID	xsh users [handle]...
auto-update	System & Maintenance	Update obsolete GraphQL endpoints	xsh auto-update
completion	System & Maintenance	Generate shell autocompletion	xsh completion <shell>
config	System & Maintenance	Show and manage configuration	xsh config
config show	System & Maintenance	Show current configuration	xsh config show
config get	System & Maintenance	Get a configuration value	xsh config get <key>
config set	System & Maintenance	Set a configuration value	xsh config set <key> <value>
config reset	System & Maintenance	Reset configuration to defaults	xsh config reset
config path	System & Maintenance	Show configuration file path	xsh config path
config edit	System & Maintenance	Open configuration in an editor	xsh config edit
doctor	System & Maintenance	Run diagnostics	xsh doctor
endpoints	System & Maintenance	Manage GraphQL endpoints	xsh endpoints
endpoints list	System & Maintenance	List all GraphQL endpoints	xsh endpoints list
endpoints check	System & Maintenance	Check endpoint status	xsh endpoints check [operation]
endpoints refresh	System & Maintenance	Refresh endpoints from X.com	xsh endpoints refresh
endpoints status	System & Maintenance	Show endpoint system status	xsh endpoints status
endpoints update	System & Maintenance	Manually update an endpoint	xsh endpoints update [operation] [endpoint-id]
endpoints reset	System & Maintenance	Reset endpoints to defaults	xsh endpoints reset
help	System & Maintenance	Show help for a command	xsh help [command]
mcp	System & Maintenance	Start the MCP server	xsh mcp
ratelimit	System & Maintenance	Show API rate limit status	xsh ratelimit
status	System & Maintenance	Show system and endpoint health	xsh status
update	System & Maintenance	Update xsh to the latest compatible release	xsh update
version	System & Maintenance	Print the xsh version	xsh version

xsh / first session

Getting started

Install xsh, authenticate once, then use the same commands interactively or in scripts.

Authenticate

Extract browser cookies and save a local xsh account.

xsh auth login

Read your timeline

Fetch the home timeline directly from your terminal.

xsh feed

Post a tweet

Publish a tweet after authenticating your account.

xsh tweet post "Hello from xsh!"

Pipe structured output

Use JSON output in scripts, pipes, and automation.

xsh feed --json

Catalog source: core/cmd/*.go, core/README.md, and xsh --help · core master @ 6b4d1f2