divekit search

Synopsis

Search for Divekit projects by name, distribution, or user.

Provides both interactive and non-interactive modes for finding projects in the local index. Selected projects can be navigated to or have actions executed on them.

Modes

  Interactive (default when no arguments):
    Launches a TUI to browse and select projects.
    Output: prints selected project path to stdout.

  Non-Interactive (when search terms or filters provided):
    Searches with provided terms/filters and prints matching paths.

Available Actions

  distribute    Run distribute on selected project
  doctor        Run doctor on selected project
  fetch-all     Fetch all repositories
  fetch-one     Fetch single repository
  overview      Show project overview
  passcheck     Run passcheck
  run           Run an extension (requires --run-script)

Usage

divekit search [term...] [flags]

Examples

# Launch interactive search (default)
divekit search

# Search by project name
divekit search my-project

# Filter by user
divekit search --user alice

# Filter by distribution
divekit search -d ST2M4

# Navigate to selected project
cd $(divekit search)

# Search and run distribute on selection
divekit search --action distribute

# Search and run an extension
divekit search --action run --run-script analyze

Flags

--action string         Action to run on selection: distribute|doctor|fetch-all|fetch-one|overview|passcheck|run
  -d, --distribution string   Filter by distribution name
  -r, --remote string         Remote repository URL (e.g. GitLab instance)
      --run-script string     Extension to run when --action=run (path or extension name)
  -t, --token string          GitLab token or token file path (file:///...)
      --user string           Filter by username

Inherited Flags

-l, --loglevel string   log level (debug, info, warn, error, fatal) (default "info")
      --no-index          skip project index update
      --non-interactive   run in non-interactive mode (fails if interactive input is required)
  -y, --yes               assume yes/default for all prompts (non-interactive with automatic defaults)