mammoth-cli 1.0.2

Command-line interface for the Mammoth Analytics platform

mammoth-cli

Drive the Mammoth Analytics platform from your terminal. The mammoth command uploads data, runs pipeline transformations, manages projects and dashboards, and exports results — for people at a shell and for autonomous agents alike.

• Human-friendly by default. In a terminal, commands print a readable table.
• Agent-native. When output is piped, you get a stable JSON envelope with a documented schema, exit codes, and error codes — no flags required.
• Safe. Every mutation carries a reviewed confirmation policy, so a destructive command never runs unattended by accident.
• Discoverable. mammoth capability list and mammoth schema get describe every command, so an agent can learn the surface at runtime.

The CLI is built on the public mammoth-io SDK. It adds no second HTTP client and calls no private SDK members.

Install

uv tool install mammoth-cli      # recommended: isolated, on your PATH
# or
pipx install mammoth-cli
# or
python -m pip install mammoth-cli

Then confirm the install:

mammoth --version

The CLI supports Python 3.12, 3.13, and 3.14. For the one-line installers and the verified (signed) install flow, see docs/installation.md.

Quick start

mammoth auth login -w 4          # log in once; the secret goes to your OS keyring
mammoth doctor                   # confirm credentials resolve and the API answers
mammoth project list             # a table in a terminal, JSON when piped
mammoth dataset list --project 180

Full walkthrough: docs/quickstart.md.

Built for agents and CI

Piping or redirecting output yields the machine envelope, and --no-input turns on automatically off a terminal, so an agent needs no special flags:

mammoth project list | jq '.data'

To be explicit, pass --output json --no-input. Log in without a prompt with a permission-checked file:

mammoth auth login --input creds.json --output json --no-input

Feed multi-field requests as one document instead of many flags:

mammoth view transform math 1039 --project 180 \
  --input '{"expression": "price * qty", "new_column": "total"}'

Install the bundled agent skill for Claude Code, Codex, and Cursor:

mammoth skill install

See docs/agents.md and the agent skill.

What you can do

Area	Command families
Data in and out	file, dataset, connector, addon
Shape and analyze	view, dataset, ai
Organize	project, folder, dashboard, report, template
Automate	automation, workflow, schedule, batch, webhook
Administer	workspace, user, billing, client-app, external-key
Operate the CLI	auth, context, config, doctor, capability, schema, skill, upgrade

The full generated list is in docs/reference/commands.md.

Documentation

Guide	What it covers
Installation	Install the CLI and the agent skill.
Quick start	Log in and run your first commands.
Authentication	Getting an API key, login, profiles, projects.
Agent and CI usage	Machine output, structured input, patterns.
Safe mutation	Mutation classes and confirmation policies.
Output and errors	Envelopes, exit codes, error codes.
Global flags	The flags every command shares.
Troubleshooting	Exit codes, error envelopes, recovery.
Upgrade / Uninstall	Keep the CLI current, or remove it.
Command reference	Every command, grouped by family.

Agent-readable indexes: docs/llms.txt and docs/llms-full.txt.

Compatibility

mammoth-cli follows Semantic Versioning for the 1.x series:

• The machine-output and error-envelope contract is stable. SCHEMA_VERSION (see mammoth_cli/__init__.py) identifies it and never changes incompatibly within a major version. New fields may be added; existing ones are preserved.
• The CLI surface is stable. Command names, flags, and exit codes are not removed or repurposed within a major version.
• Bug fixes ship in patch releases. Additive changes ship in minor releases.

Development

pytest tests/ -q                 # unit + contract tests (live tests deselected)
ruff check mammoth_cli scripts tests
mypy mammoth_cli
make cli-docs-check              # documentation gates

Build scripts under scripts/ regenerate the manifests and the documentation corpus offline. Release and packaging details live in ../RELEASING.md.

License

See LICENSE. Source: https://github.com/EdgeMetric/mammothsdk