Overview

The agent command is the core of the GemKit ecosystem. It allows you to discover the best agents for your tasks, list available agents, and spawn them for specific jobs.

Subcommands

`gk agent search`

Search for the optimal agent and skill combination for a specific task.

bash

gk agent search "Implement a React login form with validation"

This uses BM25 search logic to scan your agents and extensions to find the best match.

`gk agent list`

List all available agents in your current project.

bash

gk agent list

`gk agent info`

Get detailed information about a specific agent.

bash

gk agent info researcher

`gk agent spawn`

Spawn an agent to perform a specific task.

bash

gk agent spawn --agent researcher --prompt "Research best practices for OAuth 2.1"

Options:

--agent, -a: The agent role to spawn (e.g., researcher, code-executor).
--prompt, -p: The task or prompt for the agent.
--skills, -s: Comma-separated list of skills to activate.
--context, -c: Path to context files or directories.
--model, -m: Override the default model (e.g., gemini-2.0-flash).

Best Practices

Be Specific: When using agent search, provide as much context as possible for better matching.
Context Matters: Use the --context flag to provide relevant files to the agent. This significantly improves output quality.
Skill Activation: Only activate the skills necessary for the task to keep the prompt focused and save tokens.