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
From install to your first session.
Set up the server and client, connect them, and launch an agent.
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.