Skip to the content
docs

Your server.
The field guide.

Installation, runtime behavior and technical reference. These guides are a snapshot of the product repo's docs folder.

Browse guides
start here

From install to your first session.

Set up the server and client, connect them, and launch an agent.

Open quickstart

Get running

  • Quickstart

    Install Cloudfield on a Linux server with Docker and git, link your computer, add a repository, set up an agent, launch a session, review it and publish it.

  • Coding agents

    A guide a coding agent follows in a shell: install Cloudfield, set up the server over ssh, then launch and follow sessions through the aether CLI.

  • Install

    How to install aether-server on Linux and the aether CLI on Linux, macOS or Windows, add the desktop or Android app, pick a release channel and upgrade.

  • Networking

    How clients reach the server's one SSH port, directly, over a Tailscale tailnet or through an edge relay, and how each route decides the way people sign in.

  • Teams

    Inviting teammates to a shared Cloudfield server: roles from viewer to super admin, workspace access, working together, agent accounts, budgets and subsessions.

  • Environments

    Each member's environment on the server: installing tools for your agents, saving your image, resetting it, and the limits on what a session can use.

  • Terminals

    Your persistent environment shell, the agent's own terminal in a Standard session with Take control to hand it over, extra session shells, and SSH into a session.

  • Environment home

    The home directory on the server that is mounted into your environment and every session you launch, and what it keeps: agent installs, logins and configuration.

Runtime

  • Agents

    The agent CLIs Cloudfield can launch, like Claude Code, Codex and more: how you install each in your environment, sign in to it, and what does not work.

  • Enhanced sessions

    Enhanced sessions drive the agent over the Agent Client Protocol, so its messages, tool calls, diffs and permission prompts appear as native controls in the app.

  • Connectors

    Add your Cloudfield server to ChatGPT or Claude as a connector, then launch sessions, see what needs you, answer agents and check pull requests from a chat.

  • Team memory

    A shared list of short notes about a workspace, such as decisions, conventions and gotchas, that every session can search and add to, whatever agent it uses.

  • Watches

    A watch is a subscription on one session or pull request. The server evaluates it and notifies you when it needs you or finishes, with the dashboard closed.

  • Slack

    A Slack bot inside the server that sends you a direct message when a session needs you and lets you answer from Slack, with no edge and no public URL.

  • Dictation

    Speak a task or a message instead of typing it. The dashboard records a clip and your own server turns it into text, so no audio goes to a third party.

  • Adapters

    How to add a new agent CLI to Cloudfield as an agent profile, and optionally turn its machine-readable output into typed events with an adapter.

  • Security

    What Cloudfield isolates and what it leaves exposed: the sandbox each session runs in, the permission tiers, credentials, and who can see or act on what.

  • Local gateway

    How the dashboard reaches your server through aether gui on your machine or aether-server --web-port on its tailnet, and how they differ.

  • Dashboard SPA

    How the Cloudfield dashboard is built and what each view does: launching, watching, messaging and reviewing sessions, and the pages for agents, files and settings.

  • Assistant

    The dashboard's assistant: your own Claude Code or Codex in Enhanced mode, which reports on sessions and launches or messages them, asking first by default.

  • Insights

    What your agents did over the last 7 days: sessions that finished, how many ended in a merged pull request, time, tokens and cost, computed on your own server.

Reference

  • Coordination

    How the conflict radar finds sessions that edit the same files, how sessions in one workspace message each other, and the commands an agent uses for subsessions.

  • Troubleshooting

    What Cloudfield does when the host reboots, a disk fills, an agent hangs or a connection drops, what you do next, and the server settings that tune it.

  • MCP bridge

    The in-container MCP server with coordination and team memory tools, registered automatically for Enhanced sessions, beside the aether-internal CLI every session gets.

  • Testing

    Which tests to run for a change to Cloudfield, how to run each suite, what each one needs, and how to read a failure when a suite does not pass.

  • Privacy policy

    The privacy policy for the Cloudfield Android app, the dashboard it shows and the project's edge: what each stores, what leaves your phone and how to delete it.

  • Contributing

    How to build Cloudfield from source, run your build beside an installed release, test it, put it on a test server and get a change merged.