Repository Workspace
The repository workspace at /repositories/:repositoryId is where users resume work after a repository is created. It brings together the repository header, breadcrumb, status, lifecycle tabs, recent activity, pre-analysis, tasks, documentation, and graph.
When to use
- Use the workspace to understand the current state of a repository.
- Use it to move between source code, tasks, documentation, and graph.
- Use the overview when you are unsure what the next step should be.
- Use locked tabs as guidance for what still needs to be completed.
Before you start
- Confirm the active organization.
- Open the correct repository from
/repositories. - Check whether source code and pre-analysis are already available.
Workspace tabs
| Tab | What it is for |
|---|---|
| Overview | Summarizes the repository status and recommended next step. |
| Source Code | Uploads or reviews the source code package. |
| Tasks | Lists, creates, and manages documentation or backlog tasks. |
| Documentation | Opens generated Markdown documentation. |
| Graph | Explores relationships found in the analyzed code. |
| Some tabs can remain locked until source code or pre-analysis exists. |
Usage measurement is not shown as a repository workspace tab. When enabled, it is available from the administration area and lets users choose the repository inside the usage screen.
Repository overview
Open /repositories/:repositoryId/overview to review:
- General repository information.
- Active organization.
- Creation and update dates.
- Storage type.
- Current status.
- Repository journey.
- Recommended next action.
- Recent tasks.
- Pre-analysis data when available.
- LLM cost estimates and model recommendations when returned by the API.
- Usage measurement summary when enabled.
- Error messages when a failure exists.
The overview is the best screen for resuming work because it consolidates the current state and points to the recommended next action.
Repository status sequence
| Status | What it means | Next step |
|---|---|---|
CREATED | Repository was created. | Upload source code. |
UPLOADED | Source code was uploaded. | Wait for processing or review pre-analysis. |
PROCESSING | Source code is being processed. | Wait for completion. |
PRE_ANALYZED | Pre-analysis is available, but not confirmed yet. | Go to Source Code, review the pre-analysis in the indexer, and confirm it. |
READY | Repository is ready for new work. | Create tasks, read documentation, or explore the graph. |
ERROR | Creation, validation, or processing failed. | Review the source code step or retry with a corrected package. |
FAIL | A later repository step failed. | Review the status, upload a corrected package, or retry the affected flow. |
Expected result
The workspace should make the repository status clear, show which areas are available, and guide the user to the next action without requiring manual route discovery.