Managing Goose Sessions

Goose sessions are your way to interact with Goose, providing a space to ask questions and prompt action. In this guide, we'll cover how to start, end, save, resume, and delete a session.

Starting a Session

To start a new session, run the following command within your terminal:

goose session start 

By default, Goose will provide a random string as the name of your session. If you'd like to provide a specific name, this is where you'd do so. For example to name your session 'react-migration', you would run:

goose session start react-migration

You'll know your session has started when your terminal looks similar to the following:

starting session | name: react-migration profile: default

Info

If this is your first session, Goose will prompt you for an API key to access an LLM (Large Language Model) of your choice. For more information on setting up your API key, see the Getting Started Guide. Here is the list of Goose-supported LLMs.

Exiting a Session

To exit a session, hold down Ctrl + C to cancel and automatically save it. Alternatively, you can type exit to save and exit the session.

Your session will be stored locally in a path similar to:

~/.config/goose/logs

This path is typically found in your Users folder.

Resuming a Session

To resume your latest session, you can run the following command:

goose session resume

To resume a specific session, you can first check the sessions you currently have by running:

goose session list 

This command will display a list of all saved sessions, showing a name, date, and time for each session. The output should look similar to the following:

2024-11-12  14:12:28  managing-goose
2024-11-12. 13:48:11  blog
2024-11-12  13:27:21  react-migration
2024-11-04  16:14:29  e6d7

To resume a specific session, run the following command:

goose session resume react-migration

Deleting Old Sessions

Goose allows you to delete all previously saved sessions. However, it currently doesn't allow you to select specific sessions to delete. Be cautious when running this command as all sessions prior to the day the command was ran will be deleted.

To delete previously saved sessions, you can run the following command:

goose session clear

You can also decide how many sessions you want to keep, starting from the most recent. To keep 2 sessions you would run the following command:

goose session clear --keep 2  

Info

Once a session is deleted it can not be retrieved.