goose-session - Man Page

session [-n|--name] [--session-id] [--path] [-r|--resume] [--fork] [--history] [--debug] [--max-tool-repetitions] [--max-turns] [--container] [--with-extension] [--with-streamable-http-extension] [--with-builtin] [--no-profile] [-h|--help] [subcommands]

Start or resume interactive chat sessions

-n,  --name <NAME>

Specify a name for your chat session. When used with --resume, will resume this specific session if it exists.

--session-id <SESSION_ID>

Specify a session ID directly. When used with --resume, will resume this specific session if it exists.

--path <PATH>

Legacy parameter for backward compatibility. Extracts session ID from the file path (e.g., '/path/to/20250325_200615. jsonl' -> '20250325_200615').

-r,  --resume

Continue from a previous session. If --name or --session-id is provided, resumes that specific session. Otherwise, resumes the most recently used session.

--fork

Create a new session by copying all messages from a previous session. Must be used with --resume. If --name or --session-id is provided, forks that specific session. Otherwise, forks the most recently used session.

--history

Show previous messages when resuming a session

--debug

When enabled, shows complete tool responses without truncation and full paths.

--max-tool-repetitions <NUMBER>

Set a limit on how many times the same tool can be called consecutively with identical parameters. Helps prevent infinite loops.

--max-turns <NUMBER>

Set a limit on how many turns (iterations) the agent can take without asking for user input to continue.

--container <CONTAINER_ID>

Run extensions (stdio and built-in) inside the specified container. The extension must exist in the container. For built-in extensions, goose must be installed inside the container.

--with-extension <COMMAND>

Add stdio extensions from full commands with environment variables. Can be specified multiple times. Format: 'ENV1=val1 ENV2=val2 command args...'

--with-streamable-http-extension <URL>

Add streamable HTTP extensions from a URL. Can be specified multiple times. Format: 'url...' or 'url... timeout=100' to set up timeout other than default

--with-builtin <NAME>

Add one or more builtin extensions that are bundled with goose by specifying their names, comma-separated

--no-profile

Don't load your default extensions, only use CLI-specified extensions

-h,  --help

Print help (see a summary with '-h')

session-list(1)

List all available sessions

session-remove(1)

Remove sessions. Runs interactively if no ID, name, or regex is provided.

session-export(1)

Export a session

session-import(1)

Import a session from JSON, a Claude Code / Codex / Pi .jsonl, or an encrypted Nostr share link

session-diagnostics(1)

session-help(1)

Print this message or the help of the given subcommand(s)

goose(1), goose-acp(1), goose-completion(1), goose-configure(1), goose-doctor(1), goose-gateway(1), goose-info(1), goose-mcp(1), goose-plugin(1), goose-project(1), goose-projects(1), goose-recipe(1), goose-review(1), goose-run(1), goose-schedule(1), goose-serve(1), goose-skills(1), goose-term(1)

goose(1), goose-acp(1), goose-completion(1), goose-configure(1), goose-doctor(1), goose-gateway(1), goose-info(1), goose-mcp(1), goose-plugin(1), goose-project(1), goose-projects(1), goose-recipe(1), goose-review(1), goose-run(1), goose-schedule(1), goose-serve(1), goose-session-diagnostics(1), goose-session-export(1), goose-session-import(1), goose-session-list(1), goose-session-remove(1), goose-skills(1), goose-term(1).