gk session

Overview

The gk session command manages GemKit sessions with subcommands for status tracking, listing, detailed information, and agent management.

Usage

gk session [subcommand] [id] [options]

Alias: gk s

Subcommands

status (default)

Displays the currently active session.

gk session status
gk session  # same as above

Output includes:

• Session ID
• Gemini Session ID
• Project directory
• App name
• Process ID
• Status
• Start timestamp
• Active plan
• Agent metrics

list

Shows recent sessions.

gk session list
gk session list -n 20  # show 20 sessions

Options:

• -n, --limit <n> - Number of results (default: 10)

Output:

• Session ID (truncated)
• Timestamp
• Plan information

info

Retrieves detailed information for a specific session.

gk session info <session-id>

Required: Session ID

Exits with status 1 if session not found.

agents

Lists agents within a session.

gk session agents          # uses active session
gk session agents <id>     # specific session

Output includes:

• Agent role
• Type (Main/Sub)
• Model used
• Tokens consumed
• Gemini ID
• Status

init

Initializes a new non-Gemini GemKit session.

gk session init
gk session init my-app

Default app name: "app"

Prevents duplicate initialization in the same terminal.

Global Options

Examples

# Check current session status
gk session status

# List recent sessions
gk session list

# Get details of specific session
gk session info abc123

# List agents in active session
gk session agents

# List agents in specific session
gk session agents abc123

# Initialize a new session
gk session init my-project

# Output as JSON
gk session status --json
gk session list --json

Related Commands

• gk agent - Spawn agents that create sessions
• gk tokens - Analyze session token usage
• gk office - Visual session monitoring