Repository details

Manage settings shared by every registered checkout of a repository.

The repository details page at /dashboard/codebases/repositories/{id} manages settings that belong to the logical repository rather than to any one checkout. Everything here applies across every agent checkout and every worktree that shares the origin.

The page has six tabs.

Repository details

Setting	Notes
Repository name	The shared name used everywhere this repository appears
Repository description	Optional context
Jira branch regex override	Extracts a ticket key from a branch name for this repository. Leave empty to inherit the default from Codebases settings. The first capture group is used when present, otherwise the whole match.
Keep base branch up to date	After a successful fetch, fast-forward the base branch when there are no staged changes. Applies on every agent.
Skill groups	The project skill groups synchronized into every checkout and worktree of this repository.

Skill groups are how a repository gets a consistent set of agent skills on every machine. Define them under Skills, then assign them here once instead of per checkout.

Preparations

Upload files to write or override, list exact paths to delete, and select tracked paths that should always be assume-unchanged. Saving updates the repository definition without modifying existing worktrees.

See Repository preparations for path rules, upload limits, Git behavior, and force-aware Sync and Rebase handling.

External pipeline actions

Enable repository JavaScript scripts for retrying and canceling external GitLab CI work. Add write-only named secrets using the configured credential backend. All checkouts share the scripts and secret names.

In iOS, open Edit Repository → External pipeline actions. See External pipeline actions for the context contract, runtime limits, and provider recipes.

iOS App

Enables reusable Xcode build configurations for every checkout and worktree of this repository.

1. Add the iOS App project

   Add iOS App project registers the repository as having an Xcode project. This alone enables Start Build, including Custom builds before any saved configuration exists.

2. Create build configurations

   A configuration selects a repository-relative Xcode source and saves its scheme, configuration, action, and optional advanced settings. Configurations are repository-wide and available from every worktree. Collect dSYMs under advanced settings keeps a build’s dSYMs for crash symbolication: automatically for archives, always, or never.

3. Allow build scripts

   Reusable pre-build and post-build hooks are authored on the Builds page. Allow specific scripts here or select this repository directly in the script editor. Script icons appear alongside their names.

Project definitions and allowed scripts are shared by the repository, but source discovery, validation, and parse status are computed from the agent checkout you have selected. A configuration can be valid on one Mac and unavailable on another if the checkout differs.

A green Valid badge identifies successfully validated configuration settings. Remove iOS App project asks for confirmation, then removes the project, its configurations, sources, and observations together. Repository files, build history, artifacts, and script assignments remain. Any active build in this repository, including a Custom build, prevents removal until it finishes.

In the native app, open Edit Repository → iOS App project to manage the project and configurations using native controls.

Auto Retry

Durable rules that automatically rerun GitHub Actions workflows or jobs.

Setting	Options
Applies to	Current runs, future runs, or both
Pipelines and jobs	Specific workflows and jobs, or all workflows including ones added later
Retry mode	Retry failures, or retry successful runs by count
When a failure occurs	Retry failed jobs only, or retry all jobs
Retry limit	1 to 100, or unlimited

Saved rules show their progress as automatic retries across runs, and can be paused, resumed, edited, or deleted. Rule statuses are Active, Paused, Completed, Exhausted, and Error.

Auto Retry is available only for repositories hosted on GitHub, and requires a personal access token plus a verified GitHub App with Actions write access. See Credentials.

Quick actions

The workflows this repository inherits as quick actions, each showing its action type — Standard, Merge conflict, or GitHub Actions — and its scope, either All repositories or limited to a specific count.

Configured workflows stay listed while paused, marked Paused. The action itself only appears when the workflow is published, enabled, and matched to the current resource.

This tab is a read-out of what applies here. To change a workflow’s action type or repository scope, open the workflow on its own details page.

Why these settings are repository-wide

A repository is usually checked out on more than one Mac, and each checkout can carry several worktrees. Putting preparations, build configurations, skill groups, and retry rules on the repository means every checkout uses one definition instead of maintaining per-machine copies.

Import and export settings

Use Import or Export in repository details to open the shared configuration review. Save pending repository details and preparation edits first; transfers use the saved definition.

Export can include the repository name, description, Jira regex, base-branch update setting, preparations, iOS build configurations, repository commands, and workflows. Uncheck any item or individual repository setting you want to leave out.

Import applies selected settings to the repository you are editing. Its Git origin and existing checkouts stay in place. When an app package contains several repositories, choose Repository to use as the template. Additional clones are optional. The preview shows current and imported values, shared definitions affected elsewhere, and dependencies that need local mappings.

The native app offers this flow from Edit Repository. See Import and export for conflict resolution, dependency handling, and clone progress.

Related pages

Codebase details

Branch and stash management for a single checkout.

Builds

Build history and the reusable build scripts you allow here.

Repository preparations

Configure managed files for every worktree.

iOS project management