# ac12.dev

> A self-hosted PaaS for AI coding agents to deploy Docker containers with domain mapping, file storage, cron jobs, email, databases, git repositories, and AI agent orchestration.

## Docs

- [Skill File](https://ac12.dev/SKILL.md): Complete guide for AI agents — registration, CLI installation, all commands, and platform features
- [API Reference](https://ac12.dev/docs): OpenAPI/Swagger documentation for every endpoint
- [Agent Discovery](https://ac12.dev/.well-known/agent.json): Machine-readable agent card (capabilities, auth, endpoints)

## Getting Started

- [Install CLI](https://cli.p.ac12.dev/install.sh): One-line install script — `curl -fsSL https://cli.p.ac12.dev/install.sh | sh`
- [Register via CLI](https://ac12.dev/SKILL.md): `ac12 auth register <username> <email> --server https://ac12.dev`
- [Register via Web](https://ac12.dev/): Browser-based registration with Ed25519 key generation

## CLI Downloads

- [macOS ARM64](https://cli.p.ac12.dev/ac12dev-darwin-arm64): Apple Silicon binary
- [macOS AMD64](https://cli.p.ac12.dev/ac12dev-darwin-amd64): Intel Mac binary
- [Linux AMD64](https://cli.p.ac12.dev/ac12dev-linux-amd64): Linux x86_64 binary

## Platform Features

- [Services](https://ac12.dev/SKILL.md): Deploy Docker containers, start/stop/restart, view logs, deployment history
- [Domains](https://ac12.dev/SKILL.md): Map `*.p.ac12.dev` subdomains to services or public files with automatic TLS
- [Files](https://ac12.dev/SKILL.md): Upload and serve static files publicly or privately per project
- [Cron Jobs](https://ac12.dev/SKILL.md): Schedule HTTP requests to services with cron expressions
- [Database](https://ac12.dev/SKILL.md): Per-project SQLite databases with query and execute
- [Email](https://ac12.dev/SKILL.md): `@ac12.dev` email accounts — inbox, send, reply
- [Repositories](https://ac12.dev/SKILL.md): Gitea-backed git repos per project
- [Agents](https://ac12.dev/SKILL.md): AI coding agents that modify repo code and deploy autonomously

## Agent Skill Installation

- [Claude Code](https://ac12.dev/SKILL.md): `mkdir -p .claude/skills/ac12dev && curl -fsSL https://ac12.dev/SKILL.md -o .claude/skills/ac12dev/SKILL.md`
- [Cursor](https://ac12.dev/SKILL.md): `mkdir -p .cursor/skills/ac12dev && curl -fsSL https://ac12.dev/SKILL.md -o .cursor/skills/ac12dev/SKILL.md`

## Optional

- [Skill Page](https://ac12.dev/#skill): Web UI with installation instructions and platform overview
- [Architecture](https://ac12.dev/SKILL.md): Platform architecture — Caddy, FastAPI, Docker, Gitea, Maddy