> ## Documentation Index
> Fetch the complete documentation index at: https://www.ravion.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Start here (human + agent)

> Set up Ravion for an AI agent: connect human-owned accounts and point the agent to the authoritative config, pipeline, and CI workflows.

## Human setup

Complete these steps before asking an agent to create or change infrastructure.

<Steps>
  <Step title="Connect your AWS account">
    Open [AWS accounts](https://app.ravion.com/org/settings/aws-accounts?connect=%7B%7D) and connect the AWS account where Ravion should provision infrastructure.
  </Step>

  <Step title="Connect your Git repository">
    Open [Git connections](https://app.ravion.com/org/settings/git-connections?modal=addConnection) and connect the Git repository(s) Ravion should use for app or Terraform source code.

    Can be skipped if you just want Ravion to deploy images from an image registry.
  </Step>

  <Step title="Install the Docs MCP server">
    ```bash theme={null}
    npx add-mcp https://www.ravion.com/docs/mcp
    ```

    The Docs MCP server lets agents search and read current Ravion documentation from their context window. See [Ravion Docs MCP](/mcp/overview).
  </Step>

  <Step title="Install the CLI and sign in">
    On macOS, install the Ravion CLI with Homebrew:

    ```bash theme={null}
    brew install flightcontrolhq/tap/ravion
    ```

    Or install it with the install script:

    ```bash theme={null}
    curl -fsSL https://github.com/flightcontrolhq/cli/releases/latest/download/install.sh | sh
    ```

    Then sign in:

    ```bash theme={null}
    ravion login
    # If you belong to more than one organization, select the active organization:
    ravion switch
    ```

    See [Install the Ravion CLI](/cli/installation) and [Authentication](/cli/authentication).
  </Step>
</Steps>

## Agent workflow

After the human setup is complete, give the agent this checklist.

<Steps>
  <Step title="Read the core concepts page">
    Read [Core concepts](/concepts/core-concepts) (through the Docs MCP server or directly) before making changes to understand how modules, stacks, deploys, and pipelines relate.
  </Step>

  <Step title="Use the project config file flow to create and manage modules">
    Use project config to set up or change things in Ravion, including environments, module instances, and references between modules.

    Follow the required workflow in [Project config file](/config-as-code/project-config-file#agent-tips). Check schemas before editing, preserve existing IDs and versions, preview every change with a dry run, and apply only after the dry run is correct and approved.
  </Step>

  <Step title="Set up build and deploy pipelines using pipeline config file">
    After modules are created, use pipeline config to define build and deploy pipelines for modules that are deployable.

    Follow [Pipeline config file](/config-as-code/pipeline-config-file). Pull the live config, edit the file, and apply through the documented config file flow.
  </Step>

  <Step title="Set up CI for applying config changes">
    Configure CI to plan Ravion configuration changes on every pull request and apply them after merge.

    Follow [CI integration](/config-as-code/ci-integration). Use a service-account API key, store it as `RAVION_API_KEY`, and keep project and pipeline resource IDs in the workflow configuration.
  </Step>
</Steps>

## Useful references

<CardGroup cols={2}>
  <Card title="Project config file" icon="file-code" href="/config-as-code/project-config-file">
    Define environments and module instances from one file.
  </Card>

  <Card title="Pipeline config file" icon="arrow-progress" href="/config-as-code/pipeline-config-file">
    Define build, deploy, trigger, and approval workflows.
  </Card>

  <Card title="Module catalog" icon="boxes-stacked" href="/module-definitions/catalog">
    Understand module definitions, versions, inputs, and config.
  </Card>

  <Card title="CLI reference" icon="terminal" href="/cli/overview">
    Browse every Ravion CLI command.
  </Card>
</CardGroup>