Sessions - Gumloop

A session is a single conversation thread with one agent — start it, send messages back and forth, then cancel or let it finish. gumloop sessions is how you do all of that from the terminal.

Create a session

Start a new conversation with an agent, optionally with the first user message:

gumloop sessions create agent_abc --input "Hello!"

Read the message from a file or stdin to avoid escaping:

echo "Summarize this thread:" | gumloop sessions create agent_abc --input-stdin -

gumloop sessions create agent_abc --input-stdin - < ./prompt.md

Flag	Description
`--input`	Initial user message text.
`--input-stdin -`	Read the initial message from stdin. Mutually exclusive with `--input`.
`--session-id`	Pre-assign a client-side session ID (otherwise the server assigns one).
`--json`	Print the raw response payload.

The output shows the new session ID, the agent it’s running against, its state, the creation timestamp, and the last few messages. Hang on to the session ID — you’ll need it to send follow-ups.

Don’t have an agent ID yet? Run gumloop agents list to see all the agents you can talk to.

Get a session

gumloop sessions get session_abc

Prints the session metadata and the last five messages. Add --json for the full transcript.

Send a follow-up

gumloop sessions send session_abc --input "follow-up question"

Same input options as sessions create:

cat next-turn.txt | gumloop sessions send session_abc --input-stdin -

Cancel a session

gumloop sessions cancel session_abc

Stops a session that’s currently running.

The CLI returns the agent’s final response after each create / send call but does not stream tokens as they’re generated. If you need token-by-token streaming, use client.sessions.stream() from the Python SDK directly.

​Create a session

​Get a session

​Send a follow-up

​Cancel a session

Create a session

Get a session

Send a follow-up

Cancel a session