Commands

Commands Reference¶

This page provides an overview of all available commands in Cursor-Utils. For detailed documentation on each command, follow the links to the individual command pages.

Command Overview¶

Cursor-Utils provides the following core commands:

Command	Description	Documentation
`config`	Manage configuration settings	config command
`gemini`	Generate content with Google's Gemini AI	gemini command
`github`	Interact with GitHub repositories	github command
`web`	Perform web research using Perplexity AI	web command
`project`	Analyze local project code	project command
`repo`	Analyze and query remote code repositories	repo command

Command Summaries¶

Config Command¶

The config command manages persistent configuration settings, particularly API keys.

cursor-utils config {get|set|delete|list} [KEY] [VALUE]

Key Features: - Store and retrieve API keys securely - List all configuration values - Set default values for command options - Support for environment variable overrides

Learn more about the config command →

Gemini Command¶

The gemini command generates content using Google's Gemini AI models.

cursor-utils gemini [OPTIONS] PROMPT

Key Features: - Generate code, documentation, and explanations - Select from multiple Gemini models - Customize generation parameters - Format output in various formats

Learn more about the gemini command →

GitHub Command¶

The github command provides tools for interacting with GitHub repositories.

cursor-utils github COMMAND [OPTIONS]

Key Features: - Get repository information - List and manage issues - List and manage pull requests - Create new issues and pull requests

Learn more about the github command →

Web Command¶

The web command searches the web using Perplexity AI to provide curated results.

cursor-utils web [OPTIONS] QUERY

Key Features: - Perform intelligent web searches - Get curated results for technical queries - Select from multiple Perplexity models - Format output in various formats

Learn more about the web command →

Project Command¶

The project command analyzes local project code using Google's Gemini AI.

cursor-utils project [OPTIONS] PROJECT_PATH QUERY

Key Features: - Analyze local codebases - Get AI-powered insights about code structure - Ask questions about code functionality - Limit analysis to specific files or directories

Learn more about the project command →

Repo Command¶

The repo command analyzes and queries remote code repositories.

cursor-utils repo [OPTIONS] REPO_URL QUERY

Key Features: - Analyze remote repositories - Clone and analyze specific branches - Get AI-powered insights about code structure - Ask questions about code functionality

Learn more about the repo command →

Common Command Patterns¶

All Cursor-Utils commands follow these common patterns:

Output Formatting¶

All commands support multiple output formats:

cursor-utils COMMAND --format {plain|markdown|json|rich}

Help Information¶

All commands provide detailed help information:

cursor-utils COMMAND --help

Error Handling¶

All commands use consistent error handling with meaningful exit codes:

cursor-utils COMMAND
if [ $? -ne 0 ]; then
  echo "Command failed"
fi

Command Relationships¶

Commands in Cursor-Utils are designed to work together:

Configuration: The config command manages settings used by all other commands
Content Generation: The gemini command provides AI-powered content generation
Research: The web command provides research capabilities
Code Analysis: The project and repo commands analyze code
GitHub Integration: The github command manages GitHub repositories

Best Practices¶

Set Default Configuration: Use the config command to set default values
```
cursor-utils config set default_format markdown
```

Combine Commands: Use command output in scripts

REPO_INFO=$(cursor-utils github repo --owner microsoft --repo vscode --format json)
REPO_NAME=$(echo $REPO_INFO | jq -r '.name')

Use Appropriate Models: Select the right model for your task

# For creative content
cursor-utils gemini --model gemini-2.0-pro-exp "Generate test scenarios"

# For factual research
cursor-utils web --model sonar-reasoning "Explain ACID properties"

Limit Analysis Scope: For large repositories, limit the scope

cursor-utils project . --max-files 20 "Explain the authentication system"

Command Documentation¶

For detailed documentation on each command, refer to the dedicated command pages: