Moon CLI always works on behalf of a workspace: its plan grants access and its usage limit applies.
The session’s workspaceLink to the The session’s workspace section
When you sign in, Moon CLI picks a workspace for the session:
- the workspace open on the web, if it includes Moon CLI;
- otherwise the first of your workspaces that includes it, starting with your personal workspace;
- otherwise the workspace open on the web.
This choice is specific to the Moon CLI session. Switching workspaces in Moon CLI does not change the one on the web, and vice versa.
See and change the workspaceLink to the See and change the workspace section
moon workspaceVos workspaces :
1. Mon workspace (personnel) · Lune ·
5d1e0c3a-7b2f-4c11-9e8a-2f6b1d4c7a90
2. Studio · Étoile ✦ ● utilisé par Moon CLI
a83f62d1-0c4e-4b9a-8f17-6e2d5b9c0f34
✦ = éligible Moon CLI (Étoile ou supérieur)
Changer : moon workspace use <numéro | nom | id>The list (in French in the terminal) marks with ✦ the workspaces whose plan includes Moon CLI (Étoile or higher), and with ● the one Moon CLI is using.
moon workspace use 2
moon workspace use StudioYou can point to the workspace by its number in the list, its name or its ID; the start of the name or ID is enough if it is unique. If the chosen workspace does not include Moon CLI, Moon CLI warns you: its requests will be refused.
In the agent, /workspace (or /ws) does the same without leaving the session.
Who can use Moon CLILink to the Who can use Moon CLI section
Moon CLI is included from the Étoile plan up: Étoile, Constellation, Galaxie and Univers. Lune and the Free plan do not include it. The plan that counts is the one of the session’s workspace. See the plans.
Status shown by moon whoami or moon | Meaning | What to do |
|---|---|---|
| “✦ accès Moon CLI actif” (Moon CLI access active) | The workspace’s plan includes Moon CLI. | Nothing. |
| “forfait Étoile ou supérieur requis” (Étoile plan or higher required) | The plan does not include it. | Choose another workspace, or change plans at chat.realmoon.ai/billing. |
| “paiement de l’abonnement en échec” (subscription payment failed) | Moon CLI is suspended until the payment is settled. | Update the payment method. |
| “abonnement terminé” (subscription ended) | The workspace’s subscription has ended. | Renew it, or choose another workspace. |
| “aucun workspace” (no workspace) | No workspace is linked to the session. | moon . |
A subscription that is scheduled to cancel keeps access until the end of the paid period.
In a managed organization, access follows the plan of your license, and the organization can turn Moon CLI off for its members: the agent then shows “Erreur Moon AI : Désactivé par votre organisation.” (Moon AI error: disabled by your organization) with each message. See Licenses and Rules.
If you leave the session’s workspace, Moon CLI tells you: choose another one with /workspace or moon .
Choosing a modelLink to the Choosing a model section
In the agent, /models opens the list of your workspace’s models that work with Moon CLI, under their Moon AI catalog names. Image models, agents and models reserved for a plan you do not have are not listed. The chosen model applies to the current session: at the next launch, Moon CLI goes back to Auto.
Each model has a cost level:
| Level | Meaning |
|---|---|
| “Économique” (economical) | The least costly for your limit. |
| “Standard” | Average cost. |
| “Haut de gamme” (high-end) | High cost. |
| “Très gourmand” (very costly) | A single message can use a large share of your limit. |
Moon CLI never shows prices: only levels and percentages of your limit.
Before the first message on a very costly model, Moon CLI shows, for example, “Ce modèle est très gourmand : un message peut utiliser environ 12 % de votre limite de session.” (this model is very costly: one message can use about 12% of your session limit) and offers:
| Choice | Effect |
|---|---|
| “Continuer” (continue) | Sends the message. |
| “Choisir un autre modèle” (choose another model) | Opens the list of models. |
| “Ne plus demander pour ce modèle” (don’t ask again for this model) | Sends the message and no longer asks about this model. |
From the terminalLink to the From the terminal section
moon models lists the IDs you can use; -m uses one at launch:
moon models
moon -m moonai/anthropic/claude-haiku-4.5
moon run -m moonai/auto "explain the src folder"For a default model in a project, see Default model.
Auto modeLink to the Auto mode section
“Auto · choix selon la tâche” (Auto, chosen by task) is the default model. For each task, it only looks at what you wrote:
- a simple question (explain, search, list) goes to an economical model;
- work on code (fix, write, refactor) or a large context goes to a model suited to code, with the right balance between quality and cost;
- it never picks a very costly model;
- it keeps the same model for the whole task, to benefit from request caching.
To pin a model, choose it in /models, or run moon .
What Moon CLI does to limit consumptionLink to the What Moon CLI does to limit consumption section
- Titles, summaries, compactions and code exploration go through a small economical model, whatever the main model.
- The conversation is compacted automatically when it nears the maximum context size (80%).
/compactdoes it on demand. - A model that cannot use the agent’s tools is flagged with “Ce modèle ne sait pas utiliser les outils de l’agent (fichiers, commandes). Choisissez-en un autre (/models).” (this model cannot use the agent’s tools, files and commands; choose another one with /models).
Your usage limitLink to the Your usage limit section
Moon CLI uses the usage limit of your seat in the session’s workspace, the same one as on the web in that workspace. It is counted over three windows: the 5-hour session, the week and the month. The windows are detailed in Usage limits.
| Where | What you see |
|---|---|
| At launch | A “Utilisation” (usage) bar with details for the 5-hour session, the week and the month. |
| Agent header | The gauge of your limit. |
| After each message | “Ce message :” (this message:) followed by the share of your limit it used. |
/usage (/quota, /limites) | The details by window, without leaving the agent. |
When a window is full, Moon CLI says so with the time it frees up, for example: “Limite d’utilisation de la session de 5 h atteinte. Elle se libère à 16 h 40. Choisissez un modèle plus économique (/models) ou passez à un forfait supérieur sur realmoon.ai.” (5-hour session usage limit reached; it frees up at 4:40 pm; choose a more economical model with /models or upgrade your plan on realmoon.ai).