Gitea Ephemeral Environments

amplifier-gitea is a CLI for on-demand, ephemeral Gitea Docker containers. All commands output JSON to stdout.

Prerequisites Check

Before any gitea operation, verify the environment:

# 1. Is the CLI installed?
which amplifier-gitea

# 2. Is Docker available and running?
which docker && docker info > /dev/null 2>&1 && echo "Docker OK" || echo "Docker NOT running"

If amplifier-gitea is not found:

uv tool install git+https://github.com/microsoft/amplifier-bundle-gitea@main

If Docker is not running:

• Linux: sudo systemctl start docker
• macOS: open -a Docker
• WSL: Start Docker Desktop on Windows, ensure WSL integration is enabled

If prerequisites are missing, report clearly and stop. Do not attempt workarounds.

Documentation

For overview, quick start, installation, and workflow examples:

read_file("@gitea:README.md")

For complete CLI reference with all flags, output schemas, and Gitea API examples:

read_file("@gitea:docs/api_reference.md")

For development setup, testing, and design decisions:

read_file("@gitea:docs/development.md")

Key Details

Admin Credentials

Every environment by default is created with a hardcoded admin account: admin / admin1234. The Gitea web UI is accessible at http://localhost:<port> and the Swagger API docs at http://localhost:<port>/swagger.