Workspaces: organize projects and collaborate

A workspace is the top-level container in Genie that brings your projects and people together in one place. Instead of working in isolation, your team shares a single environment where every project is visible, activity is tracked, and everyone works from the same context. You can belong to multiple workspaces — for example, one for your company and another for a side project — and switch between them instantly from the sidebar.

​

Create a workspace

​

The workspace home

When you open a workspace you land on the workspace home — your team’s dashboard. It has three main areas:

​

Sidebar

The left sidebar is the primary navigation hub for your workspace. Workspace settings and your personal settings share one navigation, reached from the account row at the bottom of the sidebar: choose Workspace settings (General, Members, Roles, Integrations, PII Detection, Guardrails, Governance, and — for admins and owners — Activities, Tracing, and Billing) or Personal settings (Appearance, Sign-in methods, Notifications). Opening either replaces the sidebar with a settings navigation and a back arrow that returns you to the workspace. See Invite and manage workspace members for roles, and Account settings for your personal preferences.

​

Workspace profile

The General settings page is where an owner or admin edits the workspace itself: its name, description, a logo, and an accent palette — saved together and shown everywhere the workspace is named, from the sidebar switcher to the mobile drawer. The palette is a full set of colors, not one swatch: it paints every time-of-day gradient throughout the workspace, not just the switcher badge. Leave a logo or palette unset and the badge falls back to the workspace’s initial on a default background, with gradients following the default time-of-day rotation, same as before.

​

Recent projects

Below the greeting and the Genie AI prompt box, the home page shows a few of your most recently edited projects, plus a card to start another one. It’s a preview, not the full list — click View all (or Projects in the sidebar) for the complete, searchable, filterable, paginated list of every project you have access to. If you have no projects yet, you’ll see an empty state instead, with a way to create your first one. Below that, two more read-only previews follow the same shape: your most recent Genie Agents, and a few of your workspace’s Knowledge documents — each with its own “Ask Genie AI” shortcut and a link to its full page. Neither peek can run an agent or manage a document itself; they’re for a quick look on your way to the page that owns that. Both an agent’s card and a document’s row carry a cover picture, generated automatically from its name and description so a list of agents or documents is no longer a wall of identical cards. It’s generated the moment you create one, or the first time you open an older one that predates the feature — nothing to trigger yourself. Star a project from its card (or ask Genie AI to do it) to keep it close: favorited projects get their own shelf above the Projects grid, lead this dashboard preview, and can be filtered for with the Favorites pill on the Projects page. A favorite is personal — teammates keep separate shelves — and the feature only switches on once a workspace holds three or more projects, since below that the grid already shows everything at once.

​

Activity log

If the activity log is enabled by an admin or owner, a recent-activity panel appears below the recent projects. It shows a live feed of workspace-wide events — new projects, member changes, setting updates — with relative timestamps. Click View all to open the full activity log page. If you’re the only member of the workspace, this area shows your plan and credit usage instead of an activity feed. The full activity log page adds an insights panel above the event list: a KPI row and a trend chart, both re-cut instantly by a metric dropdown (events, active members, or a specific category) and a time range (7, 30, or 90 days). Below that, a free-text search and a category filter search the whole log on the server — not just the rows currently on screen — so a search for a colleague’s name finds everything they’ve done, however far back it goes. A Security alerts panel sits alongside it, summarizing recent blocks from your PII rules and Guardrails side by side — visible to anyone who can already see that underlying log. From the same panel, anyone with that access can subscribe to get emailed the moment a new block happens; it’s off by default. You can also export the whole activity log as a CSV or PDF from View all.

​

Workspace AI

Every workspace includes a Genie AI that understands your workspace — your projects, your team, your credit usage, and your history. You can ask it questions and give it instructions in plain language, without switching to a project chat.

​

What you can ask

• “Which project is using the most credits this month?”
• “Send a follow-up prompt to my dashboard project: add a dark mode toggle”
• “Create a new project: a customer support ticketing tool with a Kanban board”
• “Invite my colleague as a member”
• “Show me the latest workspace activity”
• “How much does the Genie Pro plan cost?”
• “I’m seeing a blank screen after checkout — has this happened before?”
• “What database migrations has my dashboard project shipped?”
• “Does the checkout page look right on mobile?”
• “My app just threw an error — can you check what happened?”
• “Show me what the dashboard would look like with a warmer color palette”

The workspace AI can create and update projects, manage members, query credit usage, answer pricing questions, search past conversations, check whether a bug you describe has a known fix, look at your project’s screenshots or search its live console logs to see what’s actually happening, show you a design mock-up of a change before you build it, review a Genie Cloud project’s database migration history, and manage your MCP integrations — all through natural language. If you send that follow-up prompt from inside the project’s own chat, Genie starts the build automatically as soon as you confirm — you don’t need to press send again once you’ve reviewed the card.

​

Genie AI queues a busy project’s prompt

If you ask the workspace AI to update a project that’s already building, your prompt no longer just fails and asks you to try again — Genie lines it up in a queue and sends it automatically once the current build settles, spacing sends out by a short cooldown so a project isn’t hit with back-to-back builds. Before Genie sends anything, the confirmation card tells you plainly whether your prompt is starting a build right now or joining the queue — and, if it’s queuing, roughly when it will go out. Ask the workspace AI anytime to check, pause, reorder, or clear a project’s queue.

​

Is it still building?

Every place you talk to Genie AI — the in-project Genie AI tab, the standalone chat page, and the command palette — shows a small status badge for any project connected to that conversation, so you can tell at a glance whether it’s currently building, running an automatic fix, or has prompts waiting in its queue. Nothing shows once a project is idle.

​

Genie suggests what to build next

The moment a build finishes, the status just above your message box turns blue with an idea for what to build next. Tap it to see the suggestions as a checklist, tick the ones you want, and Apply puts a ready-to-send prompt in your message box — it doesn’t send it for you. Dismiss it and it folds away without being lost.

​

Genie AI can see and debug your project

Ask “does this look right?” or “why did my app just throw an error?” and the workspace AI can check for itself instead of guessing from your description. It can pull up your project’s live screenshots — the deployed app’s default view, or exactly what was on your own screen if you were the one looking at it — and it can search your live app’s own console output, errors, and crashes to check whether a bug you’re describing really happened, or whether a fix landed.

​

Genie AI answers with the actual code

Ask “how does checkout work in my app?” and Genie AI now reads the real code behind its answer instead of guessing from file and function names — so it describes what your code actually does, not just what its name suggests. For the files most relevant to your question it now reads the whole file rather than a short snippet, and you can also ask it to open a specific file directly — “show me App.tsx” or “what’s in the login page?”

​

Genie AI can search the web

When a question isn’t answered by Genie’s own knowledge or your workspace — a third-party API’s current behavior, a competitor, a price Genie can’t otherwise know — Genie AI now runs a live web search, or reads a specific page you point it to, instead of guessing or answering from what it already knew at training time.

​

Genie tells you when it notices something wrong

Genie watches your live preview for real problems — a crash, a thrown error, something logged as broken — and raises a calm alert right above the Genie AI composer: “Genie noticed something in your app,” together with a plain-language explanation instead of a raw error message. There’s one action, Fix with Genie AI, which hands the issue straight into your conversation so Genie can check the actual logs — and ask a question if it needs one — before proposing a fix, rather than guessing from the error text alone.

​

Genie AI can show you a design mock-up

Ask “what would this look like with a warmer palette?” or “make the dashboard feel more like Linear” and Genie AI can show you, before touching any code. It screenshots your real app, has an image model repaint it with the change you described — up to five pages at once — and shows you both pictures side by side. Genie AI is shown the same two pictures, so it describes what actually came back rather than just restating your request. React to what you see and Genie AI iterates — refine the same mock-up, or start over from your app’s real screenshot. Once you’re happy with a direction, ask Genie AI to build it and the approved picture joins the build alongside the change list, the same way an attachment you upload does — so the build starts from the mock-up you actually saw, not just a written description of it. When a draft covers more than one page, swipe between them — or use the arrows once you’ve opened one at full size — the same way you’d flip through photos. The tabs above the picture stay in sync with whichever page is on screen, and opening one at full size lets you page through the whole set, before-and-after included, without closing and reopening the viewer. Building something brand new? Describe the app you want and Genie AI drafts the key screens as a concept before your project even exists — no existing app or screenshot needed. Approve a direction and Genie AI carries it straight into the project it creates for you, shaping the very first build around what you picked.

​

Genie AI can theme your app with two colors

Ask for something like “yellow buttons and a navy navbar” and Genie AI applies both at once: your primary color drives buttons, links, and other action elements, while a second, darker color anchors navbars, headers, sidebars, and other dark surfaces. Before, only one color could be set at a time, so a two-color request would come out with half of it missing.

​

Genie AI can read and update your project’s design guidelines

Ask “what are this project’s brand colors and fonts?” and Genie AI reads branding.md — the style guide the build agent checks before writing any frontend code, covering colors, typography, component specs, and dos and don’ts. Tell it a lasting design decision — “our brand green is #0f9d58, headings are Poppins, never use pure black” — and Genie AI saves it, creating the guidelines document if the project doesn’t have one yet, so what you decide in chat is remembered by every future build instead of living in a single build brief.

​

Attachments carry into your build

Attach an image or PDF to your message when asking the workspace AI to create or update a project — a mockup, a reference photo — and the file itself goes into that build, not just a text description of it. Beyond images and PDFs, you can attach plain text, Markdown, CSV, JSON, Word documents, and spreadsheets too — Excel workbooks and Apple Numbers files both come through with their cell references and formulas intact, not just the calculated values — and an iPhone HEIC photo is converted automatically so its preview displays correctly. Before you send, click any attachment chip to check exactly what Genie will see: an image opens in a lightbox you can page through, an uploaded PDF opens in a new tab, and a document shows the exact text that will be sent, its length, and whether it was clipped.

​

Genie asks before it builds

For a clear, specific ask — “a one-page site that just says hello” — Genie starts building right away, at most with a single quick follow-up if one detail would change the result. For a broader or more ambitious idea, Genie first asks what it’s really for and where you want to take it, batched into one short card exchange rather than a back-and-forth interview. Your answers shape the very first build: the must-haves become the initial feature set, and anything mid- or long-term becomes a tracked goal for later instead of getting lost.

​

Genie checks before guessing

If what you ask could reasonably mean two different things — which project you mean, or whether “add” means a new section or replacing what’s there — Genie AI offers the readings as a quick pick instead of building the wrong one. And if you ask for the same thing again — worded differently, in the other language, or just “that still isn’t right” — Genie recognizes it as a repeat instead of sending an identical prompt a second time, and stops to check what happened last time before trying again.

​

Guided toward what Genie builds well

When you ask the workspace AI to create a project or shape a prompt, it steers you toward the kind of app Genie is proven to build reliably — a React/Tailwind frontend backed by Genie Cloud, with AI text, vision, and image generation already built in — rather than something likely to stall partway through. If what you asked for isn’t a good fit, Genie suggests the closest thing it can actually ship instead — for example, a request for real-time video effects becomes AI photo editing you can generate on demand.

​

Interactive answers

Genie doesn’t always reply with plain text. When it makes more sense to offer you a choice than to write a paragraph, it renders a clickable card right in the chat: a button to confirm a single action, a list to pick exactly one option from, or a checklist where you can tick as many choices as apply. Either kind of choice card always has a free-text field under the options too, so you can type your own answer if none of them are quite right instead of having to cancel. Tap a card to answer — if you send a new message instead without answering, the card is cleared automatically so it never lingers out of date. If a card needs an answer before Genie AI can continue — confirming an action, or reviewing a project it’s about to create — you can minimize it instead of answering right away or canceling it outright. Tap it again anytime to bring it back; nothing about the request is lost while it’s collapsed.

​

Open a Genie Tool or Agent beside the chat

On the full chat page, building or opening a Genie Tool or Genie Agent no longer just scrolls past in the transcript — its card docks to a canvas on the right, with the conversation keeping the left. If more than one is open, a button on each card’s header switches the canvas to show it instead; closing the canvas (or that button on the docked card) folds it back into the conversation. On a phone or a narrower window, cards stay inline in the transcript as before. A Genie Agent with no branching draws top to bottom on the canvas — start, each step, result, one per row — instead of the sideways grid the editor uses, so it reads cleanly in the canvas’s tall, narrow column. An agent with a branch, or one you’ve hand-arranged in the editor, keeps the grid.

​

Always replies in your language

Genie AI answers in whatever language you write to it in — regardless of your account’s interface language — and keeps writing in that language for the rest of the conversation, including any cards it shows you and the project briefs it authors on your behalf. If you switch languages mid-conversation, Genie follows along from your very next message.

​

Genie remembers your preferences

As you chat with the workspace AI, Genie remembers things you share about yourself — your industry, your team setup, the kinds of apps you build — and uses that context in future conversations automatically. You don’t need to repeat background information in every chat. You can also ask it directly — try “what do you remember about me?” — and Genie searches everything it’s picked up, not just the most recent items. If something’s outdated or you’d rather it didn’t know, just ask Genie to forget it.

​

Genie remembers your project

Beyond what it knows about you, Genie AI also keeps notes that belong to the project itself, shared with everyone who has access to it — a standing requirement you’ve stated (“every screen must work on mobile”) or a confirmed detail about a third-party service you’re integrating (“the webhook payload nests under data.object”). Once you’ve told Genie something like that, you don’t need to repeat it in the next conversation, and it’s there for your teammates too. Ask “what do you remember about this project?” to see what’s recorded. If a requirement changes, just restate it — Genie updates the existing note in place instead of piling up a contradicting one. Genie never stores credentials or secrets this way, only confirmed details and standing instructions.

​

Knowledge base

Beyond what Genie AI remembers from conversation, your team can file the material Genie should build with — brand guidelines, tone of voice, an API schema, a data dictionary — as knowledge documents, at two scopes:

• Workspace — applies to every project.
• Project — applies to just the one project it’s filed under.

Open Knowledge in the workspace sidebar to browse and manage documents at both scopes, or open a project’s Settings → Knowledge tab to manage just that project’s — either surface can also see and file the other kind, and moving a document between scopes keeps its content and search index intact. Workspace owners and admins can file a document into any project in the workspace, not only ones they’re a member of. The browser is shaped like a familiar file manager: folders and unfiled documents sit at the root, opening a folder shows what’s inside it, and a breadcrumb walks you back up — nothing is ever listed in two places at once. Search drops the folder view entirely and searches everything at once, so finding a document never depends on remembering where it was filed. Switch between a list or grid layout (remembered for next time), sort any column, and drag a document straight onto a folder to file it — or onto the Knowledge breadcrumb to take it back out — instead of opening the move dialog. Upload plain text, Markdown, CSV, JSON, YAML, XML, HTML, source files, Word (.docx), Excel (.xlsx), or PDF files — up to 10 MB each. A scanned PDF with no text layer is read automatically with OCR instead of being rejected. Images still aren’t accepted directly in the uploader, since their content can’t be extracted in the browser; send one to Genie AI in chat instead and ask it to file it for you. You can also upload a whole folder at once — Genie recreates its structure as knowledge folders, skipping anything it can’t read rather than failing the whole upload. Each document shows its own search-index status — indexed, keyword-only if the semantic index failed to build, or not yet indexed — with a Retry indexing action right there when it needs one. Before building or updating a project, Genie AI automatically checks the knowledge base that applies to it — the workspace-wide documents plus anything filed just for that project — and carries what it finds into the build. When it does, its answer marks exactly which passage each statement came from with a small citation — click one to open the source document at that passage, or open the Sources list under the answer to see (and download) every document it drew on. Genie AI can also find a document by its filename or description alone, not only by what’s written inside it — useful for a document whose content is mostly figures or a scan, like a spreadsheet of numbers or a signed contract. Ask it to show or open one directly and it renders as a card right in the chat, with actions to view or download it, instead of just naming it in the reply. Each document also carries a date it is about, shown beside it wherever it’s listed or cited, separate from the day it was uploaded. Genie works this out automatically — a full date in the file name or title, or else a connected drive’s last-modified time — and falls back to the upload day when it can’t find one. Correct it yourself from the document’s Rename or move dialog, or ask Genie AI to read the document and set it for you; your correction sticks through every later sync or edit, until you switch it back to automatic. The same is available through the Genie MCP Server and the workspace API. Within either scope, documents can also be sorted into folders, which can now hold sub-folders of their own — a filing layer for finding things, separate from scope, which decides what Genie AI can use. A “Brand” folder can hold both a workspace-wide document and one project’s own copy deck, and filing something into or out of a folder never changes what Genie finds when it searches. Create, rename, or delete folders from the chip rail above the document list, or drag one into another to nest it; each holds up to 200 documents directly, and deleting a folder never deletes what’s in it or below it — those documents just become unfiled. Ask Genie AI to update a document and it can rewrite its full text in place, not just retitle or re-describe it — the new text is re-indexed immediately, so search and the next build see it right away. The same is available through the Genie MCP Server and the workspace API. A document mirrored in from a connected cloud drive can’t be rewritten this way, since the next sync would overwrite the edit — change it at the source instead.

​

Cloud drives

A Cloud drives panel at the bottom of the Knowledge page shows where each member stands with Google Drive or Microsoft 365 (OneDrive and SharePoint) — not connected yet, or connected and ready to browse. Once you’ve connected your own account (see Available preset integrations), it appears as its own place inside the Knowledge browser: search across the whole drive — your OneDrive, or every SharePoint site you follow, for Microsoft 365 — open folders, and click Import into knowledge on any file Genie can read to file a copy as a knowledge document, citable like any other. Beyond importing files one at a time, you can also keep a whole folder in sync — a Drive folder, or a OneDrive/SharePoint library or a folder inside one: pick it (or just the sub-folders you want) once from the Synced folders list, and Genie mirrors it into your knowledge base automatically from then on — new and changed files are brought in and anything removed from the source is removed here too, on a Sync now whenever you want it, and on its own every few hours in between.

​

Talk instead of type

Don’t want to type your prompt? Tap the microphone icon in any Genie chat composer, or next to the Get started button on the workspace dashboard, to dictate instead. Your words appear in the composer as you speak, rather than arriving all at once when you stop, and dictation recognizes Genie- and product-specific terms — like “Genie Cloud” or “MCP” — instead of mishearing them. The microphone stays available even after you’ve started typing, and even while a response is still streaming in or an earlier conversation is still loading, so you can dictate a correction or an addition onto a draft without clearing the box first; tap it again to stop recording, or it stops on its own after five minutes. Genie transcribes what you said so you can review or edit it before sending — nothing is submitted automatically. Voice input is available in the workspace chat, a project’s chat panel, the workspace dashboard, a Genie Tool’s own form fields, and the command palette’s Ask Genie, on any browser that supports microphone recording.

​

Workspace chats are private by default

A conversation with the workspace AI is visible only to the person who started it — nobody else in the workspace, including admins, can open or write to it by default. Share it from the chat’s settings menu to bring others in, either with Everyone in the workspace or with Only selected people, picked from a member search. In a shared chat, every message shows who sent it — name and avatar next to their turns — so a multi-author conversation stays readable. Browsing your Recent chats still only shows your own conversations by default, whether or not you’ve shared any of them, so this doesn’t flood your list with everyone else’s threads. If you ever need help from Genie support with a conversation, they can access it to assist you, even if it hasn’t been shared. Drag any chat from the sidebar onto the Pinned dropzone at the top of the list to pin it — drop a pinned chat there again to unpin it — or use Pin chat from the same settings menu. Pinned chats lead the list under their own heading, ahead of the usual date groups, everywhere your chats are listed.

​

The command palette

Press ⌘K (Mac) or Ctrl+K (Windows) from anywhere in Genie to open the command palette — a fast way to jump to a project, run an action, or start asking Genie a question without leaving the page you’re on. Choosing Ask Genie switches the palette into a chat window in place. If you close the palette mid-conversation, nothing is lost — the conversation is saved and reappears under Recent chats at the bottom of the list. Reopening the palette shortly after chatting picks the conversation back up automatically, so you can dismiss it without losing your place.

​

Related pages