Back to Home
CLI Commands

CLI Overview

Reference for all GemKit CLI commands

Introduction

The GemKit CLI (gk) is the primary interface for interacting with GemKit. It provides commands for initializing projects, managing agents, and executing workflows.

Command Structure

All commands follow this basic structure:

bash
gk [command] [options] [arguments]

Primary Commands

CommandDescription
initInitialize a new GemKit project or kit
newCreate new agents, plans, or skills from templates
agentManage, search, and spawn specialized AI agents
officeStart the Agent Office visualization dashboard
sessionView and manage active agent sessions
planCreate, manage, and execute development plans
tokensAnalyze token usage and costs across sessions
configView and manage global/local configuration
cacheManage local cache for performance and offline use
extensionInstall and manage CLI extensions
catalogBrowse and download kits from the GemKit Catalog
doctorDiagnose environment issues and check health
updateUpdate GemKit components to the latest version
convertConvert between different file formats and schemas
pasteHandle image and video pasting into AI context

Global Options

  • --help, -h: Show help for any command
  • --version, -v: Show GemKit version
  • --verbose: Enable detailed logging output
  • --json: Format output as JSON for scripting

Getting Help

You can get help for any specific command by appending --help:

bash
gk agent --help
Caught a mistake? Edit this page on GitHub
Updated: Jan 20, 2026