143 docs
Guides

Repo config

Configure `.143/config.json` so 143 can prepare workspaces, validate changes, and run previews.

.143/config.json is the repository contract 143 reads before agent work. It tells 143 how to prepare a sandbox, which deterministic checks matter, and how to start a live preview.

Place it at the repo root:

your-repo/
  .143/
    config.json

Quickstart

If you only need setup and validation, start here:

{
  "dependencies": {
    "golangci-lint": "2.10.1"
  },
  "bootstrap": {
    "commands": ["npm ci"]
  },
  "validation": {
    "commands": ["npm run lint", "npm test"]
  }
}

If you also need a preview:

{
  "preview": {
    "name": "web",
    "primary": "web",
    "services": {
      "web": {
        "command": ["npm", "run", "dev"],
        "port": 3000,
        "ready": { "http_path": "/" }
      }
    },
    "credentials": { "mode": "none" },
    "network": { "mode": "managed" }
  },
  "bootstrap": {
    "commands": ["npm ci"]
  },
  "validation": {
    "commands": ["npm run lint"]
  }
}

Sections

dependenciesobject
Supported tools to install before bootstrap or validation commands run.
bootstrap.commandsstring[]
Deterministic setup commands, such as package installs.
validation.commandsstring[]
Extra deterministic checks 143 should run during validation.
previewobject
Preview service configuration for live app review inside a session.

Good defaults

  • Commit the file to the repo.
  • Keep commands deterministic.
  • Do not put secrets in the file.
  • Use preview secret bundles for secret env vars or generated config files.
  • Put exhaustive preview fields in Preview config reference instead of overloading this guide.

No secrets

Never commit API keys, database URLs, or tokens into .143/config.json.

On this page