goose/docs/plugins/cli.md

Goose CLI Commands

Goose provides a command-line interface (CLI) with various commands to manage sessions, toolkits, and more. Below is a list of the available commands and their descriptions:

Goose CLI

version

Usage:

  goose version

Lists the version of Goose and any associated plugins.

session

start

Usage:

  goose session start [--profile PROFILE] [--plan PLAN] [--log-level [DEBUG|INFO|WARNING|ERROR|CRITICAL]] [--tracing]

Starts a new Goose session.

If you want to enable locally hosted Langfuse tracing, pass the --tracing flag after starting your local Langfuse server as outlined in the Contributing Guide's Development guidelines.

resume

Usage:

  goose session resume [NAME] [--profile PROFILE]

Resumes an existing Goose session.

list

Usage:

  goose session list

Lists all Goose sessions.

clear

Usage:

  goose session clear [--keep KEEP]

Deletes old Goose sessions, keeping the most recent ones as specified by the --keep option.

toolkit

list

Usage:

  goose toolkit list

Lists all available toolkits with their descriptions.