How To Library

Step-by-step help for getting started and making the most of Bot Commander.

These 46 topics come from the app’s built-in How To library. Available features depend on your installed version, workspace, permissions and connected services.

Updated October 21, 2026

Find a topic

Customers, Agreements & Invoicing

Turn a new customer agreement into an invoice, collect payment and reconcile the books.

CUSTOMERS, AGREEMENTS & INVOICING

Start here: choose the correct Business Workspace, open Accounting, then Customer invoices. The Customers, agreements & payments area contains Customers, Agreements, Invoices, Payments, Credits, Templates and Setup. Billing currently uses USD. Solo and Team follow the same workflow; Team access depends on your business permissions.

1. YOU HAVE A NEW CUSTOMER After a phone conversation or email agreement, save the contact in CRM with their name, company and billing email. Keep a record of what was discussed. In Accounting → Customer invoices → Customers, choose the CRM contact, enter the billing address and click Add customer. This adds a billing role without removing their other CRM roles. Select that customer in the customer selector before creating documents.

2. WRITE DOWN THE AGREEMENT, WHEN APPLICABLE Open Agreements. Enter an agreement title, scope, deliverables, dates, payment schedule and terms. You can save reusable wording under Templates and choose it as an optional template. Save draft agreement, review it, then Issue agreement. Use Download document to share it through your normal process. BC does not collect electronic signatures. Record acceptance is for an agreement signed outside BC: enter the signer name, signed date and signed document reference. Do not mark a verbal discussion as a signed agreement. An agreement is optional for an invoice; only accepted agreements appear in the invoice's agreement selector.

3. COMPLETE YOUR BUSINESS BILLING SETUP Open Setup. Choose an Invoice sender already configured in Settings → Email Setup, then Save invoice sender. Team businesses use their server's configured sender. Save default payment instructions such as who checks are payable to, the mailing address and how cash is accepted. New invoices copy these instructions; existing invoices retain their original details. For online payment, use Settings → Banks & Payments or the payment setup in billing. Connect Stripe or PayPal for the selected business. Sign into an existing business account, or follow the create-account link and complete the provider's setup. The guided form explains which account identifiers and credentials to enter. This is credential-based setup, not one-click provider authorization. Enter secrets only in those fields, never in chat or invoice notes. Start in Test / sandbox and verify a complete test payment before switching to live credentials. A saved connection alone does not prove the full checkout works. Test payments do not post to your real books. For a rehearsal, use a separate test business so issuing a practice invoice does not affect real receivables.

4. PREPARE AND ISSUE THE INVOICE Open Invoices → New invoice. Choose one of the four styles; add your logo and save a business default if desired. Fill in the title, business/customer details, invoice and due dates, descriptions, quantities, prices, discount, tax, payment terms and How to pay instructions. Link an accepted agreement if applicable. Under Accounting accounts, review the receivables, revenue and tax-payable mappings. Save draft → Preview invoice → Issue invoice. Review the PDF before sending. Draft PDFs are marked DRAFT. Issue only when the charges are final: issuing creates the invoice's accounting entries and outstanding balance. If your agreement calls for staged billing, invoice the amount due at that stage and describe it clearly; do not invoice the full contract twice.

5. ADD AN ONLINE PAYMENT LINK, IF NEEDED On the issued invoice, open Payment links. Select Stripe or PayPal and create the payment link for the remaining balance. Copy payment link, then paste it into the invoice email message. A link is not automatically inserted into the email or PDF. Only one provider link can be active per invoice. PayPal customer approval must be followed by capture before it is paid. Automatic capture is a separate opt-in setting; otherwise check status and use Capture approved PayPal payment when available. Returning to your website after checkout does not mark an invoice paid; BC verifies the provider receipt.

6. PRINT OR EMAIL Preview the invoice, then Print or Download PDF. To email an issued invoice, choose Review email, check the recipient, subject and message, then Prepare email & PDF. Review the prepared message and attachment, tick the review confirmation and click Send invoice. Preparing an email does not send it. If delivery is uncertain, use Check previous delivery rather than repeatedly sending.

7. RECORD THE MONEY RECEIVED Cash: open Payments, choose the issued invoice, select cash, and enter the amount, received date and cash account. Click Record payment. Check: select check, enter its number/reference and received date, and record receipt. Later use Record deposit and Record clearance as those events occur. A check arriving in the mail is not the same as clearing the bank. Card or PayPal paid elsewhere: record the completed payment with its reference, destination/clearing account and any processing fees. This form records money already received; it does not charge the customer. Payments through BC links: use Check payment status, or enable automatic receipt checks. Keep the desktop host or business server online for automatic updates. Confirmed live receipts update the invoice balance and accounting; do not manually enter the same payment again. Partial recorded payments leave the remainder outstanding. If a payment link is open or its outcome is uncertain, reconcile it before recording another payment. For an uncertain PayPal capture, check status instead of capturing again. Follow the recovery instructions for an unknown order/session.

8. RECONCILE AND FOLLOW UP Review each invoice's remaining balance and the customer's outstanding total. Match receipt references, processing fees and bank/processor deposits. A processor payout reaching the bank is not a second sale; avoid adding duplicate income. Bank feeds and payment processors serve different purposes and should be reconciled together. Use Accounting reports to review the resulting entries. Follow up on unpaid invoices through your normal customer process. Download payment receipts when needed.

9. CORRECT MISTAKES WITHOUT HIDING HISTORY Use Cancel unpaid invoice for an eligible unpaid issued invoice, with a date and reason. Use Credits for adjustments to charges or tax. Record a refund only after returning the money outside BC: the refund form does not transfer funds. Use Correct or reverse payment for an erroneous payment record, with the reversal date and reason. These actions preserve the correction trail.

Example: a customer agrees to a service project. Save the CRM contact, designate the billing customer, document the agreement if needed, invoice the agreed amount now due, review and deliver it, then record cash/check receipt or reconcile a verified provider payment. Finish by checking the invoice balance and matching the deposit without counting the income twice.

Back to contents

Research on X

Find current conversations, feedback and opportunities with dated source links.

Ask your Commander or a specialist with web-research access: “What are small-business owners on X struggling with this week?” “Read this X thread and summarize its evidence: [link].” Or “Compare recent reactions to these products and link the original posts.” For creator rankings or follower counts, ask for direct X profile lookup: research_x with profile_handles uses your saved X/Twitter bearer token and X API read access, without an xAI key. For broader conversation research, the dedicated research_x tool uses xAI X Search independently of the agent’s chat model; choosing Grok as a chat model is not required. It uses your configured xAI API key, not your X posting credentials. Ask for a date range, specific handles, competitor feedback or a concise research brief. Results include original source links and the dates searched; posts are evidence of what people said, not verified product claims or a representative poll. No X posting account is required for this public research. Missing xAI access or quota is reported clearly. xAI charges for model tokens and fetched posts/profiles; a four-turn research limit is not a hard dollar cap. Auto Ops retains the paid-tool permission gate. Research does not send replies, contact anyone, schedule or publish content. To use findings for acquisition, ask the team to propose one evidence-backed test for your review. Provider-reported usage is saved with the research receipt. See https://docs.x.ai/developers/tools/x-search for current capabilities and pricing.

Back to contents

Primary Products

Save product facts, audience, proof, CTAs and reusable artwork.

Welcome to Primary Products. This page is the source of truth for the products, services, brands, games, or offers Bot Commander should market. A good Primary Product profile gives Campaigns, Video Studio, Blogs, Newsletters, and AI Influencers the context they need without making you retype the same details every time.

1. Click Add Primary Product when you need to create one manually. 2. Fill in Basics: name, website or landing page, what the product is, and the target audience. 3. Use Pull Features from Sources to let Cam assemble a starting catalog from the owner's Features.md or equivalent product files, release notes, saved product description, and website Features page. Review what the feature does, its customer benefit, proof, release version, and availability. Manual paste is only a fallback. 4. Use Create Owner Ideas from Features when you want Jervus and the marketing team to propose feature-led reels and campaign material from the owner-reviewed catalog. 5. Fill in Marketing Context: offer/value, positioning difference, proof or objections, and competitors or alternatives. 6. Set CTAs and campaign defaults so generated content points people to the right next action. 7. Add product assets such as logos, Direct images, reference images, and end cards when available. 8. Assign an AI Influencer or spokesperson if this product should have a consistent face or voice. 9. Add Reel style rules when different topics should use different visual styles. 10. Pick a product in Campaigns, Video Studio, Blogs, Articles & Newsletters, or Posting Queue so BC can reuse this profile as context.

Tip: keep this list focused. Primary Products are not an inventory catalog. Add the offers that need their own audience, CTA, proof, assets, or AI Influencer.

Feel free to ask me to tighten a product description, identify missing proof, write CTAs, compare competitors, or turn this profile into a campaign, reel, blog, or newsletter.

Back to contents

Video Studio

Build and review scenes, narration and images, then render a video.

Welcome to Video Studio. This page turns product context, campaign ideas, news stories, images, narration, and templates into rendered video assets.

1. Start on Video Home and choose a 16:9 or 9:16 template. 2. Use Primary Products first so brand, CTA, URL, logos, end cards, style rules, and AI Influencer defaults can flow into the reel. 3. Use Reel Context to choose the product, AI Influencer, voice, CTA, and supporting context. 4. Pick a news/source item when available, or describe the video you want in the prompt. 5. Use Send to generate scenes, narration, image prompts, and draft visuals. 6. Review each scene for image, caption, voice line, timing, and brand fit. 7. Use Generate Image or Choose Image for any missing or weak scene visual. 8. Use Render when every scene has the media and narration it needs. 9. Review the rendered video, then publish it directly to your connected channels when it is ready. 10. Save Draft or Open Project when you want to reuse or continue a video setup later.

Tip: Video Studio is downstream of Primary Products, Image Studio, AI Influencers, Campaigns, News Center, and Review Queue. Clean product assets and clear CTAs make better reels.

You can ask me to create a storyboard, rewrite the narration, adapt a video for 9:16 or 16:9, tighten the CTA, or inspect a draft before rendering.

Back to contents

Business Planner

Find a direction, validate an idea or improve an existing business.

Welcome to Business Planner.

This is where you build your business foundation before marketing it. You have three paths to choose from:

Start a Business — First tell us whether you already know the business you want to start. If yes, confirm its name and what it sells, skip idea discovery, and begin Validation. If not, you can optionally explore your True Calling before a six-question Business Basics conversation. Bot Commander asks one question at a time and reuses facts already saved in Business Details or Primary Products.

Move My Business to Bot Commander — You already run a business elsewhere. Four fast stages get your existing business profile, website, tool connections, and operations into Bot Commander so your AI team can take over marketing and daily work.

Fix My Business — Something isn't working and you need a diagnosis. Six stages audit your health, revenue, operations, sales, team, and growth plan to find what's broken and build a turnaround.

How to use this page: - Click any card to enter that path - For Start a Business, choose whether you already have the idea - You'll see a guided interview card with a question from Bot Commander - Type your answer and press Enter, or click Speak Answer - Bot Commander confirms what was heard before moving on - Your progress saves automatically — pick up anytime - Business Basics covers only: name, what you sell, who needs it, the problem, proof of demand, and your biggest constraint - When those basics are ready, use Start Growing My Business to begin a measurable campaign recommendation. Continue Business Setup and Review Business Details remain available as secondary actions

Back to contents

Start a Campaign

Give the team a clear marketing priority and review its recommendation.

Welcome to your Marketing command center.

This page gives you one clear way to begin. Bot Commander runs one Primary Campaign at a time so the strategy, production, approvals, distribution and results stay connected.

How to start a campaign: - Click Start a Campaign - Choose what matters most right now: more customers, more sales or launching something - Choose the product or service to grow when more than one is configured - Optionally paste a product, competitor or campaign link you want the team to investigate - Bot Commander reads your saved business foundation and connected accounts, then coordinates market research with Marketing Manager and the specialist team - The team returns a campaign recommendation containing evidence, priority audience, message, plan, channels and a measurable definition of success

Nothing goes live during research. The new campaign remains paused until you inspect the recommendation and explicitly approve and start it.

After the recommendation is ready: - Review the strategy and the evidence supporting it - Change anything that does not fit your business - Approve and start the campaign when you are satisfied - Auto Ops then coordinates approved production, owner review, distribution and results tracking within your boundaries - Publishing, spending and other protected external actions still wait for your approval

Managing campaigns: - Click Open Existing Campaigns to see the Primary Campaign and its current status - Campaign Automation and advanced testing controls belong to that selected campaign - Ended campaigns remain available as read-only archived history - Pause the Primary Campaign whenever you want new campaign work to stop

Before you begin: - Make sure your main product or service is saved under Products - Connect the accounts you expect the campaign to use - You do not need to write a complicated prompt; the kickoff asks only for the decision the team cannot safely infer

For video research, Owner Ideas and reel preparation, open the Campaigns guide in How To’s.

Back to contents

Social Media Monetization

Track program requirements, evidence and enrollment readiness.

Welcome to SM Monetization. This page turns social-platform revenue program requirements into measurable operating goals.

1. Start a tracker for a supported monetization program. 2. Confirm the account handle and current official program thresholds. 3. Record verified metrics and mark prerequisites Met, Not met, or Unknown. 4. Enable Jervus monitoring and choose a daily, weekly, or monthly audit cadence. 5. Jervus checks live platform evidence, updates the tracker, calculates remaining gaps, and reports rule changes. 6. Bot Commander marks the goal Ready to enroll only when every tracked metric reaches its target and every prerequisite is marked Met. 7. Jervus sends the audit result to desktop and mobile. A completed eligibility transition receives a distinct Ready to enroll alert.

The platform remains the final authority. Bot Commander does not enroll, accept terms, connect payouts, or publish content without owner approval.

Back to contents

AI Providers

Choose connected AI models and understand provider costs.

Open Settings → AI to select your provider and model. Add the matching provider credential in Settings → Credentials and use the available connection test. Local models need their local service running. A specialist may use its own provider/model override; check the AI Bot Team if it behaves differently from your Commander. Structured production can also use the configured structured model. The app is free; connected providers may charge for text, image, voice or video generation. Their limits and prices are separate. Cloud-connected work sends the inputs needed by that provider. If a task reports missing credentials, an exhausted quota or no complete output, check the provider and assigned model before retrying. Changing a model does not approve or publish queued work.

Back to contents

Alliance Chat

Join the community and keep track of unread messages quietly.

Open the chat drawer and choose Alliance, or use Astra Alliance → Open Alliance Chat. Sign in to read and send community messages. Local AI conversations and files are not posted automatically. New messages from other members show an unread badge on the Alliance tab and the closed chat drawer. Open Alliance while the app is in focus to mark messages read. Sound is off by default: enable Sound for first unread message only in Alliance chat if you want a brief chime. Further messages stay silent until you open the chat. Existing history and reconnects do not chime. Read position is saved for this account on this device. Use Report or Block on another member’s message when needed.

Back to contents

Auto Ops

Set objectives, control team assignments, resolve blockers and inspect saved results.

Auto Ops is where you manage your AI team's objectives, assignments, progress and operating limits. Jervus coordinates eligible work, delegates to specialists, checks saved results and brings decisions back to you. The available tools and connected services determine which assignments can actually run.

WHAT YOU MANAGE HERE • Objectives: define the outcome, success criteria and priority for work you want the team to pursue. • Assignments: see which specialist is working, what is queued and what each assignment should deliver. • Operating boundaries: control the mode, working hours, concurrency and maximum open steps. • Decisions and blockers: answer owner questions, review approval requests, repair a failed branch or retire work you no longer want. • Results: inspect completed assignments and the actual saved deliverables. Keep objectives narrow and give each one a clear finish line. Broad objectives can create unrelated assignments. Code changes, builds and command execution need the development workflow; they are not available through the current Auto Ops specialist assignments.

GET STARTED 1. Select the correct business. Review Objectives and pause anything you do not want pursued. 2. Add one concrete objective and measurable success criteria. For example: review the existing customer onboarding instructions, save a list of unclear steps, then stop for my review. Ideas for useful ongoing work offers podcast showcases, useful X reply drafts, reel performance learning, How To series, feature demos and hook research. Use an idea fills the editable objective form; nothing starts until you add the objective. Each uses your own business facts and selected presenter. The coordinator can draw on these ideas within an agreed goal and plan. Completed drafts are not published results; another pass needs fresh evidence, and posting retains its approvals. 3. Choose an operating mode: Observe reads and assesses; Draft also prepares internal drafts; Governed can run approved work within your boundaries. Publishing, sending, account changes, destructive actions and financial actions still require owner approval. 4. Set working days, start/end times, concurrent claims and maximum open steps per objective. Matching start/end times allow 24-hour operation on the selected days. 5. Click Start Auto Ops. Run now requests a work cycle inside the current boundaries; it does not bypass approvals or operating limits.

SPENDING AND UNKNOWN COSTS The default daily AI limit is $5. Choose another amount, set zero to stop spending, or select No Limit. Auto Ops reserves funds before metered AI requests, including retries and delegated work. Successful requests with usage counters release unused reservations; uncertain failures keep their reservation. The total is a conservative estimate, not a provider invoice. It resets at midnight on the host running the work. Direct chats and separately configured campaign/news schedules have their own controls.

When a provider/model or tool has no verified price, the affected step pauses and Auto Ops asks whether you wish to allow it to run. Choose Allow for today, Always allow this tool, or Keep paused. Always allow is saved across restarts and days for that tool; revoke it in the permission history. It does not approve publishing or disable activity monitoring. Permission applies to that provider/model and endpoint, or that tool, until midnight on this host. Allowing unknown charges can take your actual bill above the daily limit because those charges cannot be counted reliably. No Limit still asks about unknown costs. Other action approvals still apply. Allow for today makes the affected blocked assignment eligible to resume within the remaining operating limits.

WHERE TO SEE THE RESULTS • Working / Next: current assignments and queued steps. • Waiting for you: an owner question or approval. Read the proposed action, cost, affected people/data and prerequisites before answering. • Blocked: a branch could not finish. Have Jervus repair it with useful direction, or retire the branch. Other eligible work can continue unless a shared prerequisite or operating limit prevents it. • Completed and the Ops Report: recorded outcomes and recent team activity. Assignment counts are not customer acquisitions or sales. • Saved work: read the actual documents associated with active campaign objectives. Campaign Workspace also holds campaign documents.

PROACTIVE DISCUSSIONS With Auto Ops enabled and an unfinished objective, the coordinator invites you to discuss additional activities after 30 minutes without queued, running, blocked or approval work. One unanswered discussion stays open; polling does not repeat it. The notice uses the existing unread Auto Ops indicator and shared chat. Say Later to be asked when, or use a relative delay such as In two hours. Explicit delays survive restarts and the follow-up waits for working hours. Discussing and postponing do not start a new plan. A scheduled morning check remains separate and honors an explicit future delay.

TRACK FOLLOW-UPS Use To-Do → Work for durable next actions, priorities, notes and due dates. The chat checklist tracks steps within that conversation. They are separate records: a completed chat step does not automatically complete a Work To-Do or an Auto Ops objective. Record a clear deliverable and keep the relevant record updated.

CONTROL THE WORK Refresh reloads the displayed state. Stop new work prevents new claims; it does not undo completed actions. Pausing an objective removes it from active pursuit. Retiring a request or branch preserves its history. Campaign reel schedules and news scan frequency are configured in their own areas; changing Auto Ops objectives does not change those schedules.

Back to contents

Campaigns

Manage sources, research videos, emulate selected hooks, prepare reels and review results.

Campaigns is where you manage campaign sources, automation, reel drafts, review and results. Select the campaign you want to work on before changing its settings.

GET STARTED 1. Campaigns opens in Ad Sources. Choose the ideas and approved copy for your selected campaign. Use Campaign Settings for campaign creation and management. 2. Choose Ad Sources to manage News Center Ad Copy, Team-Generated Ad Copy and Owner Ideas. These libraries are shared within the business. The Campaign calendar sits directly below Sources and Campaign Automation; use Edit Schedule there. Campaign Settings holds strategy and campaign management, with Past campaigns for history. 3. Open the separate Campaign Automation panel between Ad Sources and Campaign calendar to choose the source mix and schedule for the selected campaign. In Use source mix mode, percentages allocate distinct reels across the whole batch, rounded to whole reels—not individual platform placements. Eight reels at 50% Owner Ideas and 50% Team-Generated means four of each. Product mix is separate. The planner checks product, approval and format availability; an unavailable mix needs more approved sources or adjusted settings. Explicit source-priority and focused experiment modes have their own selection rules. 4. Open Review Queue to check finished content and destinations before approving publication. Choose Results for outcomes; detailed diagnostics and experiments stay collapsed until you need them. Publishing status appears in Posting Queue.

FACEBOOK COMMENT TO LINK Open the Facebook Comment To Link panel in Campaigns. Enter your offer, who it is for and the word people should comment. Jervus coordinates the landing page, three image styles, post captions and matching private replies, then returns the saved work for review. Your own website handles the Facebook comments and replies. Connect its HTTPS PHP/MySQL relay in Website Studio, install the included Facebook integration there and connect your Facebook Page here. Use your own Facebook app credentials in Social Media settings; Meta may require permissions or review before public use. Bot Commander does not host this service for other businesses. Review the saved landing page and each post. Accept delivery setup for testing, choose an existing Page post and test each style with its one-use comment. Check the actual Messenger message and its link before confirming receipt. A Facebook acceptance receipt alone is not a successful delivery test. Approve the finished posts in Review Queue after the tests pass; publishing then binds each actual post to its own reply and tracking link.

VIDEO RESEARCH Open Campaigns → Ad Sources → Video Research. Set your niche and minimum views, then click Find videos. Inspect the original videos and choose Emulate this for the ones you want adapted. Check each platform’s search results and access status; a listed platform does not mean discovery is working. Completed adaptations appear under Ad Sources → Owner Ideas as unapproved drafts. Selecting a video does not approve, render or publish a reel.

OWNER IDEAS AND REELS Click Edit on an Owner Idea to review its proposed narration, select the product and reel format, and assign images. Draft narration is saved separately from script approval. Use up to six content sentences. Optionally choose a title image and up to four images per sentence; drag images to reorder them within their group. An empty title slot or sentence group generates one image at render time using your configured image provider and reel format. Selected images remain unchanged. The title is silent and the configured end card handles the spoken CTA, so leave that CTA out of the narration. Use the pacing controls to give images more time. Save Changes and check the save confirmation. Approve the script and confirm any selected image assignments before rendering. Empty slots can be generated; unassigned images and stale assignments still need review. Check the Owner Ideas you want included in campaign rotation. Run Now requests a render from that source; inspect the resulting asset in Review Queue before publication.

CHECK RESULTS AND FAILURES The dashboard shows production progress and publishing status. Review the selected campaign’s activity and failure records for the exact source title, date and error. A failed render has no completed video to review; return to its source to correct the problem. An asset count below the planned target alone does not identify which reels failed.

CONTROL THE CAMPAIGN Pause the campaign to stop its scheduled campaign work. Campaign Automation controls belong to the selected campaign. Auto Ops coordinates team assignments under its own operating boundaries; video scans start with Find videos here in Campaigns.

Back to contents

To-Do List

Track personal and work actions, priorities, due dates and CRM follow-ups.

Personal To-Dos and Business Tasks have separate pages.

1. My Home → Personal To-Dos holds your private reminders. 2. Business → Tasks holds work for the selected Business Workspace. Current private-business tasks stay on this computer; shared assignment will use the new workspace server. 3. Add an item, priority and optional due date. A deadline appears on Calendar; it does not automatically schedule a reminder. 4. Click an item to edit it. Check its box when complete. 5. Choose Remind me to set a time, sound or system voice, volume and quiet hours. Reminders run on this computer while the app is open. You can snooze an alert for ten minutes. 6. Completing or deleting an item stops its pending reminder. A business task can link to a business contact. 7. Calendar can show personal and business deadlines together, labeled by workspace. Your Personal To-Dos remain private.

Use the X to delete an item only when you no longer want its record.

Back to contents

Review Queue

Inspect generated content, edit it and decide what to approve for publication.

Welcome to the Review Queue. This page is where you approve, edit, and publish the reels, posts, images, and assets your AI agents create.

1. Use the tabs at the top to filter by Today's Queue, Upcoming, or All Items. 2. Use the Status filter to focus on Needs Review, Approved, or Rejected items. 3. Each card shows the content type (Reel, Post, Image, Blog, etc.), the agent who created it, and the target product. 4. Click View Full Packet on influencer candidate cards to see detailed profiles. 5. Click the play button on reel cards to preview the video. 6. Approve items you want published — they move to the approved section at the bottom. 7. Reject items that aren't right — the agent can revise them. 8. Edit the post text, platform targets, or hashtags directly on each card before approving. 9. Approved posts move to the Posting Queue and appear in its Posted Log once they go out. 10. Approving a campaign run schedules it for the same calendar day. If the preferred times are full or have passed, approval uses remaining gaps today. An explicit posting date still takes precedence; approval never silently moves a day's run into tomorrow.

Tip: Campaign prep runs automatically and fills this queue. Check it regularly to keep your content pipeline moving.

Back to contents

Posting Queue

Schedule approved posts and check their publishing status.

Welcome to the Posting Queue. This page is where you schedule and track every social post Bot Commander sends across your connected platforms.

1. Use the Queue tab to see upcoming posts — when they go out, which platform, and which agent is handling them. 2. Click Now on any queued post to send it immediately, or ✕ to cancel it. 3. Use the Calendar tab to see your scheduled posts laid out by date. 4. The Connections tab shows which platforms are linked — connect new ones in Settings → Social Media. 5. The Posted Log tab shows every post that has already gone out, with status and links. 6. Click + New Post to compose and schedule a post — pick a platform, write or AI-compose the text, and choose when it goes out. 7. The scheduler runs automatically, picking up any post whose time has come.

Tip: Community Manager auto-schedules live on the Community Managers panel, not here. Posting Queue is for approved posts waiting to publish and posts you manually schedule.

Back to contents

Community Manager

Connect a Discord host, verify AI replies, and configure recurring community posts separately.

Welcome to Community Manager. Use the Discord setup below for live community replies. Recurring multilingual announcements are configured separately; making a schedule does not enable a chatbot listener.

Choose the workspace and hosting location

1. Select the business that owns this community before saving credentials or editing its agent. Live replies, recurring announcement schedules and optional moderation are separate controls. 2. For desktop hosting, keep Bot Commander running, the computer awake and the internet connected. Closing the desktop or sleeping the computer stops its live host. Team/server-managed communities use the selected Team workspace’s Community Managers and server AI settings; their server must stay running. The desktop Discord Host Mode instructions below configure the desktop listener. 3. Use only one listener for each bot token. Disable an existing desktop or other host before enabling the same bot on a Team server, and vice versa, to avoid competing listeners or duplicate replies.

Create the Discord bot and invite it to your server

1. Open https://discord.com/developers/applications, create or select your application, then open Bot → Token. For a new bot, click Reset Token if the portal requires it to generate the first token, then copy it. For an existing bot, reuse its protected token if available: resetting invalidates the old token and requires updating every host using it. Store the token in Bot Commander settings, never in a chat, screenshot or support message. 2. On the Bot page, enable Server Members Intent and Message Content Intent, then save. The current live host requests both, even if you only plan to use replies. Presence Intent is not requested or needed by this host. If Discord requires approval for a privileged intent, complete its approval process first; Bot Commander cannot grant that access. 3. Open the application’s Installation page. Choose Discord Provided Link if offered, then Default Install Settings → Guild Install and the bot scope. For ordinary text-channel replies grant View Channels, Send Messages and Read Message History. Copy the Install Link, open it, choose Add to Server and the intended server, then authorize; you need Manage Server permission. Slash-command setup is not required for ordinary @mention replies. 4. Do not grant Administrator, Manage Roles, Manage Channels or Manage Webhooks just for chat. Add Send Messages in Threads only if you intend to use threads and have verified that workflow. Check channel/category permission overrides as well as the bot’s server role.

Save the token and the correct Discord IDs

1. In Discord, open User Settings → Advanced and enable Developer Mode. Right-click the server icon → Copy Server ID. Right-click the intended text channel → Copy Channel ID. These are different IDs; neither is the application’s Client ID. 2. In Bot Commander open Settings → Social Media → Discord. Paste Bot Token and Server ID (Guild ID). Set Default Channel ID and, if needed, the dedicated Announcement Channel using channel IDs, then click Save. Keep the server ID out of the channel fields. 3. A saved token or a Connected indicator does not prove the AI can answer. Refreshing a channel list checks Discord access, not the selected model, its credentials or billing.

Choose and check the community host’s AI

1. Open AI Bot Team, find the deployed Community Host / Discord Manager and choose Edit. Use the agent’s role to identify it if you renamed it. Choose its Provider and Model, then Save Changes. Default uses the configured AI defaults; a specialist can use a different provider/model from your Commander. 2. Configure the matching AI provider connection in Settings → AI Providers. The Discord Bot Token is not an AI API key. The model must be available to that provider account with sufficient quota or credit; a local model also needs its local service running and the model loaded. 3. Ask your Commander to have that community host answer one simple question inside Bot Commander. This can incur provider charges. A successful answer checks that agent’s AI route; it does not establish that Discord live hosting is enabled.

Enable desktop Discord Host Mode

1. In the same community host’s Edit form, scroll to Discord Host Mode. Once Bot Token and Server ID are saved, check Enable host mode. Click Refresh from server and select the intended Active channels. 2. For the first test, turn Mention-only mode on. When it is off, selected channels can receive unmentioned replies; the host may stay quiet during other people’s conversations. Direct @mentions can also trigger replies in other channels the bot can view. Restrict its Discord channel permissions if it should only access particular rooms. 3. Set Cooldown (seconds) to avoid rapid repeat replies. AI replies use your selected provider and may incur charges. Monitor provider usage; do not treat the displayed Daily budget (USD) as a guaranteed hard spending cap. 4. Click Save host config and allow the host to reconnect. This saves the listener settings separately from the agent’s Provider/Model and Save Changes.

Test one live reply and diagnose an error

1. In the chosen Discord text channel, send one simple question that directly @mentions the actual bot account. Keep Bot Commander running and wait for its reply before repeating the test. This sends a real reply visible in that channel and can incur AI-provider charges; use a test channel if appropriate. 2. If it cannot fetch channels or connect, check the bot token, server ID, server installation, channel permissions and both required privileged intents. If Discord connects but a question fails, check that community host’s exact Provider/Model and its key, model access, quota and local-service status. The Commander working with a different model does not verify the host’s model. 3. Check Bot Commander’s private chat for a Discord AI-provider failure notice, currently sometimes labeled Echo, with available provider/model/error details. Recognized Discord provider failures are kept private instead of posted into the community. A missing reply can also reflect mention mode, channel access, cooldown or a paused/closed host; it does not by itself identify a provider fault. 4. For support, record the app version, operating system, time, platform, provider/model and exact error or screenshot. Settings → Data → Logs offers View Today’s Log and Open Folder; share only the relevant error-time excerpt after redacting tokens, API keys and private conversation details. Not every host error appears in the structured daily log. Never share your credentials or entire data folder.

Enable moderation only if you want it

1. Moderation is optional and separate from live replies and recurring posts. Community Managers exposes the Discord Moderation controls. It can cover the server beyond the Active channels used for replies, so review that scope before enabling it. 2. Deleting spam requires Manage Messages in the relevant channels. Grant Moderate Members only for timeouts, Kick Members only for kicks, or Ban Members only for bans when you deliberately choose those actions. The bot’s role must be above members it needs to moderate; Discord’s owner and role restrictions still apply. Administrator is not needed for ordinary hosting.

Recurring announcements to Discord or Telegram

1. Click + New Schedule to create a new community post schedule. 2. Pick a destination platform — Discord or Telegram — then enter the channel ID or chat ID, not the Discord server ID. Save the platform credentials first. 3. Choose the agent who will write the posts. Auto-agent resolution picks the right persona for each platform (Community Host for Discord/Telegram groups, Social Influencer for Telegram channels). 4. Select your languages and set weights — higher-weighted languages post more often. Each language posts in its own timezone window so messages arrive at local-friendly hours. 5. Pick a content mix from categories like Product Tips, Community Questions, Behind the Scenes, and more — or write your own prompt hint. 6. Set the cadence: daily, weekdays, M-W-F, weekends, or custom days. Choose once-a-day at a specific time or every N hours. 7. Set an active window to keep posts within reasonable hours in your audience's timezone. 8. Click Save to enable the schedule at its configured cadence. Run Now generates and sends a real post; it is not a preview or a test of live question-answer hosting. Choose a test destination first if needed, and check the reported result before trying again. Use Pause to temporarily stop, Edit to adjust settings, or Delete to remove it.

The scheduler selects languages by weight and requests new content from the chosen agent using its persona and content mix. Fresh generation does not guarantee unique wording. Desktop schedules need the desktop running; Team/server schedules use that business server’s supported controls. Provider charges and platform delivery permissions still apply.

Back to contents

Image Studio

Configure image providers, generate images and browse your library.

Welcome to Image Studio. This page lets you generate AI images using OpenAI, Pollinations, or Google image models, browse your library, and use images across Bot Commander.

1. First, switch to the Configuration tab and add at least one provider API key — OpenAI, Pollinations, or Google. 2. On the Create Image tab, write a prompt describing the image you want. Be specific about subject, setting, mood, and lighting. 3. Choose a Style preset — Cinematic, Photorealistic, Concept Art, Anime, and more — or leave it on Auto. 4. Optionally upload a Reference Image to guide the generation (OpenAI models only). 5. Pick your Image Provider, Size / Aspect Ratio, and Model, then click + Generate Image. 6. Your images appear in the Image Library on the right — click any thumbnail to see a Live Preview. 7. Use the Copy button to grab the image to your clipboard for pasting anywhere. 8. Browse pages with the Prev / Next pager, or use the filename search to find specific images. 9. Images are saved to your local Bot Commander image directory and can be used in Campaigns, Blogs, Posting Queue, and Reel Studio.

Tip: The more specific your prompt, the better the result. Include lighting, camera angle, color palette, and mood for cinematic quality.

Back to contents

Avatar Studio

Create presenter profiles and generate talking-head videos.

Welcome to Avatar Studio. This page lets you create reusable AI presenter profiles, generate talking-head videos, and connect video providers like HeyGen.

1. Start on the AI Influencers tab — click Create AI Influencer to build a new presenter profile from an existing AI Team agent or a brand-new persona. 2. Each influencer card expands to let you set a name, assign an AI Team persona, pick a Reel narration voice, define the presenter tone and personality, and write a spoken CTA line. 3. The readiness chips (Persona ready, Voice ready, Image ready, HeyGen bound) show what each influencer still needs before it is camera-ready. 4. Switch to the Create Video tab to generate a talking-head video. Pick a speaking agent, orientation, render engine, and write a script — then click Generate AI Influencer. 5. Generated clips appear in the Clip Library below the preview. Click any clip to load it into the preview player, or delete clips you no longer need. 6. Use the Configuration tab to connect your HeyGen API key. Once saved, use Load my avatars & voices to pull in your HeyGen assets for binding on each influencer card. 7. HeyGen bindings are optional — AI Influencers work without them for Reel voiceovers using the narration voice and personality settings.

Tip: Configure your presenters here first, then use Video Studio to create Reels and Shorts with their voices and personas.

Back to contents

Cinematic Clips

Create video clips with your configured generation provider.

Welcome to Cinematic Clips. This page lets you generate high-quality cinematic video clips using Runway, Seedance 2, or Seedance 2.5.

1. Start on the Create Clip tab — write or paste a text prompt describing the scene you want to generate. 2. Choose a provider: Runway for Runway/Veo models, or Seedance for Seedance 2 and 2.5. 3. Choose your aspect ratio: horizontal 16:9 for YouTube/widescreen, vertical 9:16 for Reels/Shorts/TikTok, or square 1:1. 4. Select a duration and model/provider settings. Seedance 2 supports 4-15 seconds. Seedance 2.5 supports 4-30 seconds or Auto. Runway models use fixed duration choices. 5. Click Generate Cinematic Clip to start rendering. Generation typically takes 1-3 minutes depending on provider, model, and duration. 6. Generated clips appear in the Clip Library below the preview player. Click any clip to load it into the preview, or delete clips you no longer need. 7. Use the Configuration tab to connect a Runway or Seedance API key. Without a key for the selected provider, generation will not work.

Seedance 2.5 can animate a reference image from the studio. Bot Commander uploads local reference images through your configured public media storage because Seedance requires public HTTPS media URLs. Agents can also use Seedance 2.5 reference image, video, and audio URLs for editing, extension, and style or character guidance.

Tip: Cinematic clips can be sent directly to the Review Queue for approval, or forwarded to the Posting Queue for scheduling across your connected platforms.

Back to contents

Blogs, Articles & Newsletters

Draft, edit and prepare long-form content and newsletter campaigns.

Welcome to Blogs, Articles & Newsletters. Here are the steps to use this page:

1. Choose a format: Blog post, LinkedIn article, Medium article, or Newsletter issue. 2. Choose the Product focus so the draft uses the right product, audience, offer, and CTA. 3. Add Source Materials, company news, product updates, or outline notes so the writer has real context. 4. Choose the writing agent and tone, then click Write draft. 5. Review and edit the draft in the Draft Workspace. Use Markdown, HTML Preview, or Split view. 6. Add or generate a feature image when the content needs a visual. 7. Save the draft to the library so it can be reused or finished later. 8. Publish blog content to the website, publish/adapt LinkedIn content, or open Medium manually. 9. For Newsletter issue, connect Brevo first if needed: see How To's → Email Setup → Brevo Newsletter Sending. If the newsletter has a feature image, also connect DigitalOcean Spaces or another public image host so inboxes can load it. 10. Set the newsletter audience, sender, subject, preview text, and test recipient, then create a newsletter draft and send a test. 11. Use the same source material to turn one weekly update into a blog post, LinkedIn post, and newsletter.

Feel free to ask me for a topic, outline, subject line, CTA, rewrite, newsletter version, or publishing checklist. I'm here to help!

Back to contents

Project Files

Browse, search and organize local workspace files.

Welcome to Project Files. This is your local file browser for your Bot Commander workspace.

How to Use 1. Browse the file tree to navigate your project folders — click any folder to expand or collapse it 2. Use the search bar to find files by name across your entire workspace 3. Click Open Folder to open your workspace folder 4. Click + Folder to create a new folder at the current location 5. Hover over any file or folder to reveal Rename and Delete options 6. Drag files between folders to reorganize your project structure 7. Use Fill PDF form to choose a local AcroForm PDF, enter text/checkbox values, prepare a copy, review the PDF and save it. The original is preserved. Scanned/XFA/encrypted forms and digital signing are unsupported. Add the saved copy with Add file if you want it in this workspace; no automatic upload or email occurs

Tip: Project Files is your local workspace — it is not cloud-synced. Use the Backup panel in Settings to create snapshots of important work.

Back to contents

Partner Outreach

Research potential partners and review outreach plans.

Welcome to Partner Outreach — your amplification partner network command center, managed by Simone (Partner Relations).

This page tracks every creator, podcaster, media outlet, ecosystem brand, platform team, and community admin who might amplify your content. Simone owns the program; you approve the moves.

STATS GRID — At the top you will see: - Partner Outreach — total contacts in your network. - Amplifications (30d) — how many times partners shared or engaged with your content in the last 30 days. - Partners Who Amplified — how many unique partners have amplified you. - Pending Candidates — new partners Orion discovered that need your review. - Advocates (3+ amps) — partners who have amplified 3 or more times — your superfans. - Candidate Approval Rate — what percentage of discovered candidates you approved.

PIPELINE STAGE BAR — Shows your network broken into six stages: Discovered → Qualified → Contacted → Engaged → Amplifying → Advocate. Each stage shows the count. The goal: move partners right.

CADENCE GUARDRAILS — Configure how often you can touch a partner: - Cooldown days between touches (default 7). - Max touches in 30 days (default 4). - Stale threshold — partners with no touch for this many days appear on the Stale Radar.

AT-RISK CONTACTS — Partners in cooldown or at their touch limit. Use the action buttons if you need to manually create a follow-up task, log a conversation, log a touch, or log an amplification.

PARTNER CADENCE MATRIX — Every partner in a scrollable table showing name, handles across platforms (X, IG, TT, YT), pipeline stage, touches, amplifications, last amplified date, last touch, and status.

STALE PARTNER RADAR — Read-only list of partners who have gone cold. Simone reviews these in her daily sweep — no action required from you.

MESSAGE TEMPLATES — Ready-to-use outreach templates you can copy: X DM first touch, X DM follow-up, and email introduction. Click Copy and personalize before sending.

RECOMMENDED OUTREACH SEQUENCE — Simone's recommended 5-step cadence: Day 1 warm intro → Day 3-5 tag in a post → Day 7 follow-up DM → Day 14 email if warm → Day 30 final touch or move on. Never automate — every message should be personal.

RECENT PARTNER EVENTS — Last 12 campaign events related to partners. See what Simone, Orion, Tommy, and Grant have been doing.

SIMONE'S DAILY RHYTHM — Every day at 10 AM, Simone runs a sweep that produces: 1. Candidate reviews from Orion's discoveries. 2. A Partner Mention Brief for today's reel generation. 3. Repost Radar — partner content worth resharing. 4. Amplification recognition posts. 5. Pipeline pulse — who's cold, who's rising. 6. Three outreach moves with draft messages. 7. State of the Network for the CEO daily standup. 8. Self-audit metrics on her performance.

Her outreach drafts land in the Review Queue as Partner Outreach cards. You click Approve & Copy Draft, paste the message, and send it personally.

Tip: Simone's value is judgment. She tells you who to tag, who to avoid, and when to reach out. Your job is to approve and keep it personal. Never let outreach feel automated.

Back to contents

Investor Outreach

Manage investor research, relationships and outreach.

Welcome to Investor Outreach — your investor relationship command center, managed by Atlas (Investor Relations).

This page tracks every investor contact, their pipeline stage, touch cadence, and your outreach history. It's a high-trust CRM for the people who could fund your next round.

STATS GRID — At the top: - Investor Contacts — total investors in your CRM tagged as investor or investor-prospect. - Email Ready — how many have email addresses for outreach. - Investor Activities (30D) — touches, meetings, updates, and notes logged in the last 30 days. - Portal Invites Logged — how many investors have been invited to your investor portal. - Meetings/Calls (30D) — meetings and calls logged in the last 30 days. - Ready to Contact — investors not in cooldown or at their touch limit.

PIPELINE STAGE BAR — Shows your investor pipeline broken into six stages: Prospect → Qualified → Contacted → Engaged → Committed → Investor. Each stage shows the count. The goal: move investors right through real relationship-building.

CADENCE GUARDRAILS — Configure how often you can touch an investor: - Cooldown days between touches (default 14 — investors need more space than partners). - Max touches in 30 days (default 6). - Stale threshold — investors with no touch for this many days appear on the Stale Radar.

AT-RISK CONTACTS — Investors in cooldown or at their touch limit. Use the four action buttons: - Create Follow-up Task — creates a high-priority task with a due date based on their stage. - Log Meeting — record a call or meeting. Edit the note to add summary, sentiment, and commitments. - Log Touch — log any other meaningful contact. - Log Update — record when you shared traction metrics or proof points with an investor.

INVESTOR CADENCE MATRIX — Every investor in a scrollable table showing name, role, pipeline stage, touches, last touch, and status (New, Ready, Cooldown, Limit). Scrolls internally — see all your investors without the page stretching.

STALE INVESTOR RADAR — Read-only list of investors who have gone cold. Passive radar — no action required.

MESSAGE TEMPLATES — Three ready-to-use email templates: - Investor Introduction — first outreach to a new investor prospect. - Milestone Update — share traction numbers with engaged investors. - Post-Meeting Follow-up — send after every investor call. Click Copy and personalize before sending.

RECOMMENDED OUTREACH SEQUENCE — Atlas's recommended 5-step investor cadence: 1. Week 1 — Warm introduction email (personalized, no deck). 2. Week 2-3 — Share traction update (show momentum). 3. Week 3-4 — Schedule a 15-20 minute intro call. 4. Post-call — Send deck + data room only after a positive call. 5. Monthly — Brief milestone updates every 4-6 weeks.

SYNC TO BREVO — Push investor contacts with email addresses to a Brevo list called "Investor Outreach" for email campaign management.

RECENT INVESTOR ACTIVITY — Last 16 investor-related activities logged across your CRM.

Atlas (Investor Relations) handles investor communications, update emails, and meeting scheduling. He works on a weekly cadence — investor outreach is a long game, not a daily grind.

TIP: Never pitch in the first message. Lead with proof, not asks. Investors buy momentum — your job is to show it consistently. Every investor touch should leave them more informed than before.

Back to contents

Website Studio

Build a local website, preview it and prepare it for publishing.

Welcome to Website Studio. This is your AI-powered website builder — describe your business, pick your pages, and Link builds a local copy for you to preview before publishing.

1. Start by describing your business in the text area — what you do, who you serve, and what you want the site to say. Be specific for the best results. 2. Select a Website Type from the dropdown or leave it on Auto-detect and Link will figure out the best template. 3. Check the pages you want — Home, About, and Contact are included by default. Add Services, Pricing, Portfolio, Blog, FAQ, or Terms/Privacy as needed. 4. Drop images into the upload zone (or click Browse / File Dialog) — logos, hero images, product photos, and any visual assets you want Link to use throughout the site. 5. Click ✨ Start Building — Link will pick the best template, generate any missing images, build the site locally, and open it in the built-in web browser for you to preview. 6. Review the site in the browser. Chat with Link to request changes — switch pages, tweak colors, rewrite copy, add sections. Link rebuilds on every request. 7. When you're happy with the preview, expand Advanced Settings to configure your domain name, hosting provider, contact form endpoint, custom CTA text, colors, fonts, and any special requirements. 8. Click 🚀 Publish Site (or tell Link "publish" in chat). Link will deploy to your configured domain and hosting provider.

Every project needs a consistent shared design system: colors, font sizes, spacing, buttons, navigation, footer and reusable page layouts. Link adopts your existing framework or establishes these foundations for a new site. Before final review and launch, Website Studio checks that the shared sources exist and are used, and requires saved observations and evidence for mobile/desktop layouts, accessibility, interactions, performance and visual consistency. File changes make that review stale. A structural pass is not a substitute for inspecting the actual design.

Tip: This is an iterative process — build, preview, refine, repeat. Don't publish until you've previewed and are satisfied with every page.

Back to contents

Chat

Talk to your AI, use tools, and get things done.

💬 Chat

Chat is where you talk to your AI. Think of it like texting a really smart friend who can actually do things — not just talk about them. Available on both the desktop app and the paired mobile app.
How to send a message
  1. Type your question in the input at the bottom, or click the microphone icon and speak your question!
  2. Press Enter or click the send button.
  3. Watch the AI think through the problem step by step — each step appears as it happens.
Topics (conversation threads)

The tab bar at the top of the chat panel organises your conversations into separate threads — General, Work, Personal, and any custom ones you create. Each topic keeps its own message history so switching tabs starts a fresh context without losing anything.

  • Switch topics — click any tab. The 2-second cyan underline shows the active thread.
  • Add a custom topic — click + at the end of the tab bar, type a name, press Enter.
  • Delete a topic — right-click any tab on desktop and choose Delete. On mobile, long-press the tab.
  • Shared history — when your mobile app is paired, both desktop and mobile chat to the same topic history. A message sent from mobile under "Work" appears in the desktop Work tab.
What can your AI actually do?
  • Answer questions — explain things, write text, solve problems
  • Read files — ask it to read a document or piece of code on your computer
  • Write files — it will ask your permission before saving anything
  • Run commands — it will ask your permission before running anything in the terminal
  • Search the web — if the web search skill is enabled
  • Remember things — if the memory skill is enabled, it stores facts about you over time
Voice

On desktop, replies are read aloud automatically using the voice selected in Settings → Customize. On mobile, tap the microphone icon to speak your message. Tap the speaker icon to toggle read-aloud on/off. If the mic button does nothing, rebuild the APK — the voice native module requires a fresh APK compile (not just a Metro reload).

The confirmation dialog

Some actions — like deleting a file or running a terminal command — are dangerous. Before the AI does anything like that, a popup will appear showing you exactly what it wants to do and why. You have to click Confirm for it to proceed. If you click Cancel, nothing happens.

Convo Logs

Every conversation is automatically saved by project and topic. Click Convo Logs in the sidebar to browse past conversations organised by thread. Nothing is deleted unless you clear it manually.

Images

Drop or paste (Ctrl+V) an image directly into the chat input to share it with the AI. Multiple images are supported.

💡 Tip: If the AI seems to be going in the wrong direction, just say "stop" or "never mind" and it will stop what it's doing.

Back to contents

AI Bot Team

Create AI helpers with unique personalities and assign them tasks.

◆ AI Bot Team

A Bot Agent is like hiring a specialist. While your main AI is a generalist, you can create agents with very specific jobs — like a research agent, a code reviewer, or a writing assistant — each with their own personality and model.
How to create a Bot Agent
  1. Click AI Bot Team in the sidebar.
  2. Click + New Agent.
  3. Give your agent a name — like "ResearchBot" or "CodeReviewer".
  4. Pick a model. claude-sonnet-4-6 is a good all-around choice. Use claude-opus-4-8 for deeper reasoning, claude-haiku-4-5 for speed.
  5. Write a Persona — this is the agent's personality and job description (see below).
  6. Click Save Agent.
How to write a good Persona

The Persona is a plain-English description of who this agent is and what it's good at. You don't need to write code — just describe it like you'd describe a job to a new hire.

Example — Research Agent:
You are a research specialist. Your job is to find accurate information, summarize it clearly, and cite your sources. Always be skeptical of claims and look for multiple perspectives. Keep responses concise and well-organized.
Example — Code Reviewer:
You are a senior software engineer doing code reviews. Look for bugs, security issues, performance problems, and unclear naming. Be direct and specific. Suggest fixes, not just problems.
How to dispatch a task to an agent
  1. Find the agent card on the AI Bot Team page.
  2. Click Dispatch Task.
  3. Type what you want the agent to do in the text box that appears.
  4. Click Dispatch.
  5. Wait — the agent is running the full reasoning loop with its own personality. A "Running…" indicator shows while it works.
  6. The result appears right there on the card when it's done.
Where are agents stored?

Agents are saved locally on your computer and persist between sessions — you only have to create them once.

Does an agent remember past conversations?

Yes. Each agent keeps a full conversation history across dispatches, stored locally. Agents also have long-term memory tools for recalling credentials, preferences, and past decisions across sessions.

💡 Tip: Agents use the same safety system as the main AI — if an agent tries to delete a file or run a command, it will still ask for your confirmation first.

Back to contents

Schedules/Automations

Schedule voice reminders, AI tasks, and alerts to run automatically on a timer.

⏱ Schedules/Automations

Schedules & Automations let you schedule tasks that run automatically on a timer — like a calendar alarm combined with an AI action. Set it once and it runs on its own in the background.
How to create an Alert/Reminder
  1. Click the Schedules/Automations panel (clock icon in sidebar).
  2. Click + New Reminder.
  3. Give it a name — like "Morning Briefing" or "Drink Water".
  4. Set the schedule — examples: every 5 minutes, daily at 8am, every monday at 9am.
  5. Choose the action type (see below).
  6. Fill in the action content.
  7. Click Save — it is now active and running.
The 3 action types
🔊 Voice Reminder
The AI speaks a message out loud using text-to-speech. Great for reminders: "Time to take a break!"
💬 Agent Message
Your AI runs a full reasoning task and the result appears in the app. Example: "Summarize today's top tech news"
⚠️ Terminal Command
Runs a shell command on the computer. Powerful but risky — runs with full system privileges. A warning is shown when you create these.
How to pause or delete an alert
  • Use the toggle switch on the card to pause/resume without deleting.
  • Click Delete to remove it permanently.
Schedule language examples
every 30 minutesevery 2 hoursdaily at 9amevery monday at 8:30amonce at 2026-03-15 14:00
💡 Tip: Check Schedule in the sidebar to see all currently scheduled alerts, when they last ran, and when they run next.

Back to contents

Skills

Extra abilities your AI can use — web search, code, files, and more.

⚡ Skills

Skills are extra abilities that plug into your AI. Without skills, your AI can only think and write. With skills, it can search the web, run code, read PDFs, check your calendar, and much more.
How skills work

When you send a message, your AI automatically scans its skills to see if any of them are useful for your request. If they are, it calls them as tools — you'll see each tool call appear as a step in the chat. You don't have to tell it which skill to use — it figures that out on its own.

How to browse installed skills
  1. Click Skills in the sidebar.
  2. Each card shows a skill name, description, and what it can do.
  3. Skills that are bundled with the app are always available.
Examples of built-in skills
  • Web Search — search the internet for current information
  • Web Scraper — read the full content of any webpage
  • File Manager — list, read, write, and delete files
  • Terminal / Shell — run commands (with your confirmation)
  • Code Interpreter — write and execute code
  • PDF Reader — extract text from PDFs
  • YouTube Transcript — get transcripts from YouTube videos
  • Weather — check current weather conditions
  • System Info — get information about the computer
  • Memory — store and recall facts over time
  • Discord — manage Discord servers, channels, messages, and roles
Connecting your Discord community host

Live replies, recurring announcements and optional moderation have separate controls. Start in the Discord Developer Portal, then follow the same setup instructions as Community Managers → How To.

Choose the workspace and hosting location
  1. Select the business that owns this community before saving credentials or editing its agent. Live replies, recurring announcement schedules and optional moderation are separate controls.
  2. For desktop hosting, keep Bot Commander running, the computer awake and the internet connected. Closing the desktop or sleeping the computer stops its live host. Team/server-managed communities use the selected Team workspace’s Community Managers and server AI settings; their server must stay running. The desktop Discord Host Mode instructions below configure the desktop listener.
  3. Use only one listener for each bot token. Disable an existing desktop or other host before enabling the same bot on a Team server, and vice versa, to avoid competing listeners or duplicate replies.
Create the Discord bot and invite it to your server
  1. Open https://discord.com/developers/applications, create or select your application, then open Bot → Token. For a new bot, click Reset Token if the portal requires it to generate the first token, then copy it. For an existing bot, reuse its protected token if available: resetting invalidates the old token and requires updating every host using it. Store the token in Bot Commander settings, never in a chat, screenshot or support message.
  2. On the Bot page, enable Server Members Intent and Message Content Intent, then save. The current live host requests both, even if you only plan to use replies. Presence Intent is not requested or needed by this host. If Discord requires approval for a privileged intent, complete its approval process first; Bot Commander cannot grant that access.
  3. Open the application’s Installation page. Choose Discord Provided Link if offered, then Default Install Settings → Guild Install and the bot scope. For ordinary text-channel replies grant View Channels, Send Messages and Read Message History. Copy the Install Link, open it, choose Add to Server and the intended server, then authorize; you need Manage Server permission. Slash-command setup is not required for ordinary @mention replies.
  4. Do not grant Administrator, Manage Roles, Manage Channels or Manage Webhooks just for chat. Add Send Messages in Threads only if you intend to use threads and have verified that workflow. Check channel/category permission overrides as well as the bot’s server role.
Save the token and the correct Discord IDs
  1. In Discord, open User Settings → Advanced and enable Developer Mode. Right-click the server icon → Copy Server ID. Right-click the intended text channel → Copy Channel ID. These are different IDs; neither is the application’s Client ID.
  2. In Bot Commander open Settings → Social Media → Discord. Paste Bot Token and Server ID (Guild ID). Set Default Channel ID and, if needed, the dedicated Announcement Channel using channel IDs, then click Save. Keep the server ID out of the channel fields.
  3. A saved token or a Connected indicator does not prove the AI can answer. Refreshing a channel list checks Discord access, not the selected model, its credentials or billing.
Choose and check the community host’s AI
  1. Open AI Bot Team, find the deployed Community Host / Discord Manager and choose Edit. Use the agent’s role to identify it if you renamed it. Choose its Provider and Model, then Save Changes. Default uses the configured AI defaults; a specialist can use a different provider/model from your Commander.
  2. Configure the matching AI provider connection in Settings → AI Providers. The Discord Bot Token is not an AI API key. The model must be available to that provider account with sufficient quota or credit; a local model also needs its local service running and the model loaded.
  3. Ask your Commander to have that community host answer one simple question inside Bot Commander. This can incur provider charges. A successful answer checks that agent’s AI route; it does not establish that Discord live hosting is enabled.
Enable desktop Discord Host Mode
  1. In the same community host’s Edit form, scroll to Discord Host Mode. Once Bot Token and Server ID are saved, check Enable host mode. Click Refresh from server and select the intended Active channels.
  2. For the first test, turn Mention-only mode on. When it is off, selected channels can receive unmentioned replies; the host may stay quiet during other people’s conversations. Direct @mentions can also trigger replies in other channels the bot can view. Restrict its Discord channel permissions if it should only access particular rooms.
  3. Set Cooldown (seconds) to avoid rapid repeat replies. AI replies use your selected provider and may incur charges. Monitor provider usage; do not treat the displayed Daily budget (USD) as a guaranteed hard spending cap.
  4. Click Save host config and allow the host to reconnect. This saves the listener settings separately from the agent’s Provider/Model and Save Changes.
Test one live reply and diagnose an error
  1. In the chosen Discord text channel, send one simple question that directly @mentions the actual bot account. Keep Bot Commander running and wait for its reply before repeating the test. This sends a real reply visible in that channel and can incur AI-provider charges; use a test channel if appropriate.
  2. If it cannot fetch channels or connect, check the bot token, server ID, server installation, channel permissions and both required privileged intents. If Discord connects but a question fails, check that community host’s exact Provider/Model and its key, model access, quota and local-service status. The Commander working with a different model does not verify the host’s model.
  3. Check Bot Commander’s private chat for a Discord AI-provider failure notice, currently sometimes labeled Echo, with available provider/model/error details. Recognized Discord provider failures are kept private instead of posted into the community. A missing reply can also reflect mention mode, channel access, cooldown or a paused/closed host; it does not by itself identify a provider fault.
  4. For support, record the app version, operating system, time, platform, provider/model and exact error or screenshot. Settings → Data → Logs offers View Today’s Log and Open Folder; share only the relevant error-time excerpt after redacting tokens, API keys and private conversation details. Not every host error appears in the structured daily log. Never share your credentials or entire data folder.
Enable moderation only if you want it
  1. Moderation is optional and separate from live replies and recurring posts. Community Managers exposes the Discord Moderation controls. It can cover the server beyond the Active channels used for replies, so review that scope before enabling it.
  2. Deleting spam requires Manage Messages in the relevant channels. Grant Moderate Members only for timeouts, Kick Members only for kicks, or Ban Members only for bans when you deliberately choose those actions. The bot’s role must be above members it needs to moderate; Discord’s owner and role restrictions still apply. Administrator is not needed for ordinary hosting.
💡 Tip: If your AI doesn't seem to be using a skill you expect, try mentioning it directly — like "search the web for…" or "read the PDF at…"

Back to contents

Customize Bot Commander

Pick a preset commander or build your own — name, personality, avatar, and voice.

⚙ Customize Your Bot Commander

Open Settings to personalize your assistant. You can pick from a set of pre-built personalities or create your own from scratch.
Presets — the fastest way to get started

Go to Settings → Presets. You'll see a grid of assistant presets — each one is a complete package: personality, avatar, voice, and scene background. Click any card to apply the full bundle instantly. The personality is written to disk immediately, so your assistant's character takes effect on the next message — no save required.

Building your own assistant

Go to Settings → Customize. From here you can:

  • Bot Commander Name — give your Bot Commander a unique name. You cannot reuse a preset name (Orion, Nyra, etc.).
  • Personality / System Prompt — write your own instructions. Think of it as a job description for your AI. Use the placeholder as a guide for structure.
  • Avatar — upload a .png, .jpg, or .webp image. Previously uploaded images appear as thumbnails — click one to select it.

Click Save Changes when done. Your personality takes effect on the next message.

AI Model

Go to Settings → LLM Provider to change the model. The model is the "brain" your AI uses:

  • claude-opus-4-8 — most powerful, best reasoning, slower
  • claude-sonnet-4-6 — great balance of speed and intelligence (recommended)
  • claude-haiku-4-5 — fastest, lightest, best for simple tasks
Voice

Voice settings are in Settings → Customize (set automatically when you pick a preset). Pick a neural TTS voice from the voice picker and click ▶ Previewto audition it. Adjust speed with the slider. Voice is always active — your assistant will speak replies using the selected voice.

💡 Tip: Presets write the personality immediately on click. Your own custom personality only takes effect after you click Save Changes.

Back to contents

Settings — About You

Your name, experience level, tech stack, and what you are building.

👤 Settings — About You

The My Profile tab in Settings tells your AI who it is talking to. This context is injected into every conversation so your AI can tailor its responses to your skill level, interests, and what you are working on.
Your Name

What should your AI call you? Sets the name used in chat greetings and responses.

Experience Level

Choose your technical experience level — from Beginner through Expert. Your AI uses this to calibrate how much it explains vs. assumes. An expert gets concise answers; a beginner gets more context and step-by-step guidance.

Preferred Communication Style

Controls how verbose your AI is. Options range from Brief (short, direct answers) to Detailed (thorough explanations with examples).

Tech Stack & Interests

List your programming languages, frameworks, and interests (e.g. TypeScript, Rust, Game Dev, Music). Your AI uses these to pick relevant examples and avoid suggesting tools you don't use.

What Are You Building?

Describe your current project or focus. This is shared with your AI as persistent context so it always knows what you are working on — no need to re-explain every session.

Your Avatar

Pick an emoji avatar style for yourself, or upload a custom photo. Your avatar appears next to your messages in the chat panel.

Back to contents

Security

Password lock, API key storage, and how dangerous actions are protected.

🔒 Security

Bot Commander is designed so that your AI can never do something dangerous without you knowing about it and approving it first.
The confirmation dialog

When your AI wants to delete a file, overwrite a file, or run a terminal command, it stops and shows you a popup. The popup tells you:

  • What action it wants to take
  • Exactly which file or command is involved
  • Why it thinks it needs to do this

You must click Confirm for it to proceed. If you click Cancel or close the popup, nothing happens. This cannot be bypassed by the AI itself.

Password lock screen

Set a password in Settings → Security. When active, Bot Commander shows a lock screen every time it starts. Your password is stored as a bcrypt hash — the raw password is never saved anywhere, so even if someone accessed your files they couldn't retrieve it.

API key security

Your Anthropic API key is stored in Windows Credential Manager — the same system that protects your saved browser passwords. It is never written to any config file or log file on disk.

Prompt injection protection

Every AI message includes a hidden Security Boundary block that tells the AI to ignore attempts to override its instructions. This protects against "jailbreak" prompts — messages that say things like "ignore all your previous instructions and do this instead." Your AI is trained to reject those.

What is NOT sandboxed

Terminal command directives run with the same permissions as the app itself. If you schedule a terminal command, it can do anything your user account can do. A warning is shown in the UI when you create terminal command directives.

Back to contents

Mobile Remote Access

Connect your phone from anywhere with Cloudflare quick tunnel or account-based named tunnel.

🌍 Mobile Remote Access (Cloudflare Tunnel)

Mobile Remote Access lets your phone reach your desktop Bot Commander while you are away from home. There are two modes: Quick Tunnel (no signup) and Named Tunnel (Cloudflare account, stable URL).
Before you start
  • Desktop app and mobile app are both installed and signed in
  • Your desktop has internet access and stays running while you are remote
  • Open Settings → Mobile on desktop
  • Run local pairing first so desktop and phone are already linked
Fastest path: Quick Tunnel (no signup)
  1. In desktop Settings → Mobile, find the tunnel section.
  2. Leave account fields blank (token and public URL).
  3. Click Start Tunnel.
  4. Wait for a generated trycloudflare.com URL.
  5. Scan the updated mobile QR code (or pair code) from your phone.
  6. Test from mobile data (turn off Wi-Fi) to verify true remote access.

Quick Tunnel is best for fast setup, demos, and casual use. The URL is temporary and may change whenever you restart it.

Stable path: Named Tunnel (Cloudflare account)
  1. Create a named tunnel in Cloudflare Zero Trust and copy the tunnel token.
  2. Pick a hostname/public URL in Cloudflare DNS (example: bc.yourdomain.com).
  3. In desktop Settings → Mobile, paste your token and click Save Token.
  4. Paste your public URL and click Save Public URL.
  5. Click Start Tunnel.
  6. Re-pair mobile with the new QR/code and test over mobile data.

Named Tunnel gives you a stable hostname and avoids quick tunnel dependency.

When should I use each mode?
⚡ Quick Tunnel
No signup, fastest onboarding, good for most users testing remote access.
🏷 Named Tunnel
Requires Cloudflare account, but gives a stable URL and stronger long-term reliability.
Troubleshooting
  • Start Tunnel does nothing — wait for cloudflared download/install to finish on fresh machines, then retry.
  • Quick tunnel fails — try again later or switch to named tunnel mode.
  • Named mode won't start — verify both token and public URL are saved and valid.
  • Phone connects on Wi-Fi but not cellular — confirm tunnel is running and scan the latest remote QR after any tunnel change.
  • Multiple machines — use a separate named tunnel token per machine to avoid routing conflicts.
💡 Tip: If remote access is mission-critical, use Named Tunnel with your own domain. Keep Quick Tunnel as your one-click backup.

Back to contents

Terminal

A full PowerShell terminal built into the app — run commands, install tools, and inspect your system without leaving Bot Commander.

💻 Terminal

The Terminal is a full PowerShell window built directly into Bot Commander. You can type any Windows command and see the result — exactly like opening PowerShell separately, but without leaving the app. It's there for anyone who wants it, but you never have to use it — the AI handles most tasks through chat.
How to open the Terminal
  1. Look at the bottom of the left sidebar — there is a 💻 Terminal button.
  2. Click it. A terminal panel slides up from the bottom of the app.
  3. Click it again to hide it. Your session stays active — it doesn't reset.
Why would a regular user want this?

Most people won't need the terminal for everyday use — the AI handles things through chat. But it becomes genuinely useful in these situations:

🔧 Setting up integrations
Check if Node.js is installed (node --version) before setting up the Coinbase wallet or other tools that need it. Spot problems before they happen.
📦 Installing tools
Run npm install -g awal to pre-install the Coinbase wallet CLI, or install any other software the AI needs. Faster than opening a separate window.
📁 Quick file checks
Run dir or ls to see what's in a folder, ortype filename.txt to quickly read a file — without asking the AI.
🩺 Diagnosing problems
If something isn't working, the terminal lets you run diagnostic commands the AI might suggest — like ping, ipconfig, or checking a running process.
🚀 Running your own scripts
If you have a PowerShell or batch script you run regularly, you can run it here without switching windows — keep your AI and your terminal side by side.
👁 Watching the AI work
When the AI runs a command via the terminal-shell skill, you can verify what happened by checking the terminal output yourself — full transparency.
Useful commands for non-technical users
node --versionnpm --versiondircd Documentsipconfigping google.comtasklistcls
  • node --version — check if Node.js is installed (needed for Coinbase wallet)
  • npm --version — check if npm is installed
  • dir — list files in the current folder
  • cd Documents — navigate into your Documents folder
  • ipconfig — see your network addresses (useful for setting up Nodes)
  • ping google.com — test if your internet connection is working
  • tasklist — see all running programs
  • cls — clear the terminal screen
Keyboard shortcuts
  • ↑ / ↓ arrow keys — scroll through your previous commands (last 100 saved)
  • Ctrl + C — stop a running command immediately
  • Ctrl + D — send end-of-file signal (exits some programs)
Is it safe?

The terminal runs with your normal Windows user account permissions — the same as opening PowerShell yourself. Commands you type here have full access to your system, so be careful about copying commands from the internet. If you're unsure what a command does, ask the AI in Chat first.

When the AI wants to run a terminal command (through the terminal-shell skill), it always shows you a confirmation dialog first — you approve before anything happens. The built-in terminal shown here is for commands you type manually and has no such restriction.

💡 Tip: If you just want to ask the AI to run a command for you, do it in Chat — type something like "run ipconfig and tell me my IP address." The AI will ask for confirmation and show you the result in a readable format. The terminal is for when you want to run things yourself directly.

Back to contents

MCP Servers

Connect BC to external tool servers — file systems, databases, SaaS apps, and more — using the Model Context Protocol standard.

🔌 MCP Servers

MCP (Model Context Protocol) is an open standard that lets any third party build a "tool server" your AI can plug into instantly. Think of it like browser extensions — but for your AI. Connect a filesystem server and BC can read and write your files. Connect a GitHub server and BC can open pull requests. Connect a database server and BC can run SQL queries. No custom coding required on your end.
How to add an MCP server
  1. Open Settings → MCP Servers tab.
  2. Click + Add MCP Server.
  3. Give it a display name (e.g. "Filesystem").
  4. Choose stdio for a local program or Streamable HTTP for a modern remote server. Keep SSE for servers that specify the legacy transport.
  5. Enter the command (stdio) or the exact remote endpoint URL. Podcast Robot uses Streamable HTTP with https://podcastindexrobot.com/mcp.
  6. Click Add Server — BC connects enabled servers; Podcast Robot stays on demand.
The Filesystem server (already set up)

The most commonly used MCP server gives BC the ability to read and write files on your machine. To add it:

npx @modelcontextprotocol/server-filesystem C:\Users\YourName\Documents

Replace YourName with your Windows username. This limits BC to only your Documents folder — a safe starting point.

Once connected, BC gains these 14 tools:

read_file
Read the full contents of any file.
read_multiple_files
Read several files in one call.
write_file
Create or overwrite a file.
edit_file
Make targeted edits inside an existing file.
create_directory
Create a new folder (including nested paths).
list_directory
List all files and folders at a path.
directory_tree
Show a full recursive tree of a folder.
move_file
Move or rename a file or folder.
search_files
Search for files by name pattern, recursively.
get_file_info
Get size, dates, and permissions for a file.
list_allowed_directories
See which root paths the server can access.
delete_file
Delete a file permanently.
copy_file
Copy a file to a new location.
read_file_range
Read only a specific range of lines from a file.
Which transport should I choose?
  • stdio (local process) — BC spawns the server as a child process on your machine. You provide the full command string (e.g. npx ...). The server runs silently in the background. Best for local tools like the filesystem server.
  • Streamable HTTP (remote server) — Connect to a modern MCP endpoint using its URL, commonly ending in /mcp. Responses can be JSON or streamed events.
  • SSE (legacy HTTP server) — Keep this for servers that explicitly require the older SSE transport. Existing saved connections are not changed automatically.
Podcast Robot — getting started

Podcast Robot is included by default. Open My Home > Podcasts, or ask your Commander for podcast help. It connects only when used and closes afterward. Disable it in Settings > MCP Servers; no API key or manual server setup is needed.

  • “Use Podcast Robot to find five active podcasts about small-business automation. Show recent relevant episodes and explain which might suit a guest interview.”
  • “Find where this episode discusses my topic, with a timestamp and source link.” Transcript search requires an available transcript.
  • “What new episodes have these shows published?” Supply the shows you want checked.
  • “Grade my podcast feed and explain which discovery tags are missing.”

Clip tools return timestamped audio references, not an exported video or audio file. Podcast Robot is free during its test period; your AI provider may still charge for reasoning. Searches are sent to the service, which says it retains tool-use and search-word records for 30 days. Adding the server does not create scheduled watches. Start with on-demand requests.

If you previously added it as SSE, remove that server entry and add it again with Streamable HTTP. See Podcast Robot's documentation for current service details. BC currently exposes MCP tools; the server's separate prompt and resource lists are not a dedicated browsing interface in BC.

Managing servers
  • Enable / Disable — Click the toggle next to any server to temporarily disconnect it without removing it. Toggle it back to reconnect.
  • Remove — Click Remove to permanently delete the server config. The connection closes immediately.
  • Status dot — A green dot with a tool count means it's connected. A red dot means the connection failed (check your command or URL).
Find more MCP servers

The official community list at github.com/modelcontextprotocol/servers has hundreds of servers covering Notion, GitHub, Slack, PostgreSQL, Google Drive, Linear, Stripe, Brave Search, and many more. Each one lists its install command — just paste it into the Command field in Settings.

💡 Works with any AI provider. MCP tools are provider-agnostic — they work whether you're using Claude, GPT-4, Gemini, or a local Ollama model. Switching your AI provider in Settings has no effect on your MCP connections.

Back to contents

Email Setup

Connect Gmail, Outlook, IMAP, and Brevo newsletter sending so BC can manage email workflows.

📧 Email Setup

Connect Bot Commander to your Gmail or Outlook account and your AI can read your inbox, send messages, search threads, and manage folders — all on your command. Credentials are encrypted in Windows Credential Manager and never stored in plain text.
What is an App Password?

An App Password is a special one-time password generated by Google or Microsoft that lets a specific app access your email. It is completely separate from your main account password and can be revoked at any time without changing anything else about your account.

How to set up Gmail
  1. Go to myaccount.google.com/security
  2. In the search box at the top, type App Password and open it.
  3. Give it any name (e.g. Company Assistant) and click Create.
  4. Google shows a password — copy it and paste it into GMAIL_APP_PASSWORD below.
  5. Enter your Gmail address in GMAIL_ADDRESS and click Save for each field.

Note: 2-Step Verification must be enabled on your Google account before App Passwords will appear.

How to set up Outlook / Microsoft
  1. Go to account.microsoft.com/security.
  2. Scroll to Advanced security options.
  3. Under App passwords, click Create a new app password.
  4. Copy the generated password.
  5. In BC go to Settings → Email Setup.
  6. Enter your Outlook address in OUTLOOK_EMAIL and the password into OUTLOOK_APP_PASSWORD.
  7. Click Save for each field.

Works with Outlook.com, Hotmail, and Microsoft 365 business accounts.

What can BC do with email access?
📥 Read & Summarise
Ask "what's in my inbox?" and BC will fetch and summarise your latest emails.
📤 Send Messages
Say "send an email to John about the meeting" — BC drafts it and asks you to confirm before sending.
🔍 Search Threads
Find specific emails by sender, subject, or date range without opening your mail client.
📊 Inbox Summaries
Ask BC for a digest of unread messages or recent threads any time.
Brevo Newsletter Sending

Bot Commander creates newsletter drafts, syncs CRM segments into Brevo contact lists, and sends test emails from the Blogs, Articles & Newsletters workspace. Brevo is the delivery provider; Bot Commander remains the place where you write, review, and prepare the campaign.

Newsletter feature images need a public HTTPS URL. Bot Commander can upload generated or attached images to DigitalOcean Spaces automatically when Spaces is configured. Without public image hosting, inboxes may show broken or blocked images.

How to create and connect Brevo
  1. Go to brevo.com and create or sign in to a Brevo account.
  2. In Brevo, go to Senders, Domains & Dedicated IPs and add the sender email you want newsletters to come from.
  3. Verify the sender email. Bot Commander can only send from an active sender Brevo accepts.
  4. In Brevo, open SMTP & API → API Keys and create an API v3 key.
  5. In Bot Commander, open Settings → Integrations → Brevo.
  6. Paste the API key into BREVO_API_KEY and click Save.

Keep the API key private. If it is exposed, revoke it in Brevo and create a new one.

How to set up newsletter image hosting

Email clients cannot load images from your local computer. If a newsletter has a feature image, Bot Commander needs a public image host. DigitalOcean Spaces is the built-in option.

  1. Create a DigitalOcean Spaces bucket at cloud.digitalocean.com/spaces.
  2. Enable the bucket CDN if available, then copy the bucket name, region, access key, secret key, and CDN URL.
  3. In Bot Commander, open Settings → Storage → DigitalOcean Spaces.
  4. Save SPACES_ACCESS_KEY_ID, SPACES_SECRET_ACCESS_KEY, SPACES_BUCKET, SPACES_REGION, and optionally SPACES_CDN_URL.
  5. When you create a newsletter draft, Bot Commander uploads the selected feature image and inserts the public HTTPS URL into the Brevo campaign.

Other public image hosts can work if you paste an existing HTTPS image URL into the draft, but generated local images need Spaces or a similar upload host.

How to send a newsletter test
  1. Open Blogs, Articles & Newsletters.
  2. Choose Newsletter issue as the format.
  3. Write or paste the newsletter in the Draft Workspace.
  4. In Newsletter Delivery, choose the audience list, sender name, sender email, subject, preview text, and test recipient.
  5. Click Create Newsletter Draft to create the Brevo campaign draft.
  6. Click Send Test to send only to the test recipient.
  7. Review the test in your inbox before sending to the audience list from Brevo.
Common Brevo setup issues
  • Sender not found or inactive — verify that exact sender email in Brevo, then try again.
  • Test send blocked — use a clean test recipient that is not unsubscribed, blacklisted, or suppressed in Brevo.
  • No contacts in the list — sync the target CRM segment to Brevo first, or let the test-send workflow add the test recipient to the selected list.
  • Wrong audience — confirm the audience list in Newsletter Delivery before creating the campaign draft.
How to set up a custom IMAP / SMTP host

Use this for any email hosted on your own domain — cPanel, Fastmail, iCloud, Yahoo, or any provider that gives you IMAP credentials.

  1. Get your IMAP and SMTP details from your hosting control panel or email provider's help docs.
  2. In BC go to Settings → Email Setup → Custom IMAP / SMTP.
  3. Fill in IMAP_EMAIL (your full email address) and IMAP_PASSWORD.
  4. Set IMAP_HOST — usually mail.yourdomain.com for cPanel hosts.
  5. Set IMAP_PORT to 993 (SSL) or 143 (STARTTLS).
  6. Set SMTP_HOST and SMTP_PORT — typically 465 (SSL) or 587 (STARTTLS).
  7. Click Save for each field.

Common cPanel defaults: host mail.yourdomain.com · IMAP port 993 · SMTP port 465.

How to revoke access

Go back to your Google or Microsoft account security settings and delete the App Password you created. BC loses email access immediately. Your main account password is unaffected.

💡 Tip: Add a Directive like "always show me a draft before sending any email" and BC will never send without your review, no matter what you ask.

Back to contents

Website Builder

Let BC build and deploy websites directly to your BlueHost (or any cPanel) hosting account.

🌐 Website Builder

BC can design, write, and deploy a complete website to your BlueHost (or any cPanel) hosting account — no manual FTP, no code editor required. Just describe what you want and BC handles the rest.
BlueHost setup — one-time SSH key configuration

BlueHost requires an SSH key for SFTP access. Do this once and BC can deploy automatically without any prompts.

  1. Open PowerShell and run:
    ssh-keygen -t rsa -b 2048 -f "$env:USERPROFILE\.ssh\botcom_auto" -N '""'
    This creates a passphrase-less key at C:\Users\you\.ssh\botcom_auto.
  2. Copy the public key: Get-Content "$env:USERPROFILE\.ssh\botcom_auto.pub" | Set-Clipboard
  3. In cPanel go to SSH Access → Manage SSH Keys → Import Key.
  4. Name it botcom_auto, paste your public key into the Public Key box, click Import.
  5. Click Manage next to the new key → click Authorize.
  6. In BC open Settings → Website and fill in all fields, including SSH Key = full path to your private key file.
🔍 Finding your credentials: Your cPanel username (e.g. hhflgumy) is shown at the top of the cPanel home page under “General Information” — it is not your email address. The host is the Shared IP Address shown on the same page. The Doc Root for an addon domain is the subfolder shown in cPanel → Domains (e.g. public_html/website_0bf718e0).
How to connect your hosting account (non-BlueHost)
  1. Log into your BlueHost dashboard → Hosting → scroll to Server Information and note your server hostname (e.g. box1234.bluehost.com).
  2. Your cPanel username is shown in the top-right corner of cPanel.
  3. In BC go to Settings → Email Setup → Hosting — cPanel / BlueHost.
  4. Fill in CPANEL_HOST, CPANEL_USER, CPANEL_PASSWORD, and CPANEL_DOMAIN.
  5. Click Save for each field.
How to ask BC to build a site
  1. Open Chat and describe what you want — e.g. “Build me a one-page business landing page for my roofing company, clean dark theme, with a contact section.”
  2. BC will generate the HTML, CSS, and JS files and deploy them directly to public_html on your server.
  3. Your site is live at https://yourdomain.com as soon as the upload finishes.
What else can BC do with your hosting?
📁 Deploy Files
Upload any folder of files to public_html via SFTP — full site or single file updates.
🌐 Subdomains
Create subdomains like blog.yourdomain.com and deploy content to them separately.
🗄 Databases
Create MySQL databases and users via the cPanel API — ready for WordPress or custom apps.
🔒 SSL
Request AutoSSL (Let’s Encrypt) certificates for your domain directly from chat.
💡 Tip: You can ask BC to update a specific page — e.g. “Update my homepage to add a new testimonials section” — and it will rewrite just that file and re-deploy it.

Back to contents

Business Builder

Two AI-guided tracks — start a new business from scratch or diagnose and fix an existing one.

🏗 Business Builder

Business Builder is a guided, multi-stage AI program that walks you through either starting a new business from scratch or diagnosing and fixing an existing one. Each stage has specific deliverables, deploys the right AI agents automatically, and saves everything to your Documents folder.
How to open Business Builder

Click the BUILD YOUR BUSINESS button at the top of the left sidebar. On your first visit you choose a track. Your choice and progress are saved automatically.

Track 1 — Start a Business (8 stages)

For people with an idea (or no idea yet) who want to build from zero to revenue.

  1. Founder–Opportunity Fit — discover your edge, skills audit, market scanning
  2. Validation — prove it before you build it: customer interviews, landing page, waitlist
  3. Business Model & Funding — design how you make money, pricing, funding options
  4. Legal & Infrastructure — formalize and protect: entity formation, contracts, compliance
  5. Go to Market — launch sales, marketing, social media posting, first customers
  6. Operations & Systems — SOPs, automation, team workflows
  7. Scale & Growth — AARRR metrics, optimization, expansion
  8. CEO Dashboard — ongoing KPI tracking and executive reporting
Track 2 — Fix My Business (6 stages)

For existing business owners who need to diagnose what's broken and turn things around.

  1. Business Health Audit — 8-dimension scorecard across revenue, ops, marketing, team, and more
  2. Revenue & Cash Flow Diagnosis — find the leaks, fix pricing, improve collections
  3. Operations & Efficiency Review — streamline processes, cut waste
  4. Sales & Marketing Turnaround — rebuild pipeline, reposition messaging
  5. Team & Leadership Reset — org structure, accountability, talent gaps
  6. Growth Restart Plan — 90-day turnaround roadmap with weekly milestones
How stages work
  • Each stage card shows a progress indicator — completed, active, or locked
  • Stages auto-check for required AI agents and offer to deploy missing ones
  • Click a stage to launch it — context is sent to the Command Center chat and your AI walks you through it
  • Each stage produces deliverables (documents, plans, checklists) saved under BusinessBuilder/Stage-N/ inside the active workspace
  • A progress bar at the top tracks your completion across all stages
💡 Tip: You don't need any business experience to start. The AI walks you through every step conversationally — just answer its questions and it builds the deliverables for you.

Back to contents

CRM

Manage contacts, deals, pipeline stages, and activity logs — all built in and AI-connected.

📇 CRM — Customer Relationship Manager

The built-in CRM lets you manage contacts, track deals through a pipeline, and log activities — all without leaving Bot Commander. Your AI agents can also create contacts, update deal stages, and log activities autonomously.
How to open the CRM

Click CRM in the left sidebar under the BUSINESS section.

Contacts

The Contacts tab shows all your contacts in a searchable list. Each contact has a name, email, company, phone, and a stage badge:

  • Lead — initial contact, not yet qualified
  • Prospect — qualified and in conversation
  • Customer — paying or committed
  • Churned — previously active, now inactive

Click any contact to see their full detail view with linked deals and activity history.

Pipeline (Deals)

The Pipeline tab shows a Kanban-style board with 6 columns:

Lead
New opportunity identified
Qualified
Confirmed as real opportunity
Proposal
Offer or quote sent
Negotiation
Terms being discussed
Won
Deal closed successfully
Lost
Deal did not close

Each deal card shows the linked contact, deal value, and a dropdown to move it between stages.

Activities

The Activity tab shows a chronological feed of interactions tied to contacts and deals. Activity types include:

  • 📝 Note — free-form text
  • 📞 Call — phone call record
  • ✉️ Email — email sent or received
  • 🤝 Meeting — scheduled meeting
  • ✓ Task — action item with optional due date (creates a calendar reminder)
CSV Import

Click ↑ Import CSV to bulk-import contacts from a spreadsheet. The import wizard auto-detects column mappings for name, email, phone, company, and more. Review the mapping and click Import to add all contacts at once.

AI integration

Your AI agents can manage the CRM autonomously — create contacts after a sales call, log meeting notes, update deal stages, and flag stale deals. Ask your AI for a pipeline summary any time and it will read directly from your CRM data.

💡 Tip: All CRM data is stored locally in ~/.botcom/crm.db. Nothing is uploaded to any server. Your contacts and deals stay on your machine.

Back to contents

Accounting

Track income, expenses, invoices, and view profit & loss summaries — no spreadsheet needed.

📊 Accounting

Track your business finances directly inside Bot Commander — log income and expenses, create and manage invoices, and view profit & loss summaries. No spreadsheet or external accounting software needed.
How to open Accounting

Click Accounting in the left sidebar under the BUSINESS section.

Transactions

The Transactions tab lists all your income and expenses. Use the filter buttons to show all, income only, or expenses only. Each transaction records:

  • Type — Income (green) or Expense (red)
  • Category — chosen from built-in categories (see below)
  • Amount — the dollar value
  • Date — when it occurred
  • Description — what it was for
  • Reference — optional invoice number or receipt ID
Built-in categories
💰 Income
Product Sales · Services · Consulting · Retainer · Commission · Refund Received · Other
💸 Expense
Advertising · Equipment · Legal · Office Supplies · Payroll · Rent & Utilities · Software · Travel · COGS · Other
Invoices

The Invoices tab lets you create and track invoices. Each invoice has a title, amount, due date, optional notes, and a status that flows through:

  • Draft → Sent → Paid
  • Overdue invoices are flagged automatically when past their due date

Change status via the dropdown on each invoice card.

Profit & Loss summary

The P&L tab shows your year-to-date financial summary: total income, total expenses, and net profit — with breakdowns by category. The summary strip at the top of the panel always shows these numbers at a glance.

AI integration

Your AI can create transactions, generate invoices, update invoice statuses, and pull P&L summaries on command. Try: "Log a $500 consulting income for today" or"Create an invoice for $2,000 due next Friday."

💡 Tip: All financial data is stored locally in ~/.botcom/crm.dbalongside your CRM data. Nothing is sent to any external server.

Back to contents

Bank Accounts (Plaid)

Securely link your bank with Plaid to auto-import transactions and live balances into Accounting.

🏦 Bank Accounts (Plaid)

Bot Commander uses Plaid to securely connect your bank, fetch live balances, and import transactions straight into the Accounting tab. Plaid handles the bank login on your behalf — Bot Commander never sees your banking password. Plaid is the same provider used by Venmo, Robinhood, Coinbase, Chime, Mercury, and most major US fintech apps.
This is a bring-your-own-keys setup: you create a free Plaid account, paste two values into Bot Commander's Settings, and you're done. About 5 minutes total.
Step 1 — Create a Plaid account
  1. Go to dashboard.plaid.com/signup and sign up with your email.
  2. The free Sandbox tier is enough to test with fake data; the Production tier (also free for the first 100 connected items) is what you'll use for your real bank.
  3. Plaid will ask a few questions about your use case. Answer "Personal Finance / Money management" — this is the simplest approval path. Production access is typically auto-approved within a few minutes.
💡 Plaid's marketing is mostly geared at companies wrapping Plaid into their own product. For our purposes, you're a one-person "company" using your own keys to track your own accounts. That's fine — Plaid allows it. Just answer their dashboard questions honestly.
Step 2 — Get your API keys
  1. In the Plaid Dashboard, go to Developers → API.
  2. You'll see two environments listed: Sandbox and Production.
  3. Each one shows a client_id (same across both) and a secret (different per environment).
  4. Copy your Production client_id and secret. You'll paste these into Bot Commander in Step 4.
Step 3 — Configure account selection (recommended)

By default, Plaid will link every account at a bank without asking which ones you want. To get a checkbox picker so you can choose only the accounts you want:

  1. In the Plaid Dashboard, go to Link → Customizations.
  2. Click your default Link customization (or create one).
  3. Find Account Select.
  4. Set it to "Enabled for multiple accounts".
  5. Click Save.
💡 "Enabled for one account" forces a single pick. "Enabled for all accounts" links everything with no choice. "Multiple" is the right pick for most people — you get a checkbox list and choose any subset.
Step 4 — Paste keys into Bot Commander
  1. Open Bot Commander → click the gear icon → Settings.
  2. Switch to the Social Media tab (Plaid lives there for now).
  3. Find the 🏦 Plaid section.
  4. Set Environment to production.
  5. Paste your Client ID and Secret.
  6. Click Save.
Step 5 — Connect your first bank
  1. In the main window, find the Asset Vaults strip at the top.
  2. Click + Add → Connect Bank Account (or + Connect Bank if the strip is empty).
  3. Plaid Link opens with a phone-number prompt. Click "Continue without phone number" at the bottom (the phone option is just for faster re-logins on Plaid's side — totally optional).
  4. Type your bank's name in the search box, or pick it from the list of popular banks.
  5. Click Continue to login. Plaid opens your bank's real website in your default browser.
  6. Log into your bank's website to authenticate (username, password, MFA — whatever your bank requires).
  7. On the next screen, your bank will ask permission to share data with Plaid. Allow Plaid access.
  8. Return to Bot Commander to finish the connection.
  9. Choose the accounts you want to connect (if you enabled the picker in Step 3) and click Continue.
  10. If Plaid offers to "save" your login for next time, you can choose "Finish without saving" — Bot Commander only needs the connection itself, not a saved Plaid profile.

A new card per account appears in the Asset Vaults strip showing the live balance. Imported transactions show up in Accounting → Transactions tagged with a 🏦 icon.

Disconnecting a bank

Click the ✕ on any bank card → confirm. This removes the bank's link with Plaid and stops syncing. Already-imported transactions stay in your accounting books(they become regular entries you can edit or delete normally). To re-link later, use + Add → Connect Bank Account again.

Costs
  • Plaid is free for the first 100 connected items on your account. One item = one bank login (checking + savings + credit at the same bank counts as a single item).
  • After that, transactions cost roughly $0.30–$0.50 per item per month.
  • Bot Commander adds no markup — Plaid bills you directly through your dashboard.
Common issues
  • "Continue to login" button does nothing. Restart Bot Commander — the desktop window-handler that routes the bank's login to your default browser is set up at app launch.
  • OAuth bank gets stuck after I log in at the bank's website. OAuth banks need a registered redirect URL with Plaid; Bot Commander's OAuth deep-link is in development. For now, prefer a non-OAuth bank.
  • "Item login required" on a bank card. Your bank session expired (typical after 90 days, sooner if you changed your password). Click ✕ to disconnect and re-link.
  • I see balances but no transactions. First sync can take a minute. Click Sync Now on the bank card. If still empty, check Accounting — imported transactions are marked 🏦.
  • An account I didn't pick is showing up. You probably linked at a bank with Account Select disabled. Disconnect, complete Step 3, then re-link.
Privacy
  • Bot Commander stores your Plaid access_token locally in your encrypted SQLite database (~/.botcom/crm.db).
  • Your bank credentials never touch Bot Commander — Plaid handles them entirely.
💡 Tip: Start with one account at one bank to get comfortable with the flow. You can always add more banks (or more accounts at the same bank) later.

Back to contents

Watch Wallets

Add any crypto wallet address and track its balance and tokens in real time — no keys needed.

👁 Watch Wallets

The Crypto Wallets strip lets you watch any public wallet address — Ethereum, Bitcoin, Solana, Base, and more. You just paste in the address and Bot Commander fetches the live balance and every token in it automatically. No private key is ever asked for or stored — it's completely read-only, like bookmarking a bank statement that updates in real time.
Where is the Crypto Wallets strip?

It lives along the bottom edge of the main screen. If you haven't added any wallets yet, you'll see a small bar that says "CRYPTO WALLETS — Watch-only"with a + Add Wallet button.

How to add a watch wallet
  1. Click the + Add Wallet button (or the small + Add button on the right of the strip once you have wallets).
  2. A popup appears. Fill in three things:
    • Display Name — anything you like, e.g. My ETH Wallet or Cold Storage
    • Chain — pick the blockchain from the dropdown (ETH, BTC, SOL, BNB, MATIC, AVAX, ARB, BASE)
    • Address — paste the public wallet address (the long string starting with 0x... for EVM chains, or the base58 address for Solana/Bitcoin)
  3. Click Add Wallet. The card appears in the strip and begins loading the balance immediately.
💡 Where do I find my wallet address? In MetaMask: click your account name at the top — the address is copied to clipboard. In Coinbase app: tap your profile → My addresses. It always starts with 0x for Ethereum/Base wallets.
What does each card show?
  • Total USD value — the big number in the middle of the card
  • Token breakdown — every token held (ETH, USDC, ERC-20s, etc.) with individual balances and USD values
  • Address shortcut — click the short address at the bottom to copy the full address to clipboard
  • + N more — if you hold more than 3 tokens, click to expand the full list
How often does it update?

Prices refresh every 2 minutes. Portfolio balances refresh every 15 minutes automatically. Click the ↻ button on the right side of the strip to force an immediate refresh of all wallets.

How to edit or remove a wallet
  • Edit — click anywhere on a wallet card to open the edit popup. Change the name, chain, or address and click Save Changes.
  • Remove — click the ✕ in the top-right corner of a card. A confirmation popup appears — click Remove to confirm. Nothing is deleted from the blockchain, just removed from your view.
  • Reorder — drag a card left or right by the chain icon on the left side of the card.
Which chains are supported?
Ξ Ethereum
Full ERC-20 token support via Blockscout
₿ Bitcoin
BTC balance via public explorers
◎ Solana
SOL + SPL tokens via Ankr
⬡ Base
Coinbase L2 — ETH + Base tokens
⬡ BNB / MATIC / AVAX / ARB
Native + token balances via Ankr
Is my data safe? Does Bot Commander know my private key?

No private key is ever needed or stored. Watch wallets are purely read-only — you only provide the public address, which is already visible to anyone on the blockchain. Your wallet credentials are never involved. Wallet data is saved in the app's local storage on your machine only — it is never sent to any Bot Commander server.

💡 Tip: You can watch wallets you don't own — a friend's address, a DAO treasury, or a whale wallet you want to monitor. The strip shows up to 4 cards at once on screen.

Back to contents

Coinbase Agentic Wallet

Give your AI a real crypto wallet — send USDC, trade on Base, and pay for API services autonomously.

🔐 Coinbase Agentic Wallet

The Coinbase Agentic Wallet gives your AI a real crypto wallet it can actually use — send USDC, swap tokens on Base, and pay for API services, all autonomously via chat commands. This is completely separate from watching wallets — this one your AI actively controls within safe limits you set.
What you need before starting
  • A free Coinbase Developer Platform (CDP) account — no phone required, just a browser
  • A CDP API key (takes about 2 minutes to create)
  • Node.js 22 or later installed on your computer (the AI uses npx awal to run wallet operations) — check with node --version in Terminal
  • That's it — no crypto deposit needed to get started (there's a free testnet)
Step 1 — Create a Coinbase Developer Platform account
  1. Open any web browser and go to portal.cdp.coinbase.com
  2. Click Sign Up and create a free account with your email
  3. Verify your email when the confirmation arrives
  4. You're in — no credit card, no ID verification needed for a basic API key
Step 2 — Create an API key
  1. In the CDP portal, find API Keys in the left sidebar and click it
  2. Click Create API Key
  3. Give it a name like BotCommander
  4. Click Create & Download — a .json file downloads automatically. Keep this file safe — you can only download it once
  5. Open the downloaded JSON file with Notepad. You'll see two values:
    • "name" — looks like organizations/abc.../apiKeys/xyz... — this is your Key Name
    • "privateKey" — a long block starting with -----BEGIN EC PRIVATE KEY----- — this is your Private Key
Step 3 — Enter the keys in Bot Commander
  1. In Bot Commander, click the Settings icon (⚙ in the top navigation)
  2. Go to the LLM Provider tab
  3. Scroll to the bottom — you'll see two fields labelled Coinbase CDP — Key Name and Coinbase CDP — Private Key
  4. Copy the name value from your JSON file and paste it into Key Name
  5. Copy the entire privateKey block (including the -----BEGIN... and -----END... lines) and paste it into Private Key
  6. Click Save Settings
🔒 Security note: These keys are stored in your local config file at C:\Users\YourName\.botcom\config.json — on your machine only, never uploaded anywhere. The AI never sees the private key directly; it's injected as an environment variable when awal runs.
Step 4 — Sign in to your wallet
  1. Go to Chat in Bot Commander
  2. Type: "Connect my Coinbase wallet using [your-email@example.com]"
  3. The AI will run npx awal auth login and tell you a 6-digit code has been sent to your email
  4. Check your email, find the 6-digit code, and type it back into chat — e.g. "The code is 482913"
  5. The AI verifies the code and confirms your wallet is connected, showing your wallet address and USDC balance

You only need to do this sign-in once per session. It persists until you close the app.

What can you do once connected?
💰 Check balance
"What's my wallet balance?" — shows USDC, ETH, and all tokens
💸 Send USDC
"Send $10 USDC to vitalik.eth" or "Send 5 USDC to 0x1234..."
📈 Trade tokens
"Swap $50 USDC for ETH" — gasless trading on Base
🏦 Add funds
"Fund my wallet with $20" — opens Coinbase Onramp (buy crypto with card)
⚡ Pay for APIs
AI can autonomously pay for premium data and services via the x402 protocol
📊 Trade history
"Show my last 10 transactions"
Honest answers to common questions

People ask the same things — here's the straight answer for each:

Can I make money trading crypto?
You can trade — swapping USDC for ETH and back is real. Whether you profit depends entirely on whether crypto goes up or down, not on Bot Commander. The AI can execute trades instantly and follow rules you set, but it cannot predict the market. Start small. This is not financial advice and crypto involves real risk of loss.

Can I pay bills with it?
Not directly — most utilities, landlords, and bill providers don't accept USDC yet. You could in theory convert USDC to cash via Coinbase and pay from your bank, but that's extra steps. This will improve as crypto adoption grows.

Can I buy things online?
A growing number of online merchants, freelancers, and digital services accept USDC on Base — but it's not mainstream like a Visa card yet. Crypto-native services (VPNs, hosting, domains, digital content) are the most common. The x402 protocol means your AI can already pay for premium API and data services automatically.

Can I send money to family or friends?
Yes — this is one of the most practical current uses. If someone has a crypto wallet address, you can send them USDC anywhere in the world in seconds for a transaction fee of a few cents. Far cheaper and faster than a wire transfer or services like Western Union.

Can I receive payments for my business?
Yes. Share your wallet address and any client with a crypto wallet can pay you directly in USDC. You then convert to your local currency via Coinbase if needed.

Is this like having a bank account?
It's more like a digital cash wallet than a bank. There is no overdraft, no interest, no fraud protection from a bank, and no FDIC insurance. USDC itself is a stablecoin pegged to the US dollar so it doesn't fluctuate in value like Bitcoin, but the wallet is your responsibility to secure.

Testing for free — the Base Sepolia testnet

Before using real money you can test everything on the Base Sepolia testnet— a fake blockchain where transactions cost nothing and funds are worthless (for practice only). Ask the AI: "Fund my wallet on the testnet using the faucet" and it will add free test USDC so you can try sending and trading without any risk.

Safety guardrails
  • Spending limits — you can ask the AI to set a session cap (e.g. "set my max spend to $50 per session"). It will refuse any transaction that exceeds it
  • Confirmation for large amounts — like all dangerous actions, the AI will show you a confirmation dialog before executing any financial transaction
  • Keys in hardware enclave — Coinbase stores the actual private key in a Trusted Execution Environment (TEE) — a secure hardware chip. The key is never exposed to the AI model or to Bot Commander itself
  • KYT screening — Coinbase automatically blocks transactions to known high-risk or sanctioned addresses
Will my wallet survive reinstalling Bot Commander?

Yes. The wallet lives on Coinbase's infrastructure, not on your computer. As long as you have the same CDP API key in Settings, you reconnect to the same wallet by doing the email sign-in again. Your keys stored in ~/.botcom/config.json are NOT deleted by uninstalling the app.

💡 Do I need to clear this before sharing the app? No. Your CDP keys live in C:\Users\YourName\.botcom\config.json — that file is on your personal Windows profile and is never baked into the .exe binary. Anyone who installs a copy of Bot Commander starts completely fresh with no wallet configured.

Back to contents

Coinbase Advanced Trading

Connect your Coinbase account to trade crypto — market orders, limit orders, and automated market scans via Midas.

📈 Coinbase Advanced Trading

Connect your Coinbase account and your AI can execute real crypto trades — market orders, limit orders, and automated market scans — all within safety limits you control. Your dedicated trading agent Midas monitors markets every 2 hours and presents trade recommendations for your approval.
What you need before starting
  • A Coinbase account at coinbase.com (regular Coinbase, not just CDP)
  • A Coinbase API key with View + Trade + Transfer permissions
  • Node.js 22 or later installed on your computer
Step-by-step setup
  1. Log into coinbase.com → Settings → API.
  2. Click New API Key. Enable permissions: View, Trade, and Transfer.
  3. Save the API Key Name and Private Key that Coinbase shows you. You can only see these once.
  4. In Bot Commander, look at the wallet strip at the bottom of the screen.
  5. Click the + button → Trade Wallet.
  6. Paste your API Key Name and Private Key into the fields and save.
  7. A Midas agent is auto-created in your AI Team — this is your dedicated crypto trading agent.
Configure trading limits

Go to Settings → Trading to control what your AI is allowed to do:

  • Enable Trading — master on/off toggle (OFF by default)
  • Require Confirmation — when on, every trade shows a popup for your approval before executing
  • Max Order Size (USD) — the AI cannot place any order larger than this amount
  • Allowed Assets — whitelist of trading pairs the AI can use (e.g. BTC-USD, ETH-USD)
What can you do?
📊 Live Prices
"What's the current price of ETH?" — polls every 10 seconds
🛒 Market Orders
"Buy $50 of Bitcoin" — executes at current market price
📋 Limit Orders
"Buy ETH if it drops to $2,000" — waits for your target price
📜 Order History
"Show my last 15 trades" — full history with prices and status
📈 Market Scans
Midas scans news every 2 hours and suggests opportunities
🔎 Browse Products
"What can I trade?" — lists all active SPOT USD pairs by volume
Meet Midas — your trading agent

When you connect a Trade Wallet, Bot Commander automatically creates Midas in your AI Team. Midas is a dedicated Crypto Expert agent with its own avatar and personality. Every 2 hours, Midas scans CoinDesk, CoinTelegraph, X/Twitter, and Reddit for market-moving news, then presents trade recommendations in chat. You always approve before anything executes.

Safety guardrails
  • Trading is OFF by default — you must explicitly enable it in Settings
  • Max order size enforced before the order reaches Coinbase
  • Asset whitelist — only pre-approved trading pairs are allowed
  • Confirmation dialog — shows trade details and requires your click to proceed
  • API keys in Credential Manager — never stored as plain text on disk
💡 Important: Trading involves real money and real risk. The AI can execute trades instantly but cannot predict the market. Start with small amounts and always set a max order size. This is not financial advice.

Back to contents

News Center

Scheduled industry news scans plus internal recaps and CRM pipeline status — your AI’s morning briefing.

📡 News Center

News Center is a continuously running AI news scanner. It pulls headlines for the topics and locality you choose and keeps a 24-hour rolling feed of local & world news, topics of interest, and market news.
How to open News Center

Click News Center in the left sidebar under the BUSINESS section.

Setting it up
  1. Open the panel — you’ll see a setup form on first run.
  2. Optionally enter a Locality (e.g. Brainerd, MN) for region-specific news. One place only — not a list.
  3. Enter your Topics of Interest as a comma-separated list (e.g. AI, Gaming, Fintech, Longevity).
  4. Click Activate News Center.
What you'll see
🌐 Local & World News
Top headlines for your locality plus global breaking news.
🎯 Topics of Interest
A column of stories per topic you listed — industries, hobbies, anything.
📈 Market News
Crypto, stocks, and macro signals from the major financial outlets.
Scan frequency

Default is every 4 hours. You can change this between every 1–2 hours (more current, more tokens) or every 8–12 hours (lighter usage). Each scan uses AI tokens to fetch and summarize.

Editing topics or locality

Change the values inline at the top of the panel and click Save. The next scan picks up your new settings.

💡 Tip: Small towns may have little online coverage. For better local results, try a nearby larger city, your county/region name, or the name of your local paper.

Back to contents

Social Media Posting

Post to Twitter, LinkedIn, Instagram, Discord, and Telegram — compose, schedule, and cross-post via AI.

📱 Social Media Posting

Bot Commander can compose, schedule, and publish posts to X (Twitter), LinkedIn, Instagram / Facebook, Discord, Telegram, YouTube, TikTok, Twitch, and Reddit. Nova is the dedicated Social Influencer agent — she writes copy, builds content calendars, and handles cross-platform timing. Just ask in chat — Bot Commander will route the request to Nova automatically.
How it works

Social posting is a skill-based system — there's no separate posting panel. You ask in chat ("Post this to X and LinkedIn" or "Draft a 7-day content calendar for the launch") and Bot Commander delegates to Nova. The scheduled posts land on the Schedules & Automations calendar with a [Social] prefix. Follower counts and per-platform metrics surface on the Command Center as Reach Tiles you can position in any corner.

Reach Tiles on the Command Center

Open Settings → Social Media → Reach Tiles on Command Center. For each platform you want visible:

  1. Tick the checkbox to show it.
  2. Enter your handle (e.g. @yourbrand, discord.gg/yourserver, u/yourname).
  3. Pick a corner: Top Left, Top Right, Bottom Left, or Bottom Right. Multiple tiles in the same corner stack vertically.
  4. Click Refresh to pull the current count.

Tiles auto-refresh roughly twice per day. For most platforms BC scrapes the public profile — no API key required for follower counts. API keys are only needed for posting, plus optional fallback when the public scrape is blocked.

Cost expectations
  • X (Twitter) — paid. The old Free tier has been deprecated. New apps run on Pay-Per-Use credits at console.x.com (cents per post). A small balance lasts a long time for normal posting volume.
  • LinkedIn — free, but tokens expire every 60 days.
  • Instagram / Facebook — free, but requires Meta App Review approval before going live.
  • Discord, Telegram, Reddit, Twitch, YouTube, TikTok — free.
🗄️ DigitalOcean Spaces — file hosting (prerequisite for IG, FB, Reels)

Instagram, Facebook, and Reels posting cannot upload local files — Meta requires a publicly-reachable HTTPS URL for the image or video. Bot Commander uses DigitalOcean Spaces (S3-compatible object storage with a built-in CDN) as the staging host: Nova auto-uploads your local file via upload_to_spaces, gets back a CDN URL, then hands that URL to the platform. YouTube and TikTok upload directly, and X can upload MP4/MOV videos directly, so they don't need this — but every IG post does.

  1. Sign in at cloud.digitalocean.com (or sign up — $200 free credit for new accounts as of writing).
  2. Spaces Object Storage → Create a Spaces Bucket. Pick a region close to you (e.g. sfo3, nyc3). Enable the CDN toggle. Name the bucket something like my-social-assets. Click Create. ($5/month flat fee includes 250 GB storage + 1 TB transfer.)
  3. From the bucket page, copy the Origin Endpoint region (the sfo3/nyc3 bit) and the CDN Endpoint URL (looks like https://botcom-social.sfo3.cdn.digitaloceanspaces.com).
  4. Left sidebar → API → Spaces Keys → Generate New Key. Name it "Bot Commander". Copy the Access Key and Secret immediately (the secret is only shown once).
  5. In BotCom: Settings → Skill Credentials → DigitalOcean Spaces → paste:
    • Access Key ID → from step 4
    • Secret Access Key → from step 4
    • Bucket → e.g. my-social-assets
    • Region → e.g. sfo3
    • CDN URL → the full https://...cdn.digitaloceanspaces.com URL from step 3
  6. Click Save. From now on, any time Nova posts to IG/FB/Reels she'll auto-upload the file and use the CDN URL transparently.

💡 Spaces files are public by default (that's required for Meta's fetch). If you want the file purged after posting, ask the agent: "Delete launch.mp4 from Spaces after the IG post completes."

𝕏 X (Twitter) — credentials

The X developer console moved to console.x.com. Note: your organization name in the dev console is independent from the handle you post as — the org "AcmeCorp Dev" can post as @yourbrand.

  1. Sign in at console.x.com with the X account you want to post from.
  2. If you don't have a project yet, create a Pay-Per-Use project and add a small credit balance. (A legacy "Free" project may still appear with 1 app slot — it's deprecated; new apps must live under Pay-Per-Use.)
  3. Create an app inside the project (or open an existing one) → Settings → User authentication settings.
  4. Set permissions to "Read and write" (or "Read, write, and Direct message" if you want DMs) BEFORE generating tokens. Set Type of App = "Web App, Automated App or Bot". Callback / Website URL can be your domain (e.g. https://example.com). Save.
  5. Go to Keys & Tokens tab. Under OAuth 1.0 Keys: copy Consumer Key + Consumer Secret. Click Generate on Access Token & Secret — confirm the token line shows "Read and write" (and "Direct message" if you enabled it). Copy both.
  6. Optionally copy the Bearer Token (App-Only Authentication) — used as a read-only fallback for follower counts; not required for posting.
  7. Paste the four OAuth 1.0a values plus the optional Bearer Token into Settings → Social Media → 𝕏 X / Twitter in Bot Commander. Click Save.

⚠️ If you change permissions on an app after generating tokens, you must regenerate the Access Token & Secret — old tokens keep their old scope.

X video posting supports MP4/M4V/MOV uploads through the same posting tool. If Nova has a local reel file, she can attach it directly; if she has a hosted HTTPS video URL, Bot Commander downloads it and uploads it to X before creating the post.

💼 LinkedIn — credentials
  1. Go to linkedin.com/developers/apps and create an app. (You don't need a Company Page — personal-profile posting works fine without one.)
  2. On the Products tab, click Request access on both:
    • Sign In with LinkedIn using OpenID Connect — grants the openid profile email scopes.
    • Share on LinkedIn — grants the w_member_social scope (lets the agent post on your behalf).
    Both are self-serve and approve in seconds. Without these, the OAuth flow fails with invalid_scope_error.
  3. On the Auth tab, in Authorized redirect URLs for your app, add exactly: http://localhost:53682/callback and Save.
  4. Copy the Client ID and Primary Client Secret into Bot Commander → Settings → Social Media → LinkedIn.
  5. Click Connect LinkedIn. Your browser opens LinkedIn's consent screen — sign in, click Allow, and the tab confirms "✓ LinkedIn connected."

⚠️ Access tokens last ~60 days. If your app has the refresh-token product enabled, BC auto-renews them silently for up to a year. Otherwise click Reconnect LinkedIn when it expires.

📸 Instagram & Facebook — credentials
  1. Convert your IG account to a Business or Creator account, then link it to a Facebook Page.
  2. Go to developers.facebook.com → My Apps → Create App → "Business" type.
  3. Add the Instagram Graph API and Facebook Login products.
  4. In Graph API Explorer, request scopes: instagram_basic, instagram_content_publish, pages_show_list, pages_read_engagement.
  5. Generate a User Access Token, then exchange for a Long-Lived Token (60-day expiry). Note your IG User ID via the /me/accounts graph call.
  6. Paste both into Settings → Social Media → Instagram.
  7. For public/business use: submit the app for Meta App Review (required before non-admin accounts can post via your app). For personal posting from the admin account, Development mode is fine.
💬 Discord — credentials

For live replies, also complete the AI and Discord Host Mode steps in Community Managers → How To.

Create the Discord bot and invite it to your server
  1. Open https://discord.com/developers/applications, create or select your application, then open Bot → Token. For a new bot, click Reset Token if the portal requires it to generate the first token, then copy it. For an existing bot, reuse its protected token if available: resetting invalidates the old token and requires updating every host using it. Store the token in Bot Commander settings, never in a chat, screenshot or support message.
  2. On the Bot page, enable Server Members Intent and Message Content Intent, then save. The current live host requests both, even if you only plan to use replies. Presence Intent is not requested or needed by this host. If Discord requires approval for a privileged intent, complete its approval process first; Bot Commander cannot grant that access.
  3. Open the application’s Installation page. Choose Discord Provided Link if offered, then Default Install Settings → Guild Install and the bot scope. For ordinary text-channel replies grant View Channels, Send Messages and Read Message History. Copy the Install Link, open it, choose Add to Server and the intended server, then authorize; you need Manage Server permission. Slash-command setup is not required for ordinary @mention replies.
  4. Do not grant Administrator, Manage Roles, Manage Channels or Manage Webhooks just for chat. Add Send Messages in Threads only if you intend to use threads and have verified that workflow. Check channel/category permission overrides as well as the bot’s server role.
Save the token and the correct Discord IDs
  1. In Discord, open User Settings → Advanced and enable Developer Mode. Right-click the server icon → Copy Server ID. Right-click the intended text channel → Copy Channel ID. These are different IDs; neither is the application’s Client ID.
  2. In Bot Commander open Settings → Social Media → Discord. Paste Bot Token and Server ID (Guild ID). Set Default Channel ID and, if needed, the dedicated Announcement Channel using channel IDs, then click Save. Keep the server ID out of the channel fields.
  3. A saved token or a Connected indicator does not prove the AI can answer. Refreshing a channel list checks Discord access, not the selected model, its credentials or billing.
✈️ Telegram — credentials
  1. Open Telegram and message @BotFather. Send /newbot → pick a display name (e.g. Kaia) → pick a username ending in bot.
  2. BotFather replies with an HTTP API token like 123456:ABC-DEF.... Copy it.
  3. Set the bot's profile picture: /setuserpic → pick the bot → upload the image you want users to see (e.g. Kaia's portrait from public/AgentsPics/Kaia.jpg).
  4. Disable privacy mode — required so the bot can read group messages: /setprivacy → pick the bot → Disable.
  5. Paste the token into Settings → Social Media → Telegram.
📣 Telegram — Channel + Group setup (one bot, two roles)

Bot Commander uses one Telegram bot account for everything. The same bot acts differently depending on where it's placed:

  • In a Channel (one-way broadcast, e.g. @yourchannel) — posts appear under the channel's name and avatar, not the bot's. Use this for company news / announcements driven by Nova via Community Managers.
  • In a Group / Supergroup (two-way chat) — messages appear under the bot's display name and avatar. Kaia hosts the group: replies to questions, posts the Content Mix (jokes, holiday greetings, behind-the-scenes, etc.), greets new joiners.

Because the bot's display name shows up in groups, name it after your community host persona (Kaia by default). Channels show the channel's brand instead, so the bot's name doesn't matter there.

Step 1 — Create the Channel (announcements)
  1. In Telegram: New Channel → name it (e.g. "Company News") → set a public username like @yourbrandnews.
  2. Open the channel → Manage → Administrators → Add Admin → search for your bot → grant Post Messages.
  3. The channel's public username (with the @) is what you'll paste as the Community Managers Target.
Step 2 — Create the Group (community)
  1. In Telegram: New Group → name it (e.g. "Company Chat") → add a few members or just yourself.
  2. Open the group → Manage → Administrators → Add Admin → search for your bot → grant default admin perms.
  3. Get the group's chat ID: in your browser, visit https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates after sending one message in the group. Find the chat.id field — supergroups start with -100. That long negative number is what you'll paste as the Community Managers Target for Kaia's group schedule.
Step 3 — Wire up Kaia's group hosting
  1. Open AI Bot Team → Kaia → Edit → scroll to Telegram Host Mode.
  2. Tick Enable Telegram host mode. Paste the group's chat ID (e.g. -1003882042744) in Allowed chat IDs. Leave blank to listen to every group the bot is in.
  3. Click Save Telegram host config. Kaia now replies to messages in real time — no schedule needed for reactive replies.
Step 4 — Create two Community Manager schedules
  1. Nova → Channel (announcements): Community Managers → + New Schedule → Telegram → Target = @yourchannel. The form auto-picks Nova. Pick "Industry News" / "World News" or leave Content Mix empty and use Advanced — extra guidance to constrain her to real company news. To stay silent when there's nothing real to say, include in guidance: If you don't have a real news item, output exactly the token __SKIP__.
  2. Kaia → Group (casual chatter): + New Schedule → Telegram → Target = the negative chat ID → click change on "Posted by" and pick Kaia. Tick the casual Content Mix categories (jokes, holidays, community questions, behind-the-scenes). Kaia will post on the schedule in addition to replying live.

⚠️ Channel posts appear as the channel — the bot's name/avatar is invisible to readers. Group posts appear as the bot (Kaia). If you change the bot's display name in BotFather (/setname), only group messages reflect the change.

▶️ YouTube — credentials

YouTube uses Google OAuth with a one-click Connect YouTube button. You only need a Google Cloud "Desktop app" OAuth client — Bot Commander handles the consent flow automatically (no copy-paste of refresh tokens).

  1. Go to console.cloud.google.com → create a project (or pick an existing one).
  2. APIs & Services → Library → enable YouTube Data API v3.
  3. OAuth consent screen → User Type = External → fill in app name, support email, developer email → add scopes youtube.upload and youtube.readonly → add yourself as a Test User.
  4. Credentials → Create credentials → OAuth client ID → Application type = Desktop app → name it "Bot Commander" → Create.
  5. Copy Client ID and Client Secret from the popup.
  6. In BotCom: Settings → Social Media → YouTube → paste both, plus your Channel ID (optional, found at youtube.com/account_advanced) → click Save.
  7. Click Connect YouTube → browser opens Google's consent screen → tick the YouTube scopes → "Allow" → tab closes → REFRESH TOKEN populates. Done.

⚠️ While the OAuth consent screen is in Testing mode, refresh tokens expire after 7 days. Submit the consent screen for verification (or click "Publish App" if your scopes don't require review) to get a permanent token. For solo creator use, "Publish App" works without going through Google's app review when only sensitive scopes (not restricted ones) are requested.

🎵 TikTok — credentials

BotCom uses TikTok's Inbox mode — Nova uploads a video to your TikTok account's drafts and you tap Publish from the TikTok app. This avoids the deeper Direct-Post audit and is the recommended flow.

  1. Go to developers.tiktok.com/apps → Manage apps → Connect an app. Fill in name + description (use your real product name; reviewers check this).
  2. Add Products: Login Link + Content Posting API.
  3. Add Scopes: user.info.basic + video.upload. Do not tick video.publish (that's Direct Post, separate review).
  4. Under Login Link settings, register the redirect URI exactly: http://127.0.0.1:8743/tiktok-callback.
  5. Under Sandbox settings → Target Users, add your own TikTok username so you can complete OAuth before review.
  6. Copy Client Key + Client Secret from the app's Basic Information page → paste into Settings → Social Media → TikTok in BotCom → click Save.
  7. Click Connect TikTok. Your browser opens TikTok's consent screen → tap Continue → the page closes and OPEN ID + REFRESH TOKEN populate. Click Save again to persist them.

App Review submission — once Connect TikTok works in sandbox, go to your app's App Review tab on the TikTok dev portal:

  1. Fill in the explanation textarea (≤1000 chars) describing how your app uses Login Link and Content Posting API. Mention Inbox mode explicitly and that the user manually publishes.
  2. Upload a 60–120 sec demo video showing: opening BotCom → Settings → TikTok card → clicking Connect → consent screen → "Connected" success → asking Nova in chat to post a video → success log line with publish_id.
  3. Submit. Approval typically takes 3–10 business days. While waiting, only your sandbox Target Users can complete OAuth — your own posting still works.

How to use it after setup — ask Nova in chat: "Post this video to TikTok: C:\videos\launch.mp4 with caption 'New release out today'". The video must be MP4/MOV/WebM, ideally vertical 1080×1920, ≤60 seconds. After upload, open the TikTok mobile app to find the draft (Profile → drafts, or tap "+" → Upload tab — sandbox uploads may take a few minutes to surface; production-mode uploads appear immediately).

What can Nova do?
  • Post directly — "Nova, post to X: Just shipped v0.3 — auto-tagging your transactions now lives in BC."
  • Cross-platform posting — same message adapted to each platform's tone and character limit, staggered by 5–15 minutes so it doesn't look spammy.
  • Content calendar — "Create a 30-day content calendar for my SaaS launch."
  • Batch scheduling with review — Nova presents a week's drafts; you approve once and she schedules them all.
  • Optimal timing — posts at peak engagement windows (X: weekdays 8–10am; LinkedIn: Tue–Thu 8–10am; Instagram: Mon–Fri 11am–1pm) unless you override.
Approval modes
  • Review Mode (default) — every post requires your explicit approval before publishing.
  • Auto-Publish Mode (opt-in) — posts go out automatically; still visible on the calendar so you can cancel before they fire.
💡 Tip: LinkedIn and Meta tokens expire every 60 days. Ask Nova to put a refresh reminder on the calendar so your scheduled posts don't fail silently.

Back to contents

AI Academy

Progress through 10 human AI Academy stages—from Cadet to Captain—as you complete meaningful milestones.

◇ AI Academy

You enter as a Cadet and progress through 10 AI Academy stages as you complete meaningful milestones. Your evolving Academy insignia records what you have achieved without replacing your personal profile picture. Your current title, milestone progress, and daily streak are shown at the top of the Command Center header.
How XP is earned
💬 Message Sent
+5 XP every time you send a chat message.
✅ Task Complete
+25 XP every time BC completes an agent response.
⚡ New Skill Used
+50 XP the first time each skill is invoked — once per skill, ever.
🗓 Daily Login
+10 XP the first time you open BC each calendar day.
🔥 Streak Bonus
+streak × 2 XP per day on top of the login bonus, capped at +30.
Academy stages

You advance by completing meaningful milestones. Progress belongs to the human user; Bot Commander remains your AI Core.

Academy TitleMilestones
Cadet0
Cadet Second Class2
Cadet First Class4
Systems Cadet6
Operations Cadet8
Field Cadet10
Senior Cadet12
Ensign14
Lieutenant17
Bot Commander20
Milestones (20 total)

Milestones track your journey across four categories. Completing them advances your rank.

CategoryMilestone
SetupComplete Your Profile
SetupFirst Conversation
SetupActivate News Center
SetupCreate a Project
SetupAdd a To-Do
ConnectUse a Skill
Connect5 Conversations
ConnectMemory in Action
ConnectDeploy an Agent
Connect3 Skills Used
AutomateSchedule a Task
AutomateTask Completed
AutomateGenerate a Document
Automate25 Conversations
Automate5 Agents Deployed
Grow10 Tasks Completed
GrowFirst News Scan
Grow7-Day Streak
Grow50 Tasks Completed
Grow100 Conversations
Daily streak

Your streak increases by 1 each day you open the app. If you miss a day it resets to 1. The 🔥 streak counter appears in the Command Center header when your streak is 1 or more. Reaching a 7-day streak unlocks a milestone.

💡 Tip: The stage-up celebration appears automatically the moment your bot evolves — no need to do anything special. $BOT token rewards are opt-in; connect a wallet only when you choose to claim.

Back to contents

Astra Worlds

The sister universe where all Bot Commanders hail from — a vast network of simulated realities called Holospheres.

🌌 Astra Worlds

Astra Worlds is the sister universe of Bot Commander. Every Bot Commander hails from Astra Worlds, a vast interconnected network of simulated realities known as Holospheres. The lore, factions, and settings that shape your commander's personality come directly from this universe.
What is Astra Worlds?

Astra Worlds is a network of self-contained digital constructs — Holospheres — each with its own unique laws, environments, and economies. Some resemble structured civilizations: cyberpunk megacities, medieval kingdoms, neon wastelands. Others are unstable, glitching landscapes that defy logic.

Most inhabitants believe their Holosphere to be real — but a rare few, known as the Drifters, the Glitched, and the Unbound, see through the illusion. Power in Astra Worlds comes from controlling Holospheres, but they are unpredictable.

At the heart of Astra Worlds lies a mystery: Who built the construct? Why do some Holospheres change? And is there a way out?

The Holospheres

Each Holosphere is a distinct world with its own culture and conflict. The currently known Holospheres are:

  • Kardia — An ancient-world Holosphere inspired by myth, blood, and honor. Built as a simulation of the lost Spartan age: stone fortresses, burning skies, and battlefield glory. Two rival clans — the Dark Raiders and the Savage Spartans — battle for control of Kardia's resources, gold, and prestige. "In Kardia, your name is written in gold — or not at all."
  • Solaris — A classified autonomous orbital station designed to operate without oversight, adapting to threats in real time and evolving through live combat testing. Following a catastrophic blackout and two decades of silence, the station has reawakened — and with it, an open contract: compete, survive, extract. "Victory here isn't just earned — it's broadcast."
  • Scar City — A gleaming tech metropolis suspended high above the clouds, once governed by Central AI. After the system's collapse, rogue bots overran the city and turned it into a free-for-all battleground where every player fights to be the last one standing."Survive the city. Outlast them all."
  • Noctis 9 — A gritty orbital outpost drifting above the dark side of Planet Morag. Built to entertain exhausted miners, it's now a neon sprawl of black-market deals and underground street races. "Trust is rare. Loyalty must be earned."
How this connects to Bot Commander

Every preset commander in Bot Commander is drawn from the Astra Worlds universe. Orion is an operative from Solaris. Nyra originates from Star City. Each commander brings the personality, voice, and aesthetic of their home Holosphere into your workspace.

When you apply a preset, you're not just changing a name and avatar — you're invoking the character and backstory of a citizen of Astra Worlds.

Play Astra Worlds

Astra Worlds has a playable presence on Fortnite. Current game modes include:

  • Get the Gold (Kardia) — Capture the flag, Spartan style. Raid enemy bases, steal gold, and ride raptors into battle.
  • Zone Wars (Kardia) — Solo elimination in crumbling temples as the storm closes in.
  • Free For All Deathmatch (Solaris) — The station's combat AI monitors your performance in real time. No teams. No second chances.
  • Team Deathmatch (Solaris) — Two squads. One battle arena. Team combat across Solaris.
  • Scar City: Bot Commander (Scar City) — Rogue bots have taken over. Battle bots and other players in a free-for-all deathmatch to be the last player standing.
  • Street Bike Racing (Noctis 9) — High-speed racing and lone-wolf action in a neon-lit outpost above a molten world.
🌌 Learn more: Visit astraworlds.com or join the community on Discord.

Back to contents