Skip to main content

Aether CLI

aether is the user-facing CLI for working with remote AetherFS sessions from your own machine.

Use it when you want:

  • A local mount for a remote session.
  • Access through editors, shells, or local tools.
  • User-controlled cache, logging, and metrics settings.
  • Command-line diagnostics and operational commands.

What Aether CLI does​

Aether CLI connects to the hosted service and gives you a local workflow around sessions.

In practice, that means you can:

  • Point Aether CLI at your service endpoint.
  • Mount a session locally.
  • Use local tools against the mounted tree.
  • Inspect metrics, logs, and runtime state.
  • Control cache and client behavior through config and environment variables.
  1. Start with Quickstart.
  2. Read FAQ if you are still deciding where Aether CLI fits versus the HTTP API.
  3. Read Authentication and connectivity.
  4. Read Configuration.
  5. Read Mounts, Workflows, and Operations for users as needed.
  6. Use Troubleshooting for first-line diagnosis and Validation and runbooks for deeper escalation.

Support path​

Use the support pages in this order:

  1. FAQ for workflow-boundary questions such as "Aether CLI vs API" or "why status is not enough".
  2. Troubleshooting for first-line diagnosis and the standard support bundle.
  3. Operations for users when you already know you need logs, metrics, cache, or advanced client command families.
  4. Validation and runbooks when the basic path is no longer enough and you need deeper failure-mode guidance.

Command families​

The CLI includes command families for mounting, status, diagnostics, logs, metrics, cache, journal, and other client operations.

For the generated command reference, see Command reference.

For the sharper operational path between quickstart and the deeper repo docs, see Validation and runbooks.

If you are trying to answer "is this even the right surface for my workflow?", start with FAQ before diving into the command reference.