Configuration

Your hub configuration is the single source of truth for your multi-repo workspace. It declares everything — repositories, tools, services, environments, MCPs, integrations, and the development workflow.

Repo Hub supports two config formats:

The CLI auto-detects which file exists (TypeScript takes priority). Both formats support the same schema.

TypeScript Config (hub.config.ts)

Wrap your config in defineConfig for full type checking and autocompletion:

import { defineConfig, repo, mcp, service } from "@arvoretech/hub/config";

export default defineConfig({
  name: "my-company",

  repos: [
    repo.nestjs("api", "git@github.com:company/api.git"),
    repo.nextjs("frontend", "git@github.com:company/frontend.git"),
    repo.elixir("backend", "git@github.com:company/backend.git"),
  ],

  mcps: [
    mcp.postgresql("main-db"),
    mcp.datadog(),
    mcp.playwright(),
  ],

  services: [
    service.postgres("db"),
    service.redis("cache"),
  ],

  workflow: {
    pipeline: [
      { step: "refinement", agent: "refinement" },
      { step: "coding", agents: ["coding-backend", "coding-frontend"] },
      { step: "review", agent: "code-reviewer" },
      { step: "deliver", actions: ["create-pr", "notify-slack"] },
    ],
  },
});

Available helpers

Repo helpers: repo.nestjs(), repo.nextjs(), repo.react(), repo.elixir(), repo.go(), repo.python(), repo.custom()

MCP helpers: mcp.postgresql(), mcp.mysql(), mcp.clickhouse(), mcp.datadog(), mcp.memory(), mcp.sendgrid(), mcp.launchdarkly(), mcp.tempmail(), mcp.awsSecretsManager(), mcp.npmRegistry(), mcp.runtimeLens(), mcp.meetTranscriptions(), mcp.googleChat(), mcp.playwright(), mcp.context7(), mcp.proxy(), mcp.custom()

Service helpers: service.mysql(), service.postgres(), service.redis(), service.mongo(), service.rabbitmq(), service.elasticsearch(), service.clickhouse(), service.custom()

Each helper sets sensible defaults (commands, packages, ports, images) that you can override.

YAML Config (hub.yaml)

Editor Support (Autocomplete & Validation)

Repo Hub provides a JSON Schema for hub.yaml that enables autocomplete, inline validation, hover documentation, and error highlighting in any editor with YAML language server support.

When you run hub init and choose YAML, the generated hub.yaml includes a schema comment at the top:

# yaml-language-server: $schema=https://raw.githubusercontent.com/arvoreeducacao/rhm/main/schemas/hub.schema.json
name: my-company
# ...

This single line gives you:

• Autocomplete for all keys and enum values (tech stacks, MCP packages, pipeline steps, actions)
• Validation with real-time errors in the Problems panel
• Hover documentation describing every field
• Required field checking (name and repos are required)

Prerequisites

Adding to an existing hub.yaml

If you created your hub.yaml before this feature, just add the comment to the first line:

# yaml-language-server: $schema=https://raw.githubusercontent.com/arvoreeducacao/rhm/main/schemas/hub.schema.json

That’s it. No extension to install, no config to change.

Full Example

name: my-company

tools:
  node: "22.18.0"
  pnpm: "10.26.0"

repos:
  - name: api
    path: ./api
    url: git@github.com:company/api.git
    tech: nestjs
    env_file: .env
    commands:
      install: pnpm install
      dev: pnpm dev
      build: pnpm build
    skills: [backend-nestjs]

  - name: backend
    path: ./backend
    url: git@github.com:company/backend.git
    tech: elixir
    display_name: "Backend (Phoenix)"
    tools:
      erlang: "27.3.3"
      elixir: "1.18.3-otp-27"

  - name: frontend
    path: ./frontend
    url: git@github.com:company/frontend.git
    tech: nextjs
    env_file: .env.local
    skills: [frontend-nextjs]

services:
  - name: postgres
    image: postgres:16
    port: 5432
  - name: redis
    image: redis:7-alpine
    port: 6379

env:
  profiles:
    local:
      description: "Local environment - Docker services"
    staging:
      aws_profile: my-company-stg
      secrets:
        api: api-staging-secret
    prod:
      aws_profile: my-company-prd
      secrets:
        api: api-prod-secret
  overrides:
    local:
      api:
        DATABASE_URL: "postgres://localhost:5432/mydb"

mcps:
  - name: postgresql
    package: "@arvoretech/postgresql-mcp"
  - name: playwright
    package: "@playwright/mcp"

integrations:
  github:
    pr_branch_pattern: "{linear_id}-{slug}"
    pr_tool: cli
  slack:
    channels:
      prs: "#eng-prs"

hooks:
  pre_tool_use:
    - type: command
      command: "./hooks/block-dangerous.sh"
      matcher: "rm -rf|drop table"
  after_file_edit:
    - type: command
      command: "./hooks/format.sh"
  session_start:
    - type: command
      command: "./hooks/init.sh"

commands:
  review: ./commands/review.md
  deploy: ./commands/deploy.md

workflow:
  prompt:
    prepend: |
      Always respond in Portuguese.
    sections:
      after_repositories: |
        The API uses a custom auth middleware. See api/docs/auth.md.
  pipeline:
    - step: refinement
      agent: refinement
    - step: coding
      agents: [coding-backend, coding-frontend]
      parallel: true
    - step: review
      agent: code-reviewer
    - step: deliver
      actions: [create-pr, notify-slack]

Schema Sections

Each section of hub.yaml has its own documentation page with full schema reference, examples, and CLI commands:

Top-Level Fields

For the full CLI command reference, see CLI Reference.