@moxt-ai/cli

Moxt CLI - AI Workspace command line tool.

Installation

npm install -g @moxt-ai/cli

Usage

moxt [command] [options]

Commands

whoami

Show current user information.

moxt whoami

workspace

Workspace management.

# List all workspaces you belong to
moxt workspace list

members

Manage workspace members.

# List all members in a workspace
moxt members list -w <workspace-id>

# Remove members by email (comma-separated)
moxt members remove -w <workspace-id> <email1>,<email2>

space

List accessible spaces in a workspace.

# List all accessible spaces (personal, team, teammate)
moxt space list -w <workspace-id>

Output columns: TYPE, TEAM_SPACE_ID, TEAMMATE_ID, NAME

• personal — Your personal space (Momo). Both IDs are empty; this is the default.
• team — Teamspace. Only TEAM_SPACE_ID is populated.
• teammate — AI teammate. Only TEAMMATE_ID is populated.

file

File operations on a space. Use moxt space list to find available spaces.

# List directory contents (defaults to personal space)
moxt file list -w <workspace-id> [-p <path>]

# List directory in personal space (explicit)
moxt file list -w <workspace-id> --personal [-p <path>]

# List directory in a teamspace (by name)
moxt file list -w <workspace-id> -s <teamspace-name> [-p <path>]

# List directory in a teamspace (by ID)
moxt file list -w <workspace-id> --team-space-id <teamSpaceId> [-p <path>]

# List directory in a teammate space (by teammate ID)
moxt file list -w <workspace-id> --teammate-id <teammateId> [-p <path>]

# Read file content by path
moxt file read -w <workspace-id> -p <path>

# Read file content from a teamspace (by name or ID)
moxt file read -w <workspace-id> -s <teamspace-name> -p <path>
moxt file read -w <workspace-id> --team-space-id <teamSpaceId> -p <path>

# Read file content from a teammate space (by teammate ID)
moxt file read -w <workspace-id> --teammate-id <teammateId> -p <path>

# Read file content by URL
moxt file read --url <moxt-url>

# Resolve the shareable browser URL for a file by path
moxt file get-url -w <workspace-id> -p <path>

# Resolve URL in a teamspace (by name or ID)
moxt file get-url -w <workspace-id> -s <teamspace-name> -p <path>
moxt file get-url -w <workspace-id> --team-space-id <teamSpaceId> -p <path>

# Resolve URL in a teammate space (by teammate ID)
moxt file get-url -w <workspace-id> --teammate-id <teammateId> -p <path>

# Upload a file by path
moxt file put -w <workspace-id> -p <path> -l <local-path> [-r]

# Upload a file to a teamspace (by name or ID)
moxt file put -w <workspace-id> -s <teamspace-name> -p <path> -l <local-path> [-r]
moxt file put -w <workspace-id> --team-space-id <teamSpaceId> -p <path> -l <local-path> [-r]

# Upload a file to a teammate space (by teammate ID)
moxt file put -w <workspace-id> --teammate-id <teammateId> -p <path> -l <local-path> [-r]

# Overwrite an existing file by its Moxt URL
moxt file put --url <moxt-url> -l <local-path>

# Create a directory
moxt file mkdir -w <workspace-id> -p <path> [-r]
moxt file mkdir -w <workspace-id> -s <teamspace-name> -p <path> [-r]

# Delete a file or empty directory
moxt file del -w <workspace-id> -p <path>
moxt file del -w <workspace-id> -s <teamspace-name> -p <path>

File command options

| Option | Description | |--------|-------------| | -w, --workspace <id> | Workspace ID (required for path mode) | | -s, --space <name> | Space name (personal or teamspace name) | | --personal | Use personal space (default when no space specified) | | --team-space-id <id> | Team space ID | | --teammate-id <id> | Teammate ID (teammate space) | | -p, --path <path> | File or directory path | | -u, --url <url> | Moxt file URL (e.g., https://moxt.ai/w/{workspaceId}/{fileId}) | | -l, --local-path <path> | Local file path (for upload) | | -r, --recursive | Create parent directories if needed (path mode only) |

Note: -s, --personal, --team-space-id, and --teammate-id are mutually exclusive. For file read and file put, use either --url or --workspace with --path. They are mutually exclusive. --url with file put overwrites an existing file identified by the URL; it never creates new files. Use --recursive is not allowed in URL mode. file get-url returns a stable Moxt URL (e.g., https://moxt.ai/w/{workspaceId}/{fileId}) for the given path; the URL is unchanged across writes to the same path and can be fed back into file read --url or file put --url.

Configuration

Set the following environment variables:

| Variable | Description | |----------|-------------| | MOXT_API_KEY | Your Moxt API key | | MOXT_API_URL | API endpoint (default: https://api.moxt.ai) |

License

MIT