Seller Assistant

The Seller Assistant is a chat panel you can open from any tab. It helps you understand your business and the app:

• Ask your business answers questions about your sales and inventory.
• Why this price explains a price Bricker Mode recorded.
• Problem inbox lists things that need your attention.
• How do I… answers questions about the app from this user guide.
• Generate title & description drafts the listing text in the Marketplace Workspace.
• Telegram gives you /ask, /why and /inbox on your phone.

RestocksAIO calculates every figure from the data loaded in the app and shows the rows it used. The assistant only reads and explains. It never sets a price, deletes a listing, accepts an offer or starts or stops a task.

Plan

The Seller Assistant needs Premium. On another plan:

• The assistant button stays on every tab. Its tip reads Seller Assistant is a Premium feature. Upgrade to Premium to ask the assistant and to write listing text with AI. A click answers Your membership doesn't allow using this feature, upgrade to Premium! and the chat does not open.
• Why this price, Why this recommendation, a question and the Problem inbox give the same answer. No answer is made, with AI or from the help pages.
• On Telegram, /ask, /why and /inbox answer Seller Assistant is a Premium feature.
• Settings → AI opens and keeps its values. Load models, Connect Claude and Connect Codex (ChatGPT) show the membership message.
• No AI request leaves the app. Your saved key, your sign-ins, the remembered chat and your writing style are not deleted.

Open the assistant

Click the round purple button with the robot icon at the bottom-right of the window. It is there on every tab.

The chat opens as a panel on the right side of the window. The tab behind it stays usable.

• The header shows Assistant and the tab you are on, for example On Bricker Mode. If you have a Bricker controller, an Inventory item or a Listings group selected, it is named too (· DD1391-100 selected). The assistant uses this to understand what "this" means.
• The conversation is kept when you switch tabs, click a Review or Open button, or hide the panel with ×.
• Clear chat (bin icon) empties the conversation and stops a running answer.
• While a feature dialog is open, the assistant button steps aside so it does not cover the dialog's buttons.

The chat

Type in Ask anything… and press Enter or click the arrow button. Messages can be up to 1,000 characters.

• Answers stream in as the model writes them. While it works, the arrow button becomes Stop. A stopped answer keeps what was written so far and is marked (stopped).
• Under each answer you see the model that wrote it, or Local figures · no AI when no model was used. Hover over that line to see the data snapshot time and coverage.

Suggestions. The buttons above the input change with the tab and your selection:

Every tab also has How do I…, which puts "How do I " in the input for you to finish.

The + button next to the input opens the quick actions: Ask about sales, Why this price (selection), Problem inbox, How do I… and, when your model accepts images, Attach image….

Evidence rows and buttons

When an answer uses your figures, the rows it used appear under it: the product, then the kind of row, site, size and count, and the amount in its own currency. Hover over a row to see its row number (E1, E2…) and where the figure came from. The answer refers to rows by these numbers.

• Review opens the screen that owns the row (for example Bricker Mode, Listings, Sales or Inventory) and searches for it there.
• The assistant can also offer buttons such as Open DD1391-100 in Bricker.
• These buttons only navigate. Nothing changes until you make the change yourself on that screen, where changes still ask for confirmation.

Use AI

Under the input is the checkbox Use AI (sends this chat to my AI gateway). The checkbox has the same text when you use a Claude or Codex subscription.

• It starts unticked every time you open the app. Tick it when you want an AI answer.
• Without an AI provider it is disabled, with the note AI is not set up (Settings → AI). Help search, the problem inbox and recorded price evidence still work. See Setup.

With Use AI unticked, nothing leaves your computer:

• A typed question is answered from the help pages bundled with the app. You get the three best-matching sections, with their page names under the answer. Questions about your figures need Use AI.
• Problem inbox shows its findings as they are.
• Why this price and Why this recommendation show the recorded evidence without an AI explanation.

With Use AI ticked, your message, the tab and selected product, the recent conversation, an attached image and the figures the assistant reads are sent to your AI provider.

What the AI can do

The model cannot change anything. It can only use these read-only tools, and RestocksAIO checks every request before running it:

• run a report over your loaded sales, inventory sales, inventory and listings (Ask your business);
• read the recorded Bricker price decisions for a SKU (Why this price);
• read the Problem inbox;
• search this user guide (How do I…);
• offer a button that opens a screen.

If you tell it to change something, for example "change the price of DD1391-100 to 100", the request is not sent. You get I only read and explain, so nothing was changed… and a button to the screen where you can make that change. A question about how to change something is answered normally.

Per message, the model can work for up to 4 rounds and 8 tool uses, and it sees the last 12 messages of the conversation. Answers are limited to 4,000 characters. Links in answers are removed, and an answer that contains contact details or something that looks like a password or key is withheld.

Limits

On the desktop you can make one AI request every 3 seconds and 200 per day (UTC). One message counts once, however many tools it uses. Over the limit you see Please wait 3 seconds between AI requests. or Daily AI request limit reached (200). Help search, the inbox and recorded figures still work without AI. Telegram has its own limits (see Telegram).

Images

Attach image… appears in the + menu only when your gateway's model list says the chosen model accepts images. If the gateway does not say, the option stays hidden.

• PNG, JPEG or WebP, up to 4 MB.
• The image is sent once, with your next message, and only with Use AI ticked.
• The assistant can describe what it sees. It does nothing else with the image.

How do I…

The assistant knows this user guide. The pages are bundled with the app, so they match the version you run and nothing is fetched from the internet. Answers name the pages they used (Docs: Telegram Bot), so you can read the full page here.

• Without AI, you get the three best-matching sections.
• With AI, the model searches the guide and answers in its own words.

Setup: connect an AI provider

The assistant has no built-in model. You connect your own provider in Settings → AI. The Provider list has three options:

The line at the top of the page shows the state: Using the gateway · (model), Using Claude subscription · (model), Using Codex (ChatGPT) subscription · (model) or Not configured · Suggest is absent everywhere.

Sign in with a Claude or Codex subscription

1. Open Settings → AI and choose the provider.
2. Click Connect Claude or Connect Codex (ChatGPT). A browser tab opens.
3. Allow RestocksAIO in the browser tab.
   • Claude: paste the code Claude shows into Paste the code, then click Finish sign-in.
   • Codex: the sign-in finishes by itself. If the tab shows an error page, paste its address into the same field.
4. Pick a model in Pick a model.

The row then reads, for example, Claude · Connected · (account) · (plan). Disconnect deletes the sign-in from this device. If the row reads Sign-in unreadable on this device, reconnect, click Reconnect.

Connect a gateway

1. Open Settings → AI and choose Gateway (OpenAI-compatible URL).
2. Enter the gateway's Base URL, for example https://api.example.com/v1 or http://your-gateway:20128. If you enter only the address (no path), RestocksAIO adds /v1.
3. Paste your API key. Click Show to check it.
4. Click Load models. RestocksAIO asks the gateway for its model list. No model is called yet. When this works, the status line reads Connected · N models.
5. Pick a model in Model. If your gateway has no model list, type the model id.

Your settings are saved when you click Load models and when you leave the AI page. The top of the page then reads Using the gateway · (model).

If the page shows This model can't use tools; the chat will only answer from help text, pick another model for full chat answers.

Two more options are on the page. Both are off by default: Summarise long chats with AI and Remember the chat after restarts. Forget conversation in the + menu of the chat deletes the remembered chat.

• The key and a subscription sign-in are stored encrypted on this computer: in the login Keychain on macOS and in a file encrypted for your Windows user on Windows. It is never saved in a profile file. Leaving the key field empty keeps the saved key.
• Use https://. Plain http:// is accepted only when the gateway runs on this computer or on a private network: localhost, a LAN address (10.x, 172.16–31.x, 192.168.x), a Tailscale address (100.64.0.0/10 or a *.ts.net name), or a single-word host name that resolves only to those addresses. Any other plain-http address is refused.
• RestocksAIO does not follow gateway redirects. Enter the final gateway URL.
• The model must support streamed chat completions. For the chat it must also support tool calls, and for Suggest structured JSON output (response_format with json_schema). A model can appear in the gateway's list and still fail this. If requests fail with "invalid response", try another model.

Ask your business

Tick Use AI and ask in the chat, or use a suggestion. On Telegram, send /ask <question>.

Examples:

• "Best-selling products this month"
• "Payout on StockX between 2026-09-01 and 2026-09-30"
• "Sales of DD1391-100 by size"
• "Inventory cost by month"

How it works: the model only turns your question into a report plan: the data (marketplace sales, inventory sales, inventory or listings), the dates, product, site, grouping (product, site, size, month or status), metric and sort order. RestocksAIO checks the plan and calculates every figure itself. The figures and the rows under the answer come from your loaded data, not from the model.

What to expect from the figures:

• Payout and sale price are separate. For inventory sales, the payout (after fees) and the sale price (before fees) are separate rows. A missing payout stays unknown. It is never replaced by the sale price.
• Pending sales are separate. Marketplace sales that are not completed yet appear as their own row, outside the sales payout total.
• Marketplace sales and inventory sales are separate. They have no reliable shared order number, so they are never added together.
• No mixed currencies. Each currency has its own row and nothing is converted. Counts can combine currencies. Amount rankings show the top results within each currency.
• No profit and no tax. Payout is not profit. The assistant does not calculate profit or taxes.
• Products are matched by product ID. Records are grouped by product ID, not by style code, so two colourways that share a style code stay apart. A record without a product ID joins the product its style code belongs to. If that style code belongs to several products, the record is not merged and the coverage counts it.
• Your local dates. "Today", "yesterday" and "this month" use your computer's calendar day. A date range can cover up to 366 days.
• Coverage is shown. The assistant reads up to 10,000 rows per source, shows up to 100 rows and sends up to 60 to the model. The coverage (hover over the line under the answer) reports the snapshot time, the number of matching records, unknown dates and costs, and any rows that were left out.

A message containing an email address, phone number or anything that looks like a password or key is not sent to the gateway.

If the provider fails, you see its message followed by No answer was substituted., for example AI timed out. No answer was substituted. No AI answer is made up.

Why this price

Why this price explains the last pricing decision Bricker Mode recorded for a product. It does not calculate a price, recommend a new one or change anything.

Open it from:

• Bricker Mode: right-click a controller and choose Why this price (selected controller). The chat opens and asks Why this price? (SKU) for you. With a controller selected, you can also use the Why this price? (SKU) suggestion or Why this price (selection) in the + menu.
• Bricker Recommendations: right-click a recommendation and choose Why this recommendation. The chat opens on the main window with that recommendation's figures. The recommendations window stays open.
• Telegram: send /why <SKU>.

Without Use AI, you see the recorded evidence rows. With Use AI, the model also explains them in writing.

What the evidence contains:

• For every Bricker task whose controller has the same style code (76.98445 and 76-98445 count as the same), there is one row for the ask decision and one for the payout bounds. The ask row shows the chosen indicator and its reason, the candidate price, the undercut, the price before and after, the highest bid, any guard that applied and the outcome (held, blocked, attempted, succeeded or failed). The payout row shows the current and candidate payout and your LP floor and MP ceiling.
• Ask prices and payouts each keep their own currency. They are never converted into each other.
• A task with no record shows Price trace unavailable. The assistant says so and does not guess why.
• Up to 48 rows go into one explanation. Any rest are counted in an Omitted evidence row.

On Telegram, /why needs Premium, as every Seller Assistant command does.

Problem inbox

Click Problem inbox in the suggestions or the + menu, or send /inbox on Telegram. RestocksAIO checks your loaded data against fixed rules:

Sites that are "not covered". The stale-listing rule needs a per-listing check time. StockX, Alias and the other existing marketplaces keep only an account-level sync time, so their listings are not checked. The coverage lists them as not covered. It does not mean they are fine.

• Without AI (Use AI unticked, or /inbox on Telegram), the findings are shown as they are. Nothing leaves your computer.
• With AI (Use AI ticked, or /inbox ai), the findings are also sent to your gateway, which summarises them and ranks them by known money exposure within each currency. Findings with an unknown amount stay listed.
• Up to 100 findings are shown, shared across currencies. The coverage says how many were left out per currency.

Click Review on a row to open the screen where it can be fixed. The assistant never fixes anything itself.

Suggest: listing title and description

In the Marketplace Workspace, Listing quality shows the button Generate title & description in the Title and Description sections. It writes the title and the description together, in your writing style, from the data of this product only. It appears only after you set up an AI provider. Other sections, such as Attributes, do not have it.

Writing style next to the button opens your own instructions for titles and descriptions, with Learn my style and Reset to default.

• What is sent: the product facts (brand, name, colourway, style code, department, category), this item's size and condition, the item specifics the listing holds as facts, a shipping line, your writing style guide, the title and description the app built without AI and, if you applied the Keywords row of Similar listings, up to 8 words that similar eBay listings use in their titles. A name or style code you typed yourself is sent when the catalogue has none. No photo is sent. Descriptions, photos, prices and seller names of other sellers' listings are not sent. Title words from similar eBay listings are sent as hints only, and a word that comes only from them is not allowed in the title. If the product has no name and no brand, you see AI request needs catalogue facts.
• The result is a preview marked SUGGESTED. Click Keep to use it or Discard to drop it. The preview shows the model that answered, how long it took and the tokens used.
• For a title, the preview shows its length against the channel limit. A title over the limit cannot be kept. Generate again or edit the title yourself.
• Leaving the product, channel or section cancels the request and throws the result away.
• If the request fails, you see the error. RestocksAIO never puts catalogue text in its place and calls it AI.

Telegram

If you use the Telegram Bot, these commands use the same evidence as the desktop:

• Plan. Every command in this table needs Premium. On another plan the bot answers Seller Assistant is a Premium feature.
• Private chat only. In a group, the bot replies "Use a private chat with this bot for business figures." Only user IDs in your authorised list can use the commands.
• Rate limits. Each user can make one AI request every 10 seconds and 50 per day (UTC). Over the limit, the bot replies Please wait 10 seconds between AI requests. or Daily AI request limit reached (50). /inbox still works without AI.
• Replies contain the answer, snapshot time, coverage, model and up to 30 evidence rows. Open the desktop assistant to see more.
• No links. Links in replies are replaced with [link removed] and link previews are off. Anything that looks like a key or token is replaced with [redacted]. Links in model-written answers on the desktop are removed the same way.

Confirm cards

Accepting an offer, and Start All / Stop All in Bricker Mode, ask for confirmation first. This applies to the Accept Offer button on offer notifications, /bricker_start_all, /bricker_stop_all and the buttons under /bricker_stats.

The bot sends a card with Before and After lines (for example Before: 3 of 7 controllers running) and Confirm / Cancel buttons. Nothing changes until you tap Confirm.

• One use. A card works once.
• Expires in 2 minutes. An old card replies "Confirmation expired, already used or belongs to another chat. Request a fresh card."
• Owner-bound. Only the user the card was sent to, in that chat, can use it. A new card replaces your previous one.
• One accept per offer. When one user confirms, every other user's card for the same offer or Bricker action stops working, and an offer can only be accepted by one card at a time.
• Changes void the card. If the offer or listing price changed, you get "The listing or offer changed. Request a fresh confirmation." For Start All, a change in the number of controllers, running controllers, tasks or sold tasks needs a new card. Stop All always runs on confirmation, because stopping is the safe direction.
• An offer without a marketplace listing ID has no Accept Offer button.

Privacy: what is sent

Nothing goes to your AI provider unless you ask for an AI result: on the desktop you tick Use AI, and on Telegram you send an AI command. With a gateway, the data goes to the gateway you configured. With a Claude or Codex subscription, the same data goes directly to Anthropic or OpenAI.

Never sent: your marketplace account logins, tokens and profiles, buyer details, or your licence key. Email addresses, phone numbers and anything that looks like a password, token or key are removed from evidence ([redacted]). A message that contains them is not sent at all. Your API key goes only to the gateway you configured, as its authorisation header.

What it does not do

• It does not change prices, delete listings, accept offers or start and stop Bricker tasks. Those actions stay where they always were, and on Telegram they need a confirm card.
• It does not reply to buyers, source stock or run on its own.
• It does not act on images. It can only describe them.
• It does not calculate profit or taxes, or convert between currencies.
• It does not work while the app is closed. Everything comes from the data loaded in the app.
• It does not invent reasons for past prices. Price records start with this version.
• It has no hidden backup model. If your gateway fails, you see the error and the local figures.

Troubleshooting

Loading models (Settings → AI)

In the chat

Requests (Suggest, chat, Telegram)

If Telegram replies "Use /ask <question> or /why <SKU> (up to 1000 characters)…", add your question or SKU after the command.