> AI agents: this is one page from Mammoth Analytics documentation. The index of all pages as Markdown is https://docs.mammoth.io/llms.txt. Append `.md` to any docs URL, or send `Accept: text/markdown`, to get Markdown. # mammoth agent > All 44 mammoth agent commands, each with its blast radius, confirmation policy and backing Python SDK method. > GENERATED from `mammoth schema list` and `mammoth capability list` (mammoth-cli 2.2.96, released 2026-10-22)—do not edit; run `npm run docs:capabilities`. 44 commands, grouped by blast radius. "Off a terminal" is what a command's confirmation policy requires when nothing can answer a prompt, as in an agent or CI run: `--yes`, plus `--confirm` with the exact target for `confirm_target` commands. `TARGET` stands for the id or name the command acts on; the CLI's `confirmation_required` error names it. The SDK symbol and API operation come from `mammoth capability list`. A command that list does not map to one shows — in both columns; `mammoth schema get ` describes any command in full. ## Destructive | Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation | |---|---|---|---|---|---|---|---|---| | `mammoth agent access grant revoke` | `profile` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_grant_revoke` | `DELETE /agents/access/grants/{grant_id}` (RevokeAgentAccess) | | `mammoth agent access request resolve` | `profile` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_request_resolve` | `PATCH /agents/access/requests/{request_id}` (ResolveAgentAccessRequest) | | `mammoth agent action delete` | `profile` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.action_delete` | `DELETE /agents/sessions/{session_id}/actions/{action_id}` (DeleteAgentSessionAction) | | `mammoth agent session delete` | `profile` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.session_delete` | `DELETE /agents/sessions/{session_id}` (DeleteAgentSession) | ## High impact | Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation | |---|---|---|---|---|---|---|---|---| | `mammoth agent access settings update` | `profile` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_settings_update` | `PATCH /agents/access/settings` (UpdateAgentSettings) | ## External effect | Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation | |---|---|---|---|---|---|---|---|---| | `mammoth agent access grant give` | `profile` | External effect | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_grant_give` | `POST /agents/access/grants` (GiveAgentAccess) | ## Benign mutation | Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation | |---|---|---|---|---|---|---|---|---| | `mammoth agent access chart save` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_chart_save` | `POST /agents/access/saved-charts` (SaveAgentChart) | | `mammoth agent access grant update` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_grant_update` | `PATCH /agents/access/grants/{grant_id}` (ChangeAgentAccess) | | `mammoth agent access request add-to-context` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_request_add_to_context` | `POST /agents/access/requests/{request_id}/project-context` (AddAgentRequestToProjectContext) | | `mammoth agent access request create` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_request_create` | `POST /agents/access/requests` (CreateAgentAccessRequest) | | `mammoth agent chat` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.chat` | `POST /agents/chat` (AgentChat) | | `mammoth agent message set-request-kind` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.message_set_request_kind` | `PATCH /agents/sessions/{session_id}/messages/{message_id}/request-kind` (CorrectAgentRequestKind) | | `mammoth agent plan approve` | `profile` | Benign mutation | `prompt_or_yes` | `--yes` | `not_async` | `none` | — | — | | `mammoth agent plan discard` | `profile` | Benign mutation | `prompt_or_yes` | `--yes` | `not_async` | `none` | — | — | | `mammoth agent plan edit-proposal` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.plan_edit_proposal` | `PATCH /agents/sessions/{session_id}/plan/proposal` (EditAgentPlanProposal) | | `mammoth agent plan skip` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | — | — | | `mammoth agent run extend` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_extend` | `POST /agents/sessions/{session_id}/runs/{run_id}/extend` (ExtendAgentRun) | | `mammoth agent run pause` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_pause` | `POST /agents/sessions/{session_id}/runs/{run_id}/pause` (PauseAgentRun) | | `mammoth agent run resume` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_resume` | `POST /agents/sessions/{session_id}/runs/{run_id}/resume` (ResumeAgentRun) | | `mammoth agent run retry` | `profile` | Benign mutation | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_retry` | `POST /agents/sessions/{session_id}/runs/{run_id}/retry` (RetryAgentRun) | | `mammoth agent run stop` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_stop` | `POST /agents/sessions/{session_id}/runs/{run_id}/stop` (StopAgentRun) | | `mammoth agent run units set` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_units_set` | `POST /agents/sessions/{session_id}/runs/{run_id}/units` (RegisterAgentRunUnits) | | `mammoth agent session set-visibility` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.session_set_visibility` | `PATCH /agents/sessions/{session_id}` (SetAgentSessionVisibility) | | `mammoth agent turn cancel` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.turn_cancel` | `POST /agents/sessions/{session_id}/turns/{turn_id}/cancel` (CancelAgentTurn) | | `mammoth agent turn rate` | `profile` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.turn_rate` | `POST /agents/sessions/{session_id}/turns/{turn_id}/feedback` (RateAgentTurn) | ## Read | Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation | |---|---|---|---|---|---|---|---|---| | `mammoth agent access askers` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_project_askers` | `GET /agents/access/projects/{project_id}/askers` (GetAgentProjectAskers) | | `mammoth agent access grant list` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_grants_list` | `GET /agents/access/grants` (ListAgentGrants) | | `mammoth agent access me` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_me` | `GET /agents/access/me` (GetAgentAccessMe) | | `mammoth agent access people` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_people` | `GET /agents/access/people` (ListAgentPeople) | | `mammoth agent access reach` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_reach` | `GET /agents/access/reach` (GetAgentAccessReach) | | `mammoth agent access request list` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_requests_list` | `GET /agents/access/requests` (ListAgentAccessRequests) | | `mammoth agent access request mine` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_requests_mine` | `GET /agents/access/requests/mine` (ListMyAgentAccessRequests) | | `mammoth agent access settings get` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_settings_get` | `GET /agents/access/settings` (GetAgentSettings) | | `mammoth agent access tree` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.access_tree` | `GET /agents/access/tree` (GetAgentAccessTree) | | `mammoth agent action list` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.action_list` | `GET /agents/sessions/{session_id}/actions` (ListAgentSessionActions) | | `mammoth agent run instance list` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_instances_list` | `GET /agents/sessions/{session_id}/runs/{run_id}/instances` (ListAgentRunInstances) | | `mammoth agent run instance messages` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_instance_messages` | `GET /agents/sessions/{session_id}/runs/{run_id}/instances/{instance_id}/messages` (ListAgentInstanceMessages) | | `mammoth agent run instance transcript` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_instance_transcript` | `GET /agents/sessions/{session_id}/runs/{run_id}/instances/{instance_id}/transcript` (GetAgentInstanceTranscript) | | `mammoth agent run list` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_list` | `GET /agents/sessions/{session_id}/runs` (ListAgentSessionRuns) | | `mammoth agent run status` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_status` | `GET /agents/sessions/{session_id}/run` (GetAgentSessionRun) | | `mammoth agent run units list` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.run_units_list` | `GET /agents/sessions/{session_id}/runs/{run_id}/units` (ListAgentRunUnits) | | `mammoth agent session feedback list` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.turn_feedback_list` | `GET /agents/sessions/{session_id}/feedback` (ListAgentTurnFeedback) | | `mammoth agent session list` | `profile` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.agents.AgentsAPI.session_list` | `GET /agents/sessions` (ListAgentSessions) | | `mammoth agent session messages` | `profile` | Read | `none` | — | `not_async` | `none` | `mammoth.api.agents.AgentsAPI.session_messages` | `GET /agents/sessions/{session_id}/messages` (GetAgentSessionMessages) | --- Source: https://docs.mammoth.io/build/cli/agent.md · Updated: 2026-10-22