Custom Tools

Every project has its own scripts — deploy, database migrations, health checks. They live in shell scripts that only you know how to run.

Define a tool in YAML. 8Vast makes it available everywhere — your terminal, the AI agent, your editor, your team.

Create a tool

8v action create deploy

This creates .8v/actions/deploy.yaml. Edit it:

name: deploy
description: Deploy to staging
inputs:
  env:
    type: string
    default: staging
run:
  command: |
    ./scripts/deploy.sh --env {{ env }}

Run it

8v action run deploy
8v action run deploy --set env=production

Available everywhere

Once defined, the tool is available to:

Terminal — 8v action run deploy
AI agent — the AI sees the tool and can run it
Editors — Cursor, Windsurf, Zed expose it through their AI

One definition. Every surface. No extra wiring.

List tools

8v action list

Where tools live

.8v/actions/ in your project. Plain YAML files. Commit them to git — your team gets the same tools.

Workflows — Give AI instructions, not just tools
Scheduled Workflows — Run tasks on a timer

Referenced by

Editors