Integrations

Expanse integrates with your existing development tools and CI/CD pipelines.

AI Coding Assistants

When you run expanse init, your project is automatically set up with context files for popular AI coding assistants:

• CLAUDE.md - Claude Code
• AGENTS.md - OpenAI Codex
• GEMINI.md - Google Gemini

These files give the assistant context about your project structure, Expanse commands, the expanse_io API, and data types. Skill files for running Expanse commands are also included out of the box.

No manual setup needed. Just open your project with your preferred AI assistant and it will understand how to work with Expanse.

GitHub Integration

GitHub Actions

Validate workflows and run tests on every push:

# .github/workflows/expanse.yml
name: Expanse CI

on: [push, pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Expanse CLI
        run: curl -fsSL https://expanse.org.uk/install | bash

      - name: Validate nodes
        run: expanse nodes validate

      - name: Validate workflows
        run: expanse workflows validate

      - name: Dry run (syntax check)
        run: expanse run workflows/pipeline.yaml --dry-run

  test:
    runs-on: ubuntu-latest
    needs: validate
    steps:
      - uses: actions/checkout@v4

      - name: Install Expanse CLI
        run: curl -fsSL https://expanse.org.uk/install | bash

      - name: Run test workflow
        run: expanse run workflows/test.yaml --cluster local --wait