Help

What does CODEBRICK do?

You give it a project: a name, a site address and a sentence about the work. It researches the site from public records (parcel, zoning, flood zone, seismic values, climate zone and the code cycle that applies), fills in the Project Profile, and keeps the applicable codes beside it. BRICKBOT answers code questions against that profile, and with BRICKBOT for Revit, a Revit plugin, it can start the Revit project from the same facts.

Every project belongs to a workspace (your office). Members of the workspace see its projects.

Is my city covered?

City-level research (zoning, general plan, overlays, specific plans, historic resources and, where the city publishes them, permits) covers these cities in Los Angeles County: Los Angeles, Santa Monica, Pasadena, Culver City, West Hollywood, Long Beach, Beverly Hills, Glendale, Burbank, Santa Clarita, Lancaster, Palmdale, Inglewood, and unincorporated Los Angeles County. See which Los Angeles County cities are covered, and look up an address to see its jurisdiction and coverage. No account is needed.

Elsewhere, the facts from state and national sources (flood zone, seismic values, climate zone and the code cycle) are still researched, and the parcel where we read that county’s records. The city fields read “Not yet supported”, with a link to the city’s own zoning map where we know one, so you can fill them in.

What does site research check, and does it cost credits?

Research reads public records for the site address: the parcel and its assessor record, the jurisdiction, zoning, general plan, overlays and specific plans, historic resources and permits where the city publishes them, the flood zone, seismic values, the climate zone and the code cycle that applies. Each value names its source; a value the records do not give says “Needs you”.

It spends no credits: research reads records and uses no AI. Run it again any time from Research on the project Overview.

What is BRICKBOT?

BRICKBOT is the assistant inside CODEBRICK. Open it with Ask BRICKBOT on the project page, or from the project’s Chats tab. It reads the project brief (site facts, structures, applicable codes, the Revit connection) and answers in plain language: code requirements with the section cited, what a field means, what to do next.

BRICKBOT never writes to your project on its own. When it suggests a change it shows a card, and nothing is saved until you click Apply. When Revit is connected it can also read the model and, after you confirm, run commands in it.

How do I keep an answer, or show it to my team?

Under every answer, three buttons each do one thing:

• Bookmark keeps it for you only. Find it again under Chats › Saved.
• Add to project Library puts a read-only copy of the chat, up to that answer, in the project’s Library, where everyone on the project can read and comment on it.
• Share in Team chat posts the question and the answer in the project’s team chat. It shows only where your workspace has team chat.

Your BRICKBOT chats stay private either way: the team sees only what you add or share. Under ⋯, Save as project fact keeps one sentence on the project’s Overview, and BRICKBOT uses it in later answers.

Can BRICKBOT’s answers be trusted?

Treat them as a strong first draft, not a stamped answer. Every code answer states the jurisdiction and code edition it assumes and cites a section where it knows one. It is told never to invent section numbers and to say when a local amendment could change the answer. When a question depends on something current or local, such as the forms a city uses now, it can search official sources only (government sites, code publishers and municipal code libraries) and lists the pages it cited under the answer.

Under every answer a small chip shows the code cycle and jurisdiction it used, for example 2025 CBC · City of Los Angeles · provisional. The cycle is the one selected on the project’s Applicable Codes card; it reads provisional until a permit application date is entered. When the selected cycle differs from the one research recommends for the location and permit date, the card marks it to resolve and BRICKBOT says so in its answer. Where a city or county amends the state code, BRICKBOT checks the local amendments and says “as amended by” that jurisdiction when one applies.

Code answers that cite a section are saved to a shared library and reused when the same topic comes up for the same jurisdiction and edition. Within your workspace any saved answer may be reused; across workspaces only answers a platform reviewer has verified are offered.

BRICKBOT can make mistakes. Review its work and verify code requirements with the authority having jurisdiction before relying on them.

What are credits and how are they used?

Credits are how your workspace pays for BRICKBOT. Each answer costs a small number of credits, scaled to the amount of work in that request, so a short question costs less than one that reads the project and the Revit model. The chip in the header shows how many credits the workspace has left; it links to Billing, where usage by day, by person and by project is listed for the last 30 days. Each answer shows what it cost under it.

For a hard question, tick Deeper Thinking Model (uses more credits) under the message box. That question is answered by a more capable model and costs more; the next one is back to normal. A workspace admin can turn the option off for everyone in Settings › Office › Office details.

AI features such as BRICKBOT answers and Revit add-in actions spend credits; commands that do not use AI and site research are free. The Project Profile and the standards pages are free too.

At zero credits BRICKBOT pauses and the chip turns pink. Nothing else changes: your projects, files and Revit connection stay as they are.

How do I get more credits?

Invited testers get 1,000 starter credits: a new workspace that signed up with a valid invite code receives them on its first visit after the email is confirmed. An invite code added later on the Billing page unlocks them too. They are given once per person, however many accounts they open. When the credits run out, BRICKBOT stops until more are added. A workspace admin can subscribe to a plan on Billing (credits arrive with each invoice and renew every cycle) or buy a top-up pack, which never expires. If you were given an invite code, enter it under “Have an invite code?” on the same page, or in the Invite code box when you sign up.

Plan credits stay available while the subscription is active; if it is cancelled they expire at the end of the paid period. New starter credits have no expiry during the beta. Earlier starter credits and invite code credits expire 90 days after they are granted.

What is BRICKBOT for Revit, and do I need Revit?

BRICKBOT works in the browser; the Revit plugin, BRICKBOT for Revit, lets it build the Revit model. It is CODEBRICK’s add-in for Revit on Windows. Once installed and signed in, it adds a BRICKBOT tab to the Revit ribbon: Connect to CODEBRICK, the project set-up command (the same six steps as Set up project on the website), Update from CODEBRICK, Setup Views & Sheets, Status. It pulls the project facts and your office standards down from the website and builds the Revit project from them.

You do not need Revit to use CODEBRICK. Research, the Project Profile, applicable codes and BRICKBOT Chat all work in the browser alone. Revit is only needed for the Revit side. BRICKBOT for Revit runs on Revit 2027 only; earlier versions are not supported yet. The download and the install steps are on BRICKBOT for Revit in the left menu. The same page shows the computers you are signed in on and your linked models. Revit commands are given inside Revit, in the BRICKBOT panel. Questions about the code go to BRICKBOT Chat.

Where do I give Revit commands?

In Revit. Once BRICKBOT for Revit is installed, click the BRICKBOT button in Revit’s ribbon to open the panel. You give Revit commands there.

• Fix in Revit is on each project’s Corrections tab: BRICKBOT drafts a fix for a correction item, and Run in Revit sends it to the add-in.
• A Revit command card in BRICKBOT Chat sends its command to the add-in when you click Run in Revit. While a command or a fix waits or runs, Cancel beside it stops it: one that is still waiting never starts; one that is already running may still finish in Revit.
• Admins see what BRICKBOT did in Revit in Settings › Office admin › Revit activity log.

Can I track corrections that are not from a plan checker?

Yes. A project’s Corrections tab takes corrections from any source: a plan-check letter, a code enforcement notice (a Notice of Violation, a Notice and Order or an inspection report), an inspector’s report, or a list from the owner or client.

• Click Add corrections, choose the PDF, and check Where are they from. CODEBRICK reads the first pages of the letter and pre-selects the source it detects, marked “Detected from the letter; change if wrong”. Pick another if it is wrong, and change it later from Edit in the round’s header.
• BRICKBOT splits the letter or notice into items, and every item is tracked the same way: a status, an assignee, a response and, when your model is open, Fix in Revit.
• The source shows on the round, on each item, in the exported PDF and in the project Library. When a project has rounds from more than one source, a Source filter appears at the start of the round tabs.

Why does Windows warn me when I install BRICKBOT for Revit?

The installer is not yet signed with a purchased code-signing certificate, so Windows SmartScreen does not recognise its publisher and shows a blue “Windows protected your PC” box. Click “More info”, then “Run anyway”. Revit then asks whether to load the unsigned add-in: choose Always Load. Once per computer is enough, including after updates; Revit only asks again if someone clicks Load Once, or on a new computer.

The download itself is served only to signed-in users from CODEBRICK’s private storage. A signed build is planned; when it ships both prompts stop. The step-by-step screens are on BRICKBOT for Revit.

What is a device code?

It is how Revit signs in to your CODEBRICK account without you pasting a password or a key into Revit, the way a TV app signs in. On the BRICKBOT tab click Connect to CODEBRICK, then Sign in. Revit shows an 8-character code such as XKQ4-7MRB. Enter that code on codebrick.ai/connect-revit while signed in as yourself; Revit picks up the approval within a few seconds.

A code is valid for ten minutes, so if it expires just ask Revit for a new one. The connected computer appears under Settings › Profile › My Revit sign-ins, where you or an admin can sign it out. A sign-in that goes unused for 30 days ends by itself, and every sign-in ends after 180 days; then sign in from Revit again.

Why can’t I click “Set up project”?

The button on the project’s Revit tab works only when all of these are true:

• Site research has finished at least once. Until then the strip says to research the site first.
• BRICKBOT is installed, signed in and Revit is open. The strip must read “Revit connected”.
• The open Revit document is the one bound to this project. The strip tells you when it is a different document, when the file was opened from a new location, or when no document has been linked yet (in Revit, click Connect to CODEBRICK on the BRICKBOT tab, then Link to project).

Before BRICKBOT for Revit is signed in on your computer the Revit tab says to install it first, with a link to BRICKBOT for Revit. After that, until Revit is connected, it lists the setup steps (install, sign in, link the document, set up) and ticks the ones already done; otherwise the reason is written beside the button. After the first successful set-up the button goes away for good; later changes go through BRICKBOT’s Revit tools in the chat or the BRICKBOT tab in Revit. If a run stops part way, “Resume from failed step” picks it up where it stopped.

My project says “Researched” but some fields say “Needs you”. Why?

“Researched” means the public-records search ran and its results were saved. “Needs you” on a field means no public record can answer it, so it waits for you. Some fields are always yours, such as the owner, the project number and the cover sheet team block. Others fall back to “Needs you” when a source could not find the site, for example when no parcel sits under the address.

Click the field to type the value. Fields filled by research show where the value came from and how confident the source is; a field where your value and the research disagree is marked as a conflict so you can decide. “Not available” means the source was checked and has no record for this site.

What is a standards set?

Your office standards are the rules BRICKBOT follows in Revit: annotation (text and dimension types, tags), graphics (line weights, leaders, level heads), sheet sets (sheet sizes, title blocks, the sheet list per project type) and the cover sheet. A standards set is one named collection of those rules. Duplicate on the Office standards page copies a set, so you can start another from it.

Every workspace has an Office default set. Admins can add more, such as “Residential” or “Hospitality”; each one inherits from Office default and stores only what it changes, and may carry its own Revit template. Each project picks one set and pins a published version, so the rules your office changed stay exactly as published until you choose to update. When a newer version is published, the project’s settings page offers an Update link; your rules do not change until you click it.

Rules your office never changed follow CODEBRICK’s current defaults, so a fix to a default (a new scale or sheet size, for example) reaches every project without republishing. BRICKBOT applies it on its next placement or update and never changes work already in the model. Editing a rule or accepting a suggestion makes that whole rule your office’s own, even when the suggestion changed only one setting inside it, so later CODEBRICK changes to that rule no longer reach it. Resetting the rule hands it back to what it inherits.

What happens to the files I upload?

Reference files uploaded on a standards set’s Style guide tab are stored in your workspace’s private storage and used to propose standards rules for that set. Each upload has a “Do not use for training” box next to Choose file. It is ticked by default, so a file is not used to improve the service unless you untick it. An unticked file can also be shared, de-identified, with partners if a workspace admin has turned on “Allow sharing de-identified data with partners”. A file not used for training shows a chip saying so, and an admin can change the setting later from the file’s menu.

Project files have the same switch in the project Library’s All files view. Chat content and project data are used to improve the service only if a workspace admin turns on “Help improve CODEBRICK” in Settings › General (off by default; everyone in the workspace can see whether it is on), and files marked “Do not use for training” are always left out. See the Privacy Policy.

Can I attach images and PDFs to a chat?

Yes, in a project chat. Paste a screenshot, drag files onto the message box, or use the paperclip button: up to 10 JPG, PNG, WebP, GIF or HEIC images and PDFs per message. Images are made smaller (1,600 pixels on the long side), photo details such as location are removed, and a GIF keeps its first frame. The line under the thumbnails shows about how many credits the images add to the message.

Images stay private to your chat until you choose Save to project Files, which copies one to the project’s Files for the team. PDFs are added to the project’s Files straight away and read the same way as an upload there; a PDF over 10 pages shows its reading cost first. Everything counts toward the project’s 50 MB.

Where is my data stored, and who can see it?

Projects, files and chats are stored with our database and storage provider, encrypted in transit and at rest. Access to every record is restricted by workspace and role at the database level: members of your workspace can see its projects; nobody outside it can. Secrets stay on the server.

A BRICKBOT request sends the project context, relevant files and your messages to an AI model provider to produce the answer. The code answer library is scrubbed of the project name, number, address, parcel number, owner and legal description before anything is saved to it. We do not sell personal information. The full list of providers is in the Privacy Policy.

Is my data shared with partners?

No. Today no data is shared with any partner. A workspace admin can turn on “Allow sharing de-identified data with partners” in Settings (off by default, separate from “Help improve CODEBRICK”), which allows us to share de-identified data from that workspace. Files marked “Do not use for training”, chats that used them, confidential projects and your code books are always left out. Turning it off stops future sharing, but data already shared cannot be recalled. See the Privacy Policy.

How do I invite someone, and how do I switch workspaces?

Admins invite people on Settings › Office › Members: click Invite at the top, type the email, pick a role and, if you like, the projects they join, and click Send invite. The person gets an email with a link that works for 7 days. They sign in or create an account there with that address and click Join workspace; nobody is added until they do. Pending invites are listed on the same page with Resend (a new link and 7 more days) and Revoke (the link stops working).

If you belong to more than one workspace, click the workspace name at the top of the sidebar and pick another. Projects, chats, office standards and credits then show that workspace. To leave a workspace you were invited to, use Leave workspace in Settings › General › Danger zone.

How do I delete my account?

In Settings › General › Danger zone, the last card is “Delete account”. Click the button, type DELETE to confirm, and you are signed out and the account is deleted. A workspace where you are the only member is deleted too, including its projects and files; it cannot be undone. To keep a copy of your data first, use Export all my data on Settings › Profile › Privacy and my data; for anything it leaves out, email legal@codebrick.ai from the address on the account. Deleting a file or project in the app removes it from the service straight away; copies in routine backups age out on their own schedule. Billing records and security logs are kept as long as the law requires.

I cannot sign in. What should I check?

Use Forgot password to get a reset link by email; the message looks the same whether or not the address is registered, so check the spelling of the email first. “Remember me” on the sign-in form keeps only your email address in the browser, not your session, so you still sign in each time it expires.

Still stuck? Write to helpme@codebrick.ai. We reply within 1 business day.

Known issues in the beta

Problems we know about and have not fixed yet, with what to do meanwhile:

• The BRICKBOT for Revit installer is not signed yet, so Windows and Revit each warn once when you install it (see the Windows answer above).
• If the sign-in service itself is down, you are sent to the sign-in page as if your session had expired. Wait a minute and sign in again.
• On a renovation, the area entered when you create the project is saved as the total building area, not the altered area. Check the areas on the Project Profile.
• Research can suggest the wrong occupancy from the assessor’s use code, for example M for a mixed store use. Check the suggested occupancy.
• The vicinity map needs a public street map service. A new project opens first and draws its map a minute later; when that service is down the map card says so; click Retry later.
• The Applicable Codes card offers only codes whose code data is loaded: the Fire Code, the Existing Building Code, the Historical Building Code and the Referenced Standards Code are not offered yet.
• An image attached to a chat is seen only with the message it was sent with, and the Library’s All files view does not take image uploads yet. Attach the image in a chat, then use Save to project Files.
• In Revit, a new project made from the default template has title blocks without the sheet number, sheet name or project name, and Update cover sheet can place empty values in a note outside the sheet frame.

How do I send feedback?

CODEBRICK is in beta, and we want to hear what goes wrong and what would help. Click Feedback near the bottom of the sidebar on any page, write a few lines, pick Bug, Idea or Question if you like, and click Send. The page you were on is sent with your message, so you do not need to describe where you were.