| name | algorithm-cultivation |
| description | Trains an X/Twitter account's algorithmic feed to surface niche-relevant content and positions the account as a thought leader. Browser scripts for manual operation, Persona Engine for identity management, and 24/7 Algorithm Builder with LLM-powered engagement via Puppeteer. Use when a user wants to build their algorithm, cultivate their feed for a niche, grow a fresh account, become a thought leader, or run automated engagement with AI-generated content. |
| license | MIT |
| metadata | {"author":"nichxbt","version":"4.0"} |
Algorithm Cultivation & Thought Leadership
Train your X/Twitter algorithm for a specific niche. Three approaches:
- Browser script -- paste into DevTools console for manual sessions
- CLI + Persona Engine -- create personas and run from the command line
- 24/7 Algorithm Builder -- headless Puppeteer + LLM running continuously
Quick Reference
| Goal | Solution |
|---|
| Create a persona (CLI) | xactions persona create |
| Run 24/7 with LLM (CLI) | xactions persona run <id> |
| Check persona status | xactions persona status <id> |
| Browser console (with core.js) | src/automation/algorithmBuilder.js |
| Browser console (standalone) | scripts/thoughtLeaderCultivator.js |
| Browser console (algorithm trainer) | src/automation/algorithmTrainer.js |
| Persona Engine (Node.js module) | src/personaEngine.js |
| Algorithm Builder (Node.js module) | src/algorithmBuilder.js |
Core Concepts
- Persona -- identity config: niche, activity pattern, engagement strategy, topics
- Session -- one period of activity (search, browse, engage, post)
- Strategy -- engagement limits (aggressive/moderate/conservative/thoughtleader)
- Activity pattern -- human-like schedule (night-owl/early-bird/nine-to-five/always-on/weekend-warrior)
Algorithm Builder -- src/algorithmBuilder.js
24/7 headless automation: Puppeteer + stealth + OpenRouter LLM.
import { startAlgorithmBuilder } from './algorithmBuilder.js';
await startAlgorithmBuilder({
personaId: 'persona_1234',
authToken: 'your_auth_token',
headless: true,
dryRun: false,
maxSessions: 0,
});
Requires OPENROUTER_API_KEY env var for LLM-generated comments and posts.
Algorithm Trainer -- src/automation/algorithmTrainer.js
Browser console script for manual training sessions. Requires src/automation/core.js pasted first.
Training Phases (cycles through all 8)
- Search top tweets for niche keywords
- Search latest tweets for niche keywords
- Follow people from search results
- Engage with home feed (like/reply)
- Visit influencer profiles
- Browse random profiles in niche
- Explore page browsing
- Idle dwell time (human-like pauses)
Controls
stopTrainer() -- Stop training
trainerStatus() -- Current phase, actions taken, rate limits
trainerReset() -- Reset counters
Intensity Presets
| Preset | Actions/hour | Daily cap |
|---|
| chill | 10-15 | 100 |
| normal | 20-30 | 300 |
| active | 40-60 | 500 |
Strategy Guide
Fresh account (week 1-2)
- Create a persona with
xactions persona create or configure algorithmTrainer manually
- Use conservative/chill intensity -- X flags aggressive new accounts
- Focus on phases 1-2 (search) and 7 (explore) to signal interests
- Follow 5-10 niche accounts per day manually
- Like 20-30 niche tweets per day
Established account pivoting niches
- Aggressively engage with new niche content for 1-2 weeks
- Use
src/automation/algorithmTrainer.js on active intensity
- Unfollow accounts from the old niche gradually with
src/automation/smartUnfollow.js
- The algorithm typically adjusts within 3-7 days of consistent signals
Running 24/7 with LLM
- Set
OPENROUTER_API_KEY for AI-generated replies
xactions persona create -- configure niche, strategy, schedule
xactions persona run <id> -- starts headless Puppeteer session
- Monitor:
xactions persona status <id>
- Cost estimate: ~$0.50-2.00/day depending on model and activity level
Environment Variables
| Variable | Purpose |
|---|
OPENROUTER_API_KEY | Required for LLM-generated comments and posts |
XACTIONS_SESSION_COOKIE | X auth token (alternative to --token flag) |
Detailed References
Load these on demand for deeper context:
- Persona Engine details --
skills/algorithm-cultivation/references/persona-engine.md
- Browser scripts --
skills/algorithm-cultivation/references/browser-scripts.md
- Algorithm internals --
skills/algorithm-cultivation/references/algorithm-internals.md
- Research: algorithm internals --
docs/research/algorithm-cultivation.md
- Research: LLM architecture --
docs/research/llm-powered-thought-leader.md
Notes
- Browser scripts require navigating to x.com first
algorithmBuilder.js and algorithmTrainer.js require pasting src/automation/core.js first
thoughtLeaderCultivator.js is standalone (no dependencies)
- Default engagement strategy: 1-3s delays between actions
- Fresh accounts should start with conservative strategy for 1-2 weeks