Tutorials
Guided walkthroughs. Each one starts from nothing and ends with something working, and every command in them has been run.
If you would rather read code than prose, the examples/
directory has the same material as short runnable programs.
Start here
| # | Tutorial | Time | You end up with |
|---|---|---|---|
| 01 | Your first scrape | 5 min | Real profile and timeline data, from the terminal and from Node |
| 02 | Claude that can use X | 10 min | Claude Desktop or Cursor driving 152 XActions MCP tools, behind an approval gate |
| 03 | Clean up your following list | 20 min | A safe, reviewed unfollow of accounts that do not follow back |
| 04 | Build a brand monitor | 30 min | A running service that watches X and alerts you on negative mentions |
| 05 | Read any account like an analyst | 15 min | A defensible read on how any account performs, and how two differ |
| 06 | Everything is JSON | 20 min | XActions inside your own pipelines: jq, cron, exit codes, tab completion |
| 07 | Read your own X archive | 15 min | Your X data export as JSON, CSV, Markdown and HTML, and staged for Bluesky or Mastodon |
Work through them in order the first time. Each assumes the setup from the one before it. Tutorials 01, 05, 06 and 07 need no X account at all: 07 does not even go online.
Never used the CLI before? xactions quickstart is the thirty-second version of
tutorial 01, and adapts to what you already have set up. xactions doctor is
the one to run when something is not behaving: it tests the guest tier for real
and names the fix for anything it finds.
Prompt library for AI assistants
claude-prompts/ is a different thing: 23 ready-to-paste
prompts that hand an AI assistant a complete task brief. Paste one into Claude,
Cursor, or ChatGPT and it has the context to do the job.
| Area | Prompts |
|---|---|
| Setup and CLI | 01, 15, 16 |
| Follower management | 02, 03, 07 |
| Content | 05, 12, 13, 17 |
| Research and analytics | 04, 06, 14, 18 |
| Automation | 09, 19, 21, 23 |
| Account and safety | 08, 11, 20 |
Full index: claude-prompts/README.md.
Where else to look
- Examples — nine runnable programs, shorter than tutorials
- Documentation — reference material
- Agent skills — 49 procedures, installed with
xactions skills install - Browser scripts — 95 of them, no install at all
- Troubleshooting — when something does not work