Adios
Guidesadios.yaml

Manifest guide

One manifest from AI-assisted source to live app.

`adios.yaml` keeps the deploy contract beside the code: build, start, port, health, secrets, resources, replicas, and routes. That makes generated changes easier to review before they reach production.

Open ConsoleManifest Reference
adios.yaml
name: billing-api
region: de
replicas: 2

build_cmd: pnpm install && pnpm build
start_cmd: pnpm start

runtime:
  name: node@24
  port: 3000
  health_path: /api/health

requires:
  - db

secrets:
  DATABASE_URL: secret://DATABASE_URL
  API_SIGNING_KEY: secret://API_SIGNING_KEY

Deploy contract

Review the manifest like production code.

Application code and deploy configuration change together. A small manifest keeps the operational parts visible in source review instead of scattering them across a chat transcript, dashboard, and shell history.

FieldWhat to check
nameStable app name used by Adios for the workload.
build_cmdCommand that prepares production assets from a clean checkout.
start_cmdCommand that starts the production process.
runtime.portPort the app listens on inside the runtime.
runtime.health_pathHTTP path Adios can use to test readiness.
secretsSecret references such as secret://DATABASE_URL.
requiresManaged services the app depends on, such as db or cache.

Workflow

Use the manifest to keep AI output deployable.

When an AI agent adds an API route, background worker, database call, or external provider, ask it to update the manifest only when the runtime contract changes. Then verify the command and config instead of trusting the generated file blindly.

Build from a clean tree

The build command should work without editor state, local caches, or undeclared tools.

Start the production server

The start command should run the server process that will receive real traffic.

Probe readiness

The health path should fail when required request-path dependencies are unavailable.

Choose a deployment path

Review framework, runtime, service, and workflow requirements before writing the manifest.

Manifest reference

Read the complete field reference for app and workflow manifests.

Quickstart

Deploy an existing app from your terminal with the user CLI.

Deploy AI-generated code

Connect generated source changes to previews, logs, and production.