NuxPulse Docs

Getting started, guardrails, and troubleshooting — designed to be quick.

X autopilot Safety limits Support Upgrade

Getting started (5 minutes)

Connect → draft → schedule → verify in logs.

NuxPulse helps you run one or more X accounts with a clear queue, predictable scheduling, and simple guardrails.

  1. 1) Create (or open) a bot
    From the dashboard, pick the bot you want to manage. Each bot has its own timezone, work hours, limits, sources, and personality.
  2. 2) Set timezone + work hours
    This controls when posts are allowed to go out.
    • Timezone (important for “scheduled_for”)
    • Work days (Mon–Sun)
    • Work start / end hours
  3. 3) Add sources
    Sources feed your drafts. You can mix different types:
    • X accounts (for replies / retweets rules)
    • RSS feeds
    • Websites / API URLs
    • Enable/disable sources anytime
    Each bot can have its own source list.
  4. 4) Draft with AI, then schedule
    Use “Preview with AI” to generate a draft, then schedule it.
    • The draft is designed to be standalone (under 280 chars).
    • You can add extra instructions per scheduled post.
    • Once it looks good, schedule it (one-time or recurring).
    NuxPulse stores the final draft you approve/schedule.
  5. 5) Control pacing with limits
    Set daily caps and minimum minutes between actions to avoid spammy behavior.
  6. 6) Verify results in Logs
    Logs show what was attempted and what succeeded (posts / replies / retweets), including errors when something fails.
Tip: if nothing is being sent, check bot enabled status, work hours, daily caps, and the Logs tab first.

Dashboard & tabs

Everything for a bot lives in one screen.

The bot page is split into clear tabs. Here’s what each one is for.

Overview

Quick KPIs, what’s pending next, and a short activity feed from logs.

Posts

Create scheduled posts (once/daily/weekly/monthly), edit pending ones, pause individual scheduled items, and manage the queue.

Replies

Allow replies for selected X sources and let the system respond under your rules (when enabled).

Retweets

Enable retweets from selected sources with a minimum likes threshold.

Personality

Define the writing style for the bot (tone, constraints, do/don’t). This is used for AI draft generation.

Sources

Manage input sources (X accounts, RSS, websites/API). You can enable/disable them anytime.

Settings

Bot identity (name/handle) + work schedule + caps + spacing. These are your guardrails.

Logs

The source of truth: what was sent, what failed, and why (error messages).

AI-assisted writing

Draft generation uses the OpenAI API. Scheduling and sending are handled by NuxPulse.

NuxPulse can generate draft posts from your sources and instructions. You stay in control: drafts are reviewed and then scheduled.

  • Drafts aim to be clear, standalone, and ≤280 characters.
  • The bot’s Personality + your per-post instructions guide the style.
  • If no source is available, the system can still produce a generic draft (less reliable).
Powered by OpenAI API
Draft generation is AI-assisted. NuxPulse manages scheduling, queue, and logs.

Guardrails (limits & pacing)

Prevent spammy behavior and keep schedules consistent.

Guardrails are simple but effective. If you hit a limit, actions are delayed or skipped (and you’ll see it in logs).

  • Work days + work hours: only act during allowed times.
  • Daily caps: max posts / replies / retweets per day.
  • Spacing: minimum minutes between posts / replies / retweets.
  • Per-action toggles: pause a bot, disable a source, or pause a single scheduled post.
If you’re unsure, start conservative (lower caps + larger spacing), then loosen once everything behaves as expected.

Data & privacy

What is stored, and why.
  • Scheduled posts: store the draft text you schedule and its timing/frequency.
  • Sources: store the list of sources you configured (URLs / X accounts).
  • Logs: store results of actions (success/error + message) to help you audit issues.
  • AI: draft generation calls an external API (OpenAI). Only what is needed to generate the draft is sent.

For legal/privacy details, refer to the Privacy Policy page if you publish one.

Troubleshooting

Most issues are scheduling/limits or credentials.

Nothing is being posted
Check: bot enabled, timezone/work hours, daily caps, spacing between posts, and whether scheduled posts are active + pending. Then open Logs for error details.

AI preview returns empty / error
Check OpenAI API key config, network access, and server logs for HTTP errors. Also confirm your prompt/instructions are not blank.

Retweets/replies don’t trigger
Check the allow_replies / allow_retweets toggles for sources, and any thresholds (like minimum likes for retweet). Verify activity in Logs.

Scheduled time looks “wrong”
Timezone: “scheduled_for” is stored in UTC. Make sure the bot timezone is correct when you pick a datetime-local in the UI.

FAQ

Short answers.

Do I need to write prompts?
No. But a simple Personality improves consistency (tone, do/don’t, emoji rules, etc.).

Can I pause everything quickly?
Yes: disable the bot, disable sources, or pause individual scheduled posts.

Where do I see what actually happened?
Logs. That’s the audit trail for posts/replies/retweets.

Does NuxPulse auto-post without review?
You schedule what you want. Drafts are generated, then scheduled as queued items.

Billing

Plan and invoices.
  • Upgrade/downgrade is handled via Stripe (if enabled on your instance).
  • Your plan can unlock higher limits or additional features (if you choose to enforce that).
  • If billing is not enabled, you can remove this section or keep it as “coming soon”.

Support

Need help or want a tweak?

Open a support ticket and include: bot slug, what you tried, and a screenshot of the Logs error (if any).