The Agent tab
The screen is three columns and each one has a job.
Opening the tab starts a fresh conversation. Clicking any title on the right reopens that one exactly where you left it.
Pick your channels first
Click the avatars on the left for the accounts this conversation is about. That selection rides along with every message you send, carrying each channel’s id, platform and posting settings, so she always knows what she is writing for. She does not guess the rules. Before she schedules anything she looks up that platform’s character limit, its required settings and its restrictions, then follows them even if you ask her not to. Running an agency? Ask her for your groups and she lists your customers, then narrows the channels down to the one you name.What she can reach from the chat
Ten tools sit behind the conversation. You never call them by name, but this is the honest list of what she can touch:
Generating a video draws on the video credits of your plan.
Hand her a photo
Just above the message box there is a media bar. Insert Media opens your Media Library, where you can pick something you already uploaded or upload something new. Design Media opens the designer. On a plan that includes AI you also get buttons for an AI image and an AI video. Whatever you attach travels with your next message, and it shows up inside that message in the conversation: pictures as pictures, mp4 files as a player you can press.From chat to calendar
Before she schedules, she reads the whole thing back to you: the text, the media, the date and time, the platform and the account. Say yes and she offers you two ways to land it.- Schedule it now. She writes the post straight to your calendar and tells you it is there.
- Open it in the editor. She fills the post editor with the content and media she wrote, one editor per channel, and hands it to you unfinished. Nothing is on the calendar until you finish in the editor.
A post she writes can be scheduled for later, published immediately, or saved as a draft. A draft is a state, not a queue: it sits on your calendar unscheduled until you publish it yourself.
Your conversations stay
Every conversation is saved with a title she writes for it, and the right column keeps them in order. Reopen one and the messages come back from the server, not from your browser, so the same history is there on your laptop and on your phone. Threads are stored against your organization rather than your personal login. Anyone on your team who opens the Agent tab sees the same list of conversations.Generate Posts
Some mornings you do not want a conversation. You shipped a thing, you have a link, and you want posts about it. On the calendar, in the channels column beside the button that opens a new post, there is a small sparkle button. It appears once you have at least one channel connected and your plan includes AI. Click it and the Generate Posts window opens with four fields.
Press Generate and she works in the open. The line above the form names each step as it runs:
Then the post editor opens with the hook sitting on top of the first post, the pictures attached and the date already chosen. Change anything you like before it goes out.
Short formats aim for around 200 characters so they fit X. Thread formats always come back as at least two posts. She writes no hashtags and tends to end on a call to action.
Self-hosting and cannot find the sparkle button? That one is deliberate. Every click runs a research step, a writing step and an image step, and each of those is a paid model call on somebody’s key. So the button appears only when your plan includes AI and billing is switched on, which happens when both
STRIPE_PUBLISHABLE_KEY and STRIPE_SECRET_KEY are set. An install with no Stripe keys is unlimited in every other way. The chat in the Agent tab is not gated like this: give it an OPENAI_API_KEY and she answers there with no Stripe keys at all.What she needs to run
On postqueen.ai her chat belongs to the plans that include AI, so a free plan cannot open a conversation with her.
When she does not answer
The chat replies that AI features are not configured
The chat replies that AI features are not configured
That is the literal message when
OPENAI_API_KEY is unset on a self-hosted install. Set it,
recreate the container, and the chat answers. Nothing else is required for the chat: unlike
the sparkle button, it is not gated on billing.Generate runs and then stops partway
Generate runs and then stops partway
She names each step as it goes, so the last line on screen tells you where it stopped. A
research or image step that fails is usually the model provider refusing the call: a spent
quota, or a key without access to that model. If the chat still answers using the same key,
the problem is the specific model rather than the key itself.
Video generation says there are no credits
Video generation says there are no credits
Video draws on your plan’s video credits, which are a separate counter from the AI allowance.
Room for images does not mean room for a video.
Keep going
Talk to her outside the app
The same assistant, reached from your chat apps, your editor or your terminal
Connect your own AI tools
Point an MCP client at her from Settings > Developers and it gets the same tools
Drive her from the terminal
Every command and flag, with clean JSON on the way back
Next steps
Talk to her outside the app
Claude, ChatGPT or any assistant, on the same calendar
Writing a post
What the composer does once she hands the draft over
Media and design
The images and video she can generate for a post
Plans and limits
Which plans include the AI features