CLI

The mosoo CLI exposes the Public Thread API, Console GraphQL operations, console REST operations, and a machine-readable command catalog.

Install

curl -fsSL https://install.mosoo.ai/install.sh | bash

The installer places the CLI in ~/.local/bin, installs the @mosoo coding-agent Skill, signs in to cloud.mosoo.ai, and runs doctor. Review options without changing your system:

curl -fsSL https://install.mosoo.ai/install.sh | bash -s -- --dry-run

Authenticate and verify

Interactive browser login:

mosoo auth login --hostname cloud.mosoo.ai
mosoo auth status --hostname cloud.mosoo.ai
mosoo doctor --json

Project keys (msp_) do not authorize account management. Use browser login for account-wide Console operations and sign in again after the key cutover to replace legacy credentials with mcli_ credentials. See Authentication and access.

For non-interactive login, pipe a token through standard input instead of placing it in shell history:

printf '%s' "$MOSOO_API_TOKEN" | \
  mosoo auth login --hostname cloud.mosoo.ai --with-token

Discover commands

mosoo --help
mosoo commands --json
mosoo commands show console environments create-environment
mosoo search "create environment"

commands --json is intended for tools and coding Agents. commands show provides the precise schema for one generated command.

Common operations

mosoo ls -o json
mosoo run --help
mosoo console environments create-environment --help

CLI commands are generated from the contract. Update the CLI and inspect its command help first; an older CLI exposing --input-app-id does not match the current Project contract. Use the API quickstart for a complete execution example.

Use --target local|cloud|custom, --base-url, or --hostname to control endpoint resolution. Output formats are table, json, yaml, and raw.