Documentation Index
Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt
Use this file to discover all available pages before exploring further.
gumloop agents lets you list, inspect, create, and update your agents without leaving the terminal. Every command accepts --json to print the raw response payload.
List agents
gumloop agents list
gumloop agents list --search support --limit 50
ID, NAME, MODEL, TEAM, and ACTIVE. If the response is paginated, the next cursor is printed at the bottom — pass it back with --cursor.
| Flag | Description |
|---|
--search | Filter agents by name or description. |
--limit | Maximum number of agents to return. |
--cursor | Pagination cursor from a previous list call. |
--json | Print the raw response payload. |
--team-id global flag scopes the listing to a single team.
Get an agent
gumloop agents get agent_abc
id, model_name, team_id, is_active, folder_id, description, created_at, and the system prompt (if set).
Grab the agent ID from the first column of gumloop agents list.
Create an agent
gumloop agents create --name "Support bot" --model auto
| Flag | Required | Description |
|---|
--name | yes | Display name for the new agent. |
--model | yes | Model name (for example auto, anthropic/claude-sonnet-4). |
--description | | Short description. |
--system-prompt | | Inline system prompt text. |
--system-prompt-file | | Path to a file containing the system prompt. Mutually exclusive with --system-prompt. |
--tools-json | | Inline JSON array of tool config objects. |
--tools-file | | Path to a JSON file containing the tools array. Mutually exclusive with --tools-json. |
--json | | Print the raw response payload. |
gumloop agents create --name "Sales research" --model auto \
--system-prompt-file ./prompts/sales.md
gumloop agents create --name "Email reader" --model auto \
--tools-json '[{"type":"gumcp_server","server":"gmail"}]'
To see the exact tool config shape an agent uses, run gumloop agents get <id> --json on an existing agent and copy the tools array out of the response.
Update an agent
gumloop agents update agent_abc --name "Better bot"
gumloop agents update agent_abc --system-prompt-file new-prompt.md
gumloop agents update agent_abc --inactive
agents create and adds:
| Flag | Description |
|---|
--is-active / --inactive | Toggle whether the agent runs when triggered. |
