AetherFS documentation

This site documents the user-facing parts of AetherFS.

It focuses on four things:

• What the system does.
• The public HTTP API surface.
• The public gRPC API surface.
• The Aether CLI for local mounts and client-side workflows.

Start here

Learn the product

Read the system section if you want the product model first:

• System overview
• Core concepts
• Session lifecycle

Use the CLI

Read the Aether CLI section if you want to mount and use sessions locally:

• Aether CLI
• Quickstart
• Configuration
• FAQ
• Operations for users
• Troubleshooting
• Validation and runbooks

Integrate over HTTP

Read the API section if you are building an integration:

• HTTP API overview
• API conventions
• OpenAPI contracts

Integrate over gRPC

Read the gRPC section if you want generated clients, long-lived streams, or binary-heavy flows:

• gRPC API overview
• Auth and transport
• Common workflows
• grpcurl examples

If You Get Stuck

Use the shortest path that matches the problem:

• FAQ for workflow-boundary questions such as "Aether CLI vs API" or "why status is not enough"
• Troubleshooting for first-line diagnosis and support capture
• Validation and runbooks when quickstart is no longer enough and you need deeper escalation guidance