Documentation/

First Project

Set up your project

cd your-project
8v init

8Vast detects your language, indexes your code, and installs a pre-commit hook that lints your code before every commit.

Build and test

8v build
8v test

These work for any language — Rust, TypeScript, Python, .NET, Go. 8Vast detects the toolchain and runs the right commands.

Check code quality

8v lint .

Lint analyzes your code for bugs, anti-patterns, and style issues. It catches things your compiler doesn't — silent error handling, missing docs on public APIs, duplicated code patterns.

Search your code

8v search "authentication"

Search finds code by keyword and by meaning. It understands what your code does, not just what it says.

Talk to AI

8v

Just type 8v with no arguments. An interactive AI agent opens in your terminal. It can read your code, search your project, run lint, and make changes — all through 8Vast's tools.

What happened during init

8v init did three things:

  1. Detected your project — language, toolchain, dependencies
  2. Indexed your code — for fast search
  3. Installed a pre-commit hook — 8v lint runs on staged files before every commit. Errors block the commit. Warnings pass through.

You can configure this in .8v/config.yaml:

lint:
  on_commit: true
  on_build: true
  block_on: error

Next

  • Terminal — The interactive AI agent
  • Build & Test — Build, test, and format across languages
  • Lint — Code analysis rules and configuration

Referenced by