Start guide

Sign in with GitHub and select a repository.

Install the Codebase.run GitHub App and choose a project in the dashboard. Organization repositories may need administrator approval.

The agent detects your toolchain and prepares the environment automatically. The better your tests cover the application, the more thoroughly it can verify changes.

For large projects, optimization can take up to 5 hours. The optimizer runs the entire project stack, including the application, supporting services and tests, to prepare and verify the environment.

One change, a clear expected result.

In New task, choose an open GitHub issue and submit it. Describe what should change, the acceptance criteria and any relevant constraints. You can queue a task while the environment is being prepared.

For example: “Show an empty state when the project list has no entries, with a link to connect a repository. Use existing UI components and check the mobile layout.”

Track progress in Tasks and preparation in Projects.

Open the resulting PR on GitHub, read the diff and check which tests ran. You decide whether to merge. If work is waiting or fails, read the status before submitting another task.