Gumloop for Terminal

gumloop is the command line for Gumloop. Sign in once, then drive your agents, sessions, chat completions, MCP integrations, Company Brain, skills, and artifacts from the terminal. Every command has a --json mode so you can pipe results into scripts, cron jobs, or any other tool you already use.

Install

curl -fsSL https://gumloop.com/cli/install.sh | sh

The installer is fully self-contained under ~/.gumloop — it ships its own Python, never touches your system Python, and needs no sudo. Verify the install:

gumloop --version

Update any time with:

gumloop update

Using Gumloop as a library instead? See the Python SDK.

Windows is not supported. The Gumloop CLI runs on macOS and Linux only. This applies to every command — including gumloop login and syncing skills or artifacts — because credential storage and the OAuth callback server rely on POSIX-only paths.Windows users have two options:

Use WSL (Windows Subsystem for Linux) and install the CLI inside your Linux distribution. This is the recommended path.
Use the Python SDK instead — it works natively on Windows. Import from gumloop import Gumloop directly. See the Python SDK reference.

Linux prerequisites

The CLI stores credentials in your OS keychain. macOS Keychain is always available, but on Linux you need one of:

sudo apt install gnome-keyring libsecret-1-0
sudo apt install kwalletmanager

On a headless box without a keychain, skip gumloop login entirely and pass credentials per invocation via environment variables.

gumloop login

Pick OAuth (browser) at the prompt. The CLI opens your browser, you click “Allow” on the Gumloop consent screen, and you’re signed in. Tokens are stored in your OS keychain and the CLI refreshes them for you when they expire. Prefer an API key, or running on a headless box? See Authentication.

Your first command

List the agents you can see:

gumloop agents list

ID                NAME                MODEL                       TEAM            ACTIVE
agent_g6f1a2b3    Sales research      anthropic/claude-sonnet-4   team_4f8c92ab   yes
agent_h7e9c1d4    Support triage      openai/gpt-5                team_4f8c92ab   yes

Grab an ID from that table and start a chat:

gumloop sessions create agent_g6f1a2b3 --input "Summarize this week's pipeline."

That’s it. From here, every command works the same way — gumloop <thing> <action>, with --help on anything to see all the flags.

Commands

Command	What it does
`gumloop login` / `logout`	Manage stored credentials
`gumloop agents`	List, inspect, create, and update agents
`gumloop sessions`	Create, inspect, send messages to, and cancel agent sessions
`gumloop chat`	Send chat completions to any supported model (unary, streaming, structured, image)
`gumloop mcp`	Explore connected MCP servers and execute their tools
`gumloop brain`	Search your Company Brain’s indexed knowledge sources
`gumloop skills`	List, upload, update, and download skill files
`gumloop artifacts`	List and download artifacts produced by agents

Global flags

These work on every command:

Flag	Env var	Description
`--team-id`	`GUMLOOP_TEAM_ID`	Scope the command to a single team (workspace).
`--base-url`	`GUMLOOP_BASE_URL`	Override the Gumloop API base URL (useful for self-hosted/staging).
`--version`, `-V`	—	Print the CLI version and exit.
`--help`, `-h`	—	Show contextual help for any command or subcommand.

Most subcommands additionally accept --json to print the raw response payload instead of the human-friendly table, which is handy for piping into jq, scripts, or other tools.

​Install

​Linux prerequisites

​Sign in

​Your first command

​Commands

​Global flags

Install

Linux prerequisites

Sign in

Your first command

Commands

Global flags