Inth CLI

Inth CLI flags and raw API requests

Use --json for structured output, --non-interactive to disable prompts, and inth api <path> for a raw API request. Check inth <command> --help before choosing flags, because accepted options depend on the command.

Which flags control output and authentication?

FlagBehavior
--helpShow the relevant command's options and examples
--versionPrint the installed CLI version
--jsonEmit one JSON result and disable prompts and browser login
--non-interactiveDisable prompts while keeping text output
--token <key>Use an organization API key instead of INTH_TOKEN or saved credentials
--auth browser|agentOverride the selected saved connection
--organization <id>Override the organization for commands that support it

Flags are command-specific. Use inth <command> --help to check whether a flag is accepted. For example, a command that takes a resource ID rejects --organization, since the server resolves ownership from the ID.

Piping output does not select JSON mode. The automation guide describes the JSON envelope, error codes, and exit statuses. Skill installation forwards upstream text output and does not support --json; the bundled skill catalog supports --list --json.

How do I set pagination and JSON request bodies?

Paginated lists accept --limit from 1 through 100, defaulting to 50, and an opaque --cursor. Values outside the --limit range fail argument validation. Each invocation returns one page. Pass pagination.nextCursor from the response unchanged when requesting the next page.

Resource writes with body options accept --data '<JSON object>' instead of individual fields, except org create. This supports nested fields and explicit null values. Do not combine --data with individual body options.

inth project update prj_123 --data '{"description":null,"consent":{"trustedOrigins":[]}}'

How do I call the Inth API directly?

api prints the server JSON response by default. Add --json to wrap it in the CLI envelope.

inth api /v1/me
inth api /v1/projects --organization org_123 --json
inth api /v1/projects/prj_123 --method PATCH --data '{"description":null}'

Requests support GET, POST, PATCH, and DELETE. GET is the default. Authenticated requests must stay under https://api.inth.com/v1/, and redirects are rejected. An explicit organizationId query parameter overrides organization defaults.

Writes take effect immediately without confirmation prompts. The requested endpoint determines the required scopes and accepted credentials.

Which environment variables does the Inth CLI read?

VariablePurpose
INTH_TOKENOrganization API key for commands that accept keys
INTH_TELEMETRY_DISABLED=1Disable analytics and unexpected-error reporting
CIA truthy value disables telemetry
NO_COLOR=1Disable terminal colors
CODEX_HOMESelect the Codex global configuration directory for MCP setup
DO_NOT_TRACK, DISABLE_TELEMETRYPassed through to the upstream skills installer

For telemetry overrides, empty values, 0, and false do not override the saved preference. See Telemetry for exactly what production builds send.