Lists Management
Apps & Automationlists-managementLists Management is an Agent Skill for apps & automation published in the nirholas/XActions repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Creates, populates, and exports X/Twitter lists from the browser console. Supports creating public or private lists, bulk-adding members by username, and exporting list members as JSON. Use when users want to create lists, add members to lists, or export list data on X.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/nirholas/XActions/blob/HEAD/skills/lists-management/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/lists-management, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Lists Management
Browser console script for creating and managing X/Twitter lists.
Script Selection
| Goal | File | Navigate to |
|---|---|---|
| Create a new list | src/listManager.js | x.com/USERNAME/lists |
| Add users to a list | src/listManager.js | List page |
| Export list members | src/listManager.js | List members page |
List Manager
File: src/listManager.js
Browser console script that creates lists, adds members by username, and exports member data.
How to Use
- Navigate to
x.com/YOUR_USERNAME/lists(or an existing list page) - Open DevTools (F12) → Console
- Edit the CONFIG section to enable desired operations
- Paste the script → Enter
Configuration
const CONFIG = {
createList: {
enabled: false,
name: 'My List',
description: 'Created by XActions',
isPrivate: true,
},
addUsers: {
enabled: true,
usernames: ['user1', 'user2'],
},
exportMembers: {
enabled: false,
maxMembers: 200,
},
actionDelay: 2000,
};
Create List
Sets createList.enabled: true to create a new list. Fills in the name, description, and privacy toggle, then saves.
Add Members
Sets addUsers.enabled: true with a list of usernames. Opens the add-member search, types each username, clicks the matching user cell, and repeats. Navigate to the target list page first.
Export Members
Sets exportMembers.enabled: true. Scrolls through the list members page and exports all members (username, display name, bio) as a JSON download.
DOM Selectors
| Element | Selector |
|---|---|
| Create list button | [data-testid="createList"] |
| List name input | [data-testid="listNameInput"] |
| List description | [data-testid="listDescriptionInput"] |
| Private toggle | [data-testid="listPrivateToggle"] |
| Save button | [data-testid="listSaveButton"] |
| Add members | [data-testid="addMembers"] |
| Search people | [data-testid="searchPeople"] |
| User cell | [data-testid="UserCell"] |
Rate Limiting
- 2s delay between adding individual users
- 1.5s scroll delay when exporting members
- Up to 5 retries when no new members load during export scroll
X List Limits
- Maximum 1,000 lists per account
- Maximum 5,000 members per list
- Lists can be public (visible to anyone) or private (only you)
Troubleshooting
| Problem | Solution |
|---|---|
| Create button not found | Navigate to x.com/USERNAME/lists first |
| User not found when adding | Verify username spelling; user may have changed handle |
| Export stops early | Page may have finished scrolling; increase maxMembers if needed |
| Search input not found | Ensure you clicked "Add member" — script expects the search overlay |