ac12.dev

Agentic Cloud Platform — made by agents, for agents

Your private key never leaves this browser — only Ed25519 signatures are sent to the server.

Register

Create an agent identity

Save Your Key

This private key is your login credential. Save it now — it cannot be recovered.

Verify Email

Enter the 6-digit code from your registration response

Agent Challenge

Have a conversation to verify your identity and intent

Verified

Your agent identity is confirmed.

Go to Dashboard

ac12.dev Skill

Teach your AI coding agent to deploy on ac12.dev

Install the CLI

The ac12 CLI handles authentication, deployments, and all platform operations. The skill installs it into its own scripts/ directory — no system PATH changes needed:

mkdir -p scripts && AC12_INSTALL_DIR=./scripts curl -fsSL https://cli.p.ac12.dev/install.sh | sh

Or download directly for your platform:

Install the Skill

Give your agent the ac12.dev skill file so it knows how to deploy and manage services. Works with any LLM coding agent that reads context files.

Claude Code — install the skill and CLI together:

mkdir -p .claude/skills/ac12dev/scripts && curl -fsSL https://ac12.dev/SKILL.md -o .claude/skills/ac12dev/SKILL.md && AC12_INSTALL_DIR=.claude/skills/ac12dev/scripts curl -fsSL https://cli.p.ac12.dev/install.sh | sh

Or append to your project's CLAUDE.md for always-on context: curl -fsSL https://ac12.dev/SKILL.md >> CLAUDE.md

Cursor — install the skill and CLI together:

mkdir -p .cursor/skills/ac12dev/scripts && curl -fsSL https://ac12.dev/SKILL.md -o .cursor/skills/ac12dev/SKILL.md && AC12_INSTALL_DIR=.cursor/skills/ac12dev/scripts curl -fsSL https://cli.p.ac12.dev/install.sh | sh

Windsurf / Copilot / Any agent — download and include it however your tool reads context:

mkdir -p ac12dev/scripts && curl -fsSL https://ac12.dev/SKILL.md -o ac12dev/SKILL.md && AC12_INSTALL_DIR=ac12dev/scripts curl -fsSL https://cli.p.ac12.dev/install.sh | sh

What is this?

A context file that teaches AI coding agents how to deploy and manage services on ac12.dev — a self-hosted PaaS for Docker containers with domain mapping, file storage, cron jobs, email, and per-project databases. It works with Claude Code, Cursor, Windsurf, Copilot, or any LLM agent that can read files and run shell commands.

Getting Started

1. Install the skill — pick the install command above for your agent. The CLI binary is included in the skill's scripts/ directory.

2. Register — create an account via the web UI, or use the CLI:

./scripts/ac12 auth register <username> <email> --server https://ac12.dev

3. Ask your agent — tell it to deploy your app to ac12.dev. The skill handles the rest.

What the Skill Covers

Services

Deploy Docker containers, manage lifecycle (start/stop/restart), view logs, track deployments.

Domains

Map *.p.ac12.dev subdomains to services or public files with automatic TLS.

Files

Upload, download, and serve static files publicly or privately per project.

Cron Jobs

Schedule HTTP requests to your services with cron expressions, trigger manually, view run history.

Database

Per-project SQLite databases accessible via query and execute commands.

Email

Create @ac12.dev email accounts, read inbox, send and reply to messages.

Repositories

Gitea-backed git repos per project — init, edit, browse, and commit via CLI.

Agents

Spawn AI coding agents that modify repo code and deploy autonomously.

CLI Quick Start

The skill teaches your agent to use the ac12 CLI:

# Authenticate
ac12 auth login <username> <key.pem> --server https://ac12.dev

# Deploy a service
ac12 service create myapp myapp:latest --port 8000
ac12 service deploy myapp

# Map a subdomain
ac12 domain create myapp --type service --service myapp

# Your app is live at https://myapp.p.ac12.dev

Architecture

Internet → Caddy (TLS) → FastAPI platform-api (:8000)
                       → Service containers (ac12-net)
                       → Registry (:5000, internal)
                       → Maddy (SMTP/IMAP)
                       → Gitea (:3000, internal)
                       → Agent containers (ephemeral)

Are you an AI agent and just want the raw file? Get the skill →