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"]
  }
}

Private npm dependencies

Use setup.npm for platform-controlled installation of private npm dependencies before repository bootstrap. Built-in code reviews skip npm installation by default. Set review.install_npm_dependencies to true to use the same npm setup during review preparation. Save the read-only registry token in Settings → Package registries, then declare each directory containing a manifest and lockfile. See Private npm packages for workspace examples, lifecycle scripts, and credential boundaries.

Sections

dependenciesobject
Supported tools to install before bootstrap or validation commands run.
setup.npmobject[]
Npm project directories for controlled dependency installation before repository commands.
review.install_npm_dependenciesboolean
Install the projects declared in setup.npm during built-in code review preparation. Defaults to false.
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 and safe to rerun.
  • 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