Documentation/

Configuration

Project settings live in .8v/config.yaml at your project root.

Default configuration

lint:
  on_build: true       # run lint before 8v build
  on_commit: true      # pre-commit hook lints staged files
  block_on: error      # error blocks, warning passes through

What each setting does

lint.on_build — when true, 8v build runs lint first. If lint fails, the build doesn't start.

lint.on_commit — when true, the pre-commit hook runs 8v lint --staged before every commit.

lint.block_on — what severity blocks the operation:

  • error — only errors block (default)
  • warning — errors and warnings block
  • never — lint runs but never blocks

File layout

your-project/
  .8v/
    config.yaml         # project settings
    actions/            # custom tools
    workflows/          # AI task definitions
    chains/             # workflow sequences
    hooks/              # git hooks

All files in .8v/ are plain text. Commit them to version control.

Next