Docs for AI agents

This site is built to be read by models as well as people. Use this page to point any agent (Claude, ChatGPT, Cursor, Codex, or your own) at the right resources so it can act on the platform without guessing.

Give an agent this site

Every page also has two buttons at the top right:

• Copy for AI copies the page as Markdown and appends the platform context block shown below, so the agent knows where the app, the CLI, and the rest of the docs live without a second lookup. Paste it into any chat.
• Open in opens the page in Claude, ChatGPT, or Cursor with a prompt that points at the Markdown endpoint, or copies just the page.

Install the agent plugin

For agents that work on your machine (Claude Code, Cursor, Codex), install the skills plugin. It bundles the acc reference and task skills: first-time setup, deploy a Docker app, deploy from a template, deploy a server, troubleshoot a deployment.

git clone https://github.com/alternatefutures/alternate-clouds-skills ~/.alternate-skills
bash ~/.alternate-skills/install.sh

The installer detects which agents you have and links each skill into place.

Let an agent run the CLI

acc works without a terminal prompt when it has a token and a project:

export AF_TOKEN="<personal access token>"   # acc pat create --name my-agent
export AF_PROJECT_ID="<project id>"         # acc projects list
acc whoami --json                           # pre-flight: exits non-zero when not signed in
acc services create --kind docker --image nginx:latest --port 80 -y

• Add -y to any command that would ask for confirmation.
• Use --json where a command offers it for machine-readable output.
• Without a TTY, commands that would prompt exit non-zero instead of hanging.
• Give each agent its own token so you can revoke it on its own. See Access tokens.
• acc <command> --help prints the options for any command. The full list is in the command reference.

Platform context block

This is the text Copy for AI appends to every page. Put it in a system prompt, a CLAUDE.md, or an AGENTS.md when you want an agent to know the platform before it reads anything else.

Alternate Clouds is the Alternate Futures cloud platform. It deploys containers, AI agents, GPU workloads, and confidential (TEE) services on decentralized infrastructure from the web app, the acc CLI, or the TypeScript SDK.

- Docs index for agents: https://docs.alternatefutures.ai/llms.txt
- Every page in one file: https://docs.alternatefutures.ai/llms-full.txt
- Any page as Markdown: https://docs.alternatefutures.ai/llms.mdx/<path>/content.md (CLI reference: https://docs.alternatefutures.ai/llms.mdx/cli/commands/content.md)
- Agent guide: https://docs.alternatefutures.ai/ai-agents
- Web app: https://clouds.alternatefutures.ai (sign in with email or an Ethereum wallet; 14-day trial, no card)
- CLI: npm install -g @alternatefutures/acc && acc login. Command groups: projects, services, deployments, regions, templates, ssh, cp, attest, chat, billing, pat. Any command accepts --help.
- Non-interactive use: export AF_TOKEN (from acc pat create) and AF_PROJECT_ID, add -y to skip prompts, run acc whoami --json as a pre-flight check.
- Agent skills plugin for Claude Code, Cursor, and Codex: https://github.com/alternatefutures/alternate-clouds-skills
- Pages in the Legacy section describe the retired af CLI. Those commands do not exist in acc.

What is not machine-operable yet

• Signing up and adding a payment method happen in the web app.
• Composite (multi-service) templates deploy from the web app only.
• Pages in the Archive section describe the retired af CLI. Agents should not run those commands.