NAME¶

glab-search-semantic - Search project code using natural language.

SYNOPSIS¶

glab search semantic [flags]

DESCRIPTION¶

Search project code using natural language (semantic similarity).

Requires the project to have semantic code search enabled via GitLab Duo.

This feature is in beta and might not be ready for production use. It might be unstable and breaking changes can occur outside of major releases. For more information, see https://docs.gitlab.com/policy/development_stages_support/.

OPTIONS¶

-d, --directory-path="" Restrict search to files under this path (e.g. app/services/).

--knn=0 Nearest neighbours to retrieve (1–100). Defaults to 64 server-side.

-l, --limit=0 Maximum number of results (1–100). Defaults to 20 server-side.

-F, --output="text" Format output as: text, json.

-q, --query="" Natural language search query.

OPTIONS INHERITED FROM PARENT COMMANDS¶

-h, --help[=false] Show help for this command.

-R, --repo="" Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

EXAMPLE¶

# Search for authentication-related code in the current project
glab search semantic -q "authentication middleware"
# Search within a specific directory
glab search semantic -q "rate limiting" -d app/services/
# Search in a specific project with JSON output
glab search semantic -q "CI pipeline triggers" -R gitlab-org/gitlab --output json
# Limit results
glab search semantic -q "database migrations" --limit 5

SEE ALSO¶

glab-search(1)