Using Space Brain
Codebases
Connect a software repository so agents can explore it and answer questions about how it works.
A codebase is a software project the copilot can read and reason about. Connect one and you can ask things like “Where do we calculate shipping costs?” or “What would break if we change this function?”, in plain language.
Connecting one
Open Brain › Codebases and choose how to bring it in:
| Source | Use it for |
|---|---|
| Repository link | A public repository on GitHub, GitLab or Bitbucket. Paste its address, and optionally a branch, tag or version. |
| Archive upload | A private repository. Upload a .zip or .tar.gz (up to 200 MB by default). |
| A folder from your Library | Code you've already uploaded as a folder. |
You can also ask the copilot to connect one, and confirm when it asks.
What happens next
The codebase shows pending, then processing, then ready. Space reads every file, recognizes the language, and builds a map of the code: files, the functions and classes inside them, and how they import, call and extend each other. Large dependency and build folders are skipped.
If something goes wrong, the status says failed and gives the reason.
Exploring it yourself
Open a ready codebase to see:
| Tab | What you see |
|---|---|
| Overview | Size, languages, main folders, likely entry points, most-used files and external dependencies. |
| Files | A folder tree, source with line numbers, an outline, and what each file imports and what imports it. |
| Symbols | Search for functions and classes, and see who calls them and what they call, as a diagram. |
| Import map | Files grouped in lanes by top folder, with links between them. |
Asking the copilot
Try asking
Give me an overview of the payments codebase.
Who calls the function that applies discounts?
Explain how login works, step by step.
Reading a codebase needs no approval, so agents and automations can use it too. Add a codebase to an agent's Resources to give that agent access.
Keeping it fresh
Use Sync to read the repository again: a repository is downloaded fresh, and a Library folder is re-zipped. Codebases aren't updated automatically.
Sharing
A codebase is personal, group or organization scope, and can be shared like other resources. Only its name and description can be edited after it's connected.