Help & documentation

Everything in BAWDA AI, explained in one place. Use the search bar above to jump straight to what you need instead of scrolling — press / anywhere on this page to focus it.

Overview

BAWDA AI is a single home for working with several AI providers — Claude, ChatGPT, Gemini, Copilot, and Perplexity — instead of switching between separate apps. Everything is arranged around three areas: a navigation menu on the left, a chat window in the middle, and a task monitor on the right.

Right now this is a layout and interaction prototype. The sections below describe how each part is meant to work. Anything not yet connected to a real AI provider is marked Coming soon so you always know what's live versus planned.

Workspaces

A workspace is the outermost container in BAWDA AI. Each one holds its own separate set of Projects — and eventually its own Chats, Skills, and Integrations — so different parts of your work never mix together.

The pill just below the BAWDA AI logo always shows your current workspace. Click it, or click Workspace at the top of the left menu, to see every workspace you've created.

Switching workspaces — click anywhere on a workspace card (other than its icons) to make it active. The pill updates immediately, and Projects switches to show that workspace's own projects.
Creating a workspace — click New workspace, give it a name and an accent color, then click Create workspace. It starts out empty, ready for its own projects.
Renaming a workspace — hover a card and click the pencil icon. The name becomes editable right there — press Enter or click away to save, or Escape to cancel.
Deleting a workspace — hover a card and click the trash icon, then confirm. If it has projects inside it, you're told they'll be removed too. If it's your current workspace, you're told which workspace you'll be switched to instead. You always need at least one workspace, so the last remaining one can't be deleted.

Workspaces, and everything inside them, currently last for your browsing session only. Saving them permanently is Coming soon, once real storage is connected. Scoping Chats, Skills, and Integrations to each workspace — the way Projects already are — is also Coming soon.

Workspace — opens the workspace list, covered in its own section above.
New task — starts a fresh conversation. See the New task section below.
Chat, Projects, Skills, Integrations — the main areas of the app, all fully built.
Models — the list of connected AI providers, covered in its own section below.
Recent chats — your past conversations, listed for quick access. You can rename any of them by hovering and clicking the pencil icon; reopening one to continue the conversation is Coming soon.
Your name and avatar at the very bottom — opens the account menu, covered in its own section below.

Collapsing the menu: click the arrow next to the "BAWDA AI" logo to shrink the menu down to just icons, useful when you want more room for the chat. While collapsed, click the "B" logo mark to bring the full menu back.

Account menu & signing in

Click your name and avatar at the bottom-left of the menu to open the account menu — not a settings icon, not a hamburger menu, your actual name and picture. It opens a small popover with:

Settings, Support, Privacy Policy, Terms of Service — placeholders for now. Clicking any of them just closes the menu; there's nothing behind them to open yet Coming soon.
Sign out — sits below a thin divider, separating it from the items above as a distinct kind of action. It's plain text with no icon and the same neutral color as everything else in the menu — signing out isn't treated as a dangerous or destructive action, just a routine one.

Signing out happens the moment you click it — no "are you sure?" confirmation. Your local session is cleared immediately and you're taken to the Sign In page. If you have BAWDA AI open in more than one browser tab, signing out in one tab signs you out of all of them — the other tabs notice and follow automatically, without needing to be refreshed.

Signing in lives at sign-in.html, a standalone page with no sidebar — it's the gate you pass through before reaching the app, not something nested inside it. It includes email and password fields with a show/hide toggle, a "Remember me" checkbox, Google and GitHub buttons, and inline error messages for things like an incorrect password or a locked account — never a browser pop-up alert.

Sign in with Google is real — it opens an actual Google account picker and signs in with a real Google account, using Google's own Identity Services library. It needs a one-time setup step: a Google OAuth Client ID pasted into sign-in.html, and it only works once the page is served over a real web address (not opened as a local file). GitHub is still mocked — no GitHub app is connected, so it always shows the spec's defined "couldn't sign you in" message and falls through to the email form, the same as before.

Forgot password (forgot-password.html) and Sign up (sign-up.html) are linked from the Sign In page. Forgot Password is functional: enter an email and it shows a confirmation that a reset link was sent — deliberately the same message whether or not that email actually has an account, so the page never reveals who has signed up. Sign Up is an honest placeholder: the form is there, but submitting it says plainly that sign-up isn't connected yet, rather than pretending to create an account Coming soon.

Aside from Google, none of this is backed by a real account system yet — there's nothing to sign up for in the traditional sense, and "signed in" is currently just a flag the app remembers for you locally, even for Google (its access token is never checked by a server, because there's no server yet to check it). The Sign In page has its own collapsed "Testing this page?" note at the bottom with a few sample email addresses that trigger each type of error message, if you want to see what they look like. A real backend to verify Google's token, plus real email/password accounts and a real database, are all Coming soon.

Default chat shortcuts

Clicking Chat in the left menu opens a fresh chat screen with a set of default shortcuts underneath the "What can I help you with today?" prompt. Each shortcut is a full, ready-made message — click one and it's sent immediately, exactly as if you'd typed it yourself and pressed Enter.

Right now there's one example shortcut, "What is the weather today?", to show how the feature works. More shortcuts will be added to this list over time.

The chats listed under Recent chats in the left menu can be renamed too — hover a chat and click the pencil icon that appears, edit the name right there, then press Enter or click away to save, or Escape to cancel.

Projects

Projects are folders for organizing your chats, and they belong to whichever workspace you're currently in — switch workspaces and you'll see a different set of projects. Click Projects in the left menu to see every project inside your current workspace, laid out as a grid of cards. Each card shows the project's color, its name, how many chats are inside it, and when it was last updated.

Creating a project — click New project in the top-right of the Projects screen (or the button shown when you have no projects yet). Give it a name, pick one of six accent colors, and click Create project. It appears at the top of your grid immediately.
Renaming a project — hover a card and click the pencil icon. The name becomes editable right there — press Enter or click away to save, or Escape to cancel, the same way renaming a workspace or a chat works.
Deleting a project — hover over any project card and click the trash icon next to the pencil. Confirm in the dialog that follows. Deleting can't be undone, so you're always asked to confirm first.
Opening a project to see the chats inside it is Coming soon — for now the grid shows you what exists, and creating/renaming/deleting all work fully.

Projects you create currently last for your browsing session only. Saving them permanently is Coming soon, once real storage is connected.

Skills

Skills work the same way they do for the AI models themselves: a skill is a name, a short trigger describing when it should be used, and a set of instructions to follow when it's relevant. They're personal to you, not tied to a specific workspace or project. Click Skills in the left menu to see every skill you have.

Learning a new skill — click Learn new skill, then fill in a name, the trigger (when it should be used), the instructions it should follow, and an accent color. Click Learn skill and it's added to your list immediately, switched on by default.
Turning a skill on or off — each skill card has a toggle in its bottom-right corner. Off skills stay in your list, dimmed, without being considered for anything until you switch them back on.
Renaming a skill — hover a card and click the pencil icon, the same inline-edit pattern used for workspaces, projects, and chats.
Deleting a skill — hover a card and click the trash icon, then confirm. This can't be undone.
How to Create a New Skill is included by default — a starter skill that explains the process of building your own, the same way a "how this works" example is built into Claude's own skill system.

Skills actually being read and applied by the AI models when they respond is Coming soon — right now you can fully build and manage your library, and that library is what future responses will draw from once real model calls are wired up. Skills also currently last for your browsing session only, the same as workspaces and projects.

Integrations

Integrations are third-party apps — Gmail, Google Calendar, Slack, and so on — connected over API so BAWDA AI and that app can talk to each other. Once connected, an AI model can act on it directly: for example, once Gmail is connected, you'd be able to ask any model to write a new email, search your inbox, send a message, or delete one, without leaving the chat. Click Integrations in the left menu to see everything currently connected.

Connecting a new integration — click Connect new integration to open a list of available apps, each showing what it would let BAWDA AI do (for example, Gmail lists "Read emails, Search inbox, Draft emails, Send emails, Delete emails"). Click Connect next to one and it's added to your list right away, active by default.
Turning an integration on or off — the toggle in the bottom-right of each card pauses it without disconnecting it. Off integrations stay connected but won't be used until you switch them back on — the same behavior as Skills.
Renaming an integration — hover a card and click the pencil icon. Handy if you connect more than one account of the same service — a work Gmail and a personal Gmail, for instance — and want to tell them apart.
Disconnecting an integration — hover a card and click the trash icon, then confirm. BAWDA AI loses access to that app until you reconnect it.

Six apps are available to connect right now — Gmail, Google Calendar, Google Drive, Slack, GitHub, and Notion — with Gmail and Google Calendar already connected as examples. More apps being added to the catalog, the real OAuth connection flow, and AI models actually calling these integrations while chatting are all Coming soon. Right now this screen fully covers building and managing your list of connections.

Switching AI models

Under "Models" in the left menu, each provider is listed with a colored dot and its current version. Click any provider to make it the active model for your next message.

The top status bar updates to show the model and version you picked.
The composer's placeholder text changes to "Message [Model]…" so it's always clear who you're talking to.
The small row of dots in the status bar (the "tuner") lights up to match your selection.

Getting a real response back from that provider's API is Coming soon — right now switching updates the interface and your messages appear in the thread, but the AI doesn't reply yet.

Top status bar

This one-line bar sits above the chat and always shows which AI you're currently using.

Model pill (left) — shows the active provider and version. Click it to jump back to the model list.
Tuner dots — a quick visual reference for which provider is active.
Search icon — opens global search inside the app, covered below.
Help icon — opens this help page in a new tab.

Chat window

The middle column is where conversations happen. Messages you send appear on the left with your initials; AI responses appear with the provider's icon and a small tag showing the exact model version that replied.

Type in the box at the bottom — it grows automatically as you write more. Press Enter (or the send button) to add your message to the thread, or Shift+Enter for a new line without sending. Press the paperclip to attach a file Coming soon.

New task

Click New task at the top of the left menu to clear the current conversation and start over. The chat window shows "What can I help you with today?" along with the model that will respond, and your cursor is placed straight into the message box so you can start typing immediately.

Global search (in the app)

Inside the main app, click the magnifying glass in the status bar, or press Ctrl + K (Cmd + K on Mac), to open a floating search bar. Start typing to filter across everything in the app at once — sections, models, past chats, and tasks — grouped by category so results are easy to scan.

Close it by pressing Esc, clicking outside the search box, or selecting a result.

This is a separate search from the one on this help page — that one searches your app data; this one searches the documentation you're reading right now.

Task panel

The right-hand column shows work currently running across your connected AI providers, with a status pill for each: Running, Queued, or Done, plus a progress bar.

Click any task card to open its details in a panel that slides in from the right, showing the full status, which provider is handling it, progress, and a timeline of log entries. Close it with the X, a click outside, or Esc.

Help button & this page

The question-mark icon in the app's status bar opens this page in a new tab. Keeping documentation separate from the app itself means this page can grow — more sections, more detail, its own search — without ever slowing down or cluttering the app you're actually working in.

This page is meant to stay up to date as new features are added, so if you ever forget how something works, search here instead of guessing.