What is the Codus Brain, and what can it do?
The Codus Brain is an AI agent that works across the projects open in Codus. Open it with the Brain icon in the title bar; in Codus 0.2.204 or later it opens on the left edge of the window, and from 0.2.207 you can move it to the right with Brain side in Settings → Appearance. You can ask it to find a project, inspect progress, organise work or pass a task to a project's agent.
Before you start
Install and sign in to a supported coding agent. Brain is not Claude-only: choose an available provider from the selector at the bottom of its drawer. Your provider account and any provider charges are separate from your Codus account.
Use the Brain
- Click the Brain icon, then choose a Brain tab. If you have several, the menu button (three lines) at the right end of the tabs lists them all.
- In session, choose Chat for a message-style conversation or Agent for the provider's terminal.
- Ask a question or describe the outcome you want. Name the project when the work belongs to a particular one.
- Open tasks, done or notes to organise that Brain's own records. See Brain Tasks, Done and Notes.
- Use the artifacts button in the bottom bar for its saved files, or the globe at the right end of the session row for its Live View browser.
A project agent works in its assigned folder. Brain provides cross-project coordination; choosing another Codus view does not create a new Brain conversation. Each Brain tab has its own session and workspace.
Closing the drawer hides it; it does not stop the running session. Fully quitting Codus stops local processes. See closing versus quitting.
If it cannot start
A not installed label means that provider's program was not found. Sign in on launch means it needs provider authentication. In Codus 0.2.204 or later, choosing Claude or Codex when it is not signed in opens a Log in to Claude to continue (or Log in to Codex to continue) window where you sign in without leaving Codus; see changing provider. Otherwise choose another installed provider or follow the Brain installation help. Neither message means you must buy a second Codus seat.
How do I know it worked?
The selected Brain accepts a message and replies in its session. Its tasks, done and notes show that Brain's name, so you can check you are working in the right place.