How to Use biral

Get started in minutes. Connect a repo, ask questions, and understand your codebase.

1
Create an account

Sign up with your email or use Google sign-in. Once logged in, you'll land on the Repositories page.

2
Connect a repository

Click Add Repository and enter a GitHub URL or local path. biral currently supports JavaScript, TypeScript, and Python, with more languages coming soon.

  • For public GitHub repos, just paste the URL and click Connect & Index Repository
  • For private GitHub repos, connect your GitHub account first — you'll see a GitHub Connected status once linked
Connect a repository form
GitHub connected state
Indexing typically takes a few minutes depending on the repository size. You'll see a spinner while it's in progress.
3
Ask questions about your code

Once indexing is complete, select the repository to open the chat interface. Type any question about your codebase in the input box at the bottom.

  • How does the refund process work?
  • What happens when a user cancels?
  • How does messaging work?

biral searches the indexed code and responds with an explanation grounded in the actual business logic, with references to the relevant source files.

Chat interface with a repository
Use the suggested prompts at the top of the chat to get started quickly.
4
Manage your repositories

From the Repositories page, click the ••• menu on any repo card to:

  • Share — Grant access to other users by username
  • Move to company — Assign the repo to a company for team-wide access
  • Delete — Remove the repository and its index

Use Change Repository in the chat view to switch between repos without leaving the page.

Repository actions menu
Share repository modal
Move to company modal
5
Set up a company (optional)

Go to the Companies page to create a company. Give it a name and an optional URL-safe slug.

  • Add team members to the company
  • Move repositories into the company so all members get access automatically
  • Company admins can manage members, repos, and settings
Create a company
Companies are great for teams — instead of sharing each repo individually, move it to the company and everyone on the team can use it.
6
Try demo repositories

Not ready to connect your own repo? Try one of the demo repositories available on the Repositories page — like Cal.com, Chatwoot, or Saleor E-commerce — to see biral in action.

Ready to get started?

Go to Repositories