Repository Management

The code-search repo commands let you manage which repositories are indexed.

Commands Overview

Command	Description
`repo list`	List all indexed repositories
`repo add`	Add a repository to index
`repo remove`	Remove a repository
`repo sync`	Trigger re-sync of a repository
`repo status`	Check repository status
`repo exclude`	Exclude repository from indexing
`repo include`	Include previously excluded repo

List Repositories

View all repositories currently indexed.

# List all repos
code-search repo list

# Filter by connection ID
code-search repo list --connection 1

# Show detailed info
code-search repo list --verbose

Options

Option	Short	Description
`--connection`	`-c`	Filter by connection ID
`--verbose`	`-v`	Show detailed info

Output

$ code-search repo list

ID    NAME                    STATUS        BRANCHES
1     myorg/api               ✓ indexed     main
2     myorg/frontend          ✓ indexed     main, develop
3     myorg/services          🔄 indexing   main
4     internal/docs           ✓ indexed     master

4 repositories

With --verbose:

$ code-search repo list --verbose

ID    NAME              STATUS        LAST INDEXED         EXCLUDED   URL
1     myorg/api         ✓ indexed     2024-01-15T10:30:00Z            https://github.com/myorg/api.git
2     myorg/frontend    ✓ indexed     2024-01-15T10:28:00Z            https://github.com/myorg/frontend.git

2 repositories

Add Repository

Add a new repository to be indexed.

# Add a repository with connection ID (required)
code-search repo add https://github.com/myorg/new-service.git --connection 1

# Add with custom name
code-search repo add https://github.com/myorg/repo.git --connection 1 --name custom-name

# Add with specific branch
code-search repo add https://github.com/myorg/repo.git --connection 1 --branch develop

Syntax

code-search repo add <clone-url> [flags]

Options

Option	Description
`--connection`	Connection ID (required)
`--name`	Custom name for the repository
`--branch`	Default branch (default: main)

Examples

# Add a GitHub repository
code-search repo add https://github.com/company/platform.git --connection 1

# Add with custom name and branch
code-search repo add https://gitlab.example.com/internal/tools.git \
  --connection 2 --name internal-tools --branch master

Remove Repository

Remove a repository from the index.

# Remove a repo by ID (will prompt for confirmation)
code-search repo remove 3

# Remove without confirmation
code-search repo remove 3 --force

Options

Option	Description
`--force`	Skip confirmation prompt

Sync Repository

Trigger a re-sync and re-index of a repository.

# Sync a specific repo by ID
code-search repo sync 1

# Sync all repos
code-search repo sync --all

Syntax

code-search repo sync [id] [flags]

Options

Option	Description
`--all`	Sync all repositories

Examples

# Sync a specific repo
code-search repo sync 1

# Re-sync everything
code-search repo sync --all

Check Status

Get detailed status of a specific repository.

# Check status of a specific repo by ID
code-search repo status 1

Status Values

Status	Indicator	Description
`indexed`	✓	Ready for search
`pending`	⏳	Waiting to be indexed
`cloning`	📥	Cloning repository
`indexing`	🔄	Building search index
`failed`	✗	Indexing failed

Output

$ code-search repo status 1

ID:         1
Name:       myorg/api
Status:     ✓ indexed
URL:        https://github.com/myorg/api.git
Branches:   main, develop, feature/new-api
Indexed:    2024-01-15T10:30:00Z

Exclude Repository

Exclude a repository from sync and indexing (soft delete).

code-search repo exclude 3

This keeps the repository in the database but excludes it from future syncs.

Include Repository

Include a previously excluded repository.

code-search repo include 3

The repository will be included in the next sync cycle.

Next Steps

Search - Search your repositories
Find - Find files and symbols
Replace - Make bulk changes