> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Glossary

> Plain-English definitions of every vly term — agent, plan mode, prompt, revision, workspace, project, deployment, and more.

A reference for the terms you'll encounter throughout the docs. Skim once; come back when something's unclear.

## A

<AccordionGroup>
  <Accordion title="Action (Convex action)" icon="zap">
    A Convex function that can call third-party APIs and use `process.env`. Use for sending email, calling OpenAI, charging Stripe — anything that touches the outside world. See [Convex actions](/convex/actions).
  </Accordion>

  <Accordion title="Agent" icon="bot">
    The AI coding model that writes your code. vly supports three: Claude Code, OpenAI Codex, and Gemini CLI. See [Choosing an agent](/features/agents/choosing-an-agent).
  </Accordion>

  <Accordion title="Agent mode" icon="bot">
    The default workflow in vly: you prompt; the agent decides what to change and writes code in one step. See [Agent mode](/building/agent-mode).
  </Accordion>
</AccordionGroup>

## B

<AccordionGroup>
  <Accordion title="Branch" icon="git-branch">
    An isolated copy of your project where you can experiment without affecting the main version. Branches sync to GitHub if connected. See [Branching](/building/branching).
  </Accordion>
</AccordionGroup>

## C

<AccordionGroup>
  <Accordion title="Code mode" icon="code">
    Hand-edit code directly in the editor; no prompt needed. The escape hatch for tiny tweaks. See [Code mode](/building/code-mode).
  </Accordion>

  <Accordion title="Convex" icon="database">
    The backend platform every vly app runs on. Real-time database with serverless functions. See [Convex overview](/convex/overview).
  </Accordion>

  <Accordion title="Credits" icon="coins">
    The unit vly meters agent runs in. See [Credits](/features/billing/credits).
  </Accordion>

  <Accordion title="Custom instructions" icon="settings-2">
    Always-on rules the agent follows across every prompt — coding style, brand voice, etc. See [Custom instructions](/building/custom-instructions).
  </Accordion>
</AccordionGroup>

## D

<AccordionGroup>
  <Accordion title="Deployment" icon="rocket">
    A built version of your project running on a public URL. Preview deployments happen on every change; production is promoted manually.
  </Accordion>
</AccordionGroup>

## E

<AccordionGroup>
  <Accordion title="Environment" icon="layers">
    A separate copy of your app with its own secrets and URL. By default: Preview and Production. You can add Staging or others.
  </Accordion>
</AccordionGroup>

## I

<AccordionGroup>
  <Accordion title="Integration" icon="puzzle">
    A first-class connection to a third-party service (Stripe, Resend, OpenAI, etc.) with managed credentials and tested code patterns. See [Integrations overview](/integrations/overview).
  </Accordion>
</AccordionGroup>

## K

<AccordionGroup>
  <Accordion title="Knowledge base" icon="book">
    Project-specific reference material the agent reads on every prompt. Useful for design system docs, brand voice, schema patterns. See [Knowledge base](/building/knowledge-base).
  </Accordion>
</AccordionGroup>

## M

<AccordionGroup>
  <Accordion title="Mutation (Convex mutation)" icon="pencil">
    A Convex function that writes data, transactionally. Cannot call third-party APIs. See [Convex mutations](/convex/mutations).
  </Accordion>
</AccordionGroup>

## P

<AccordionGroup>
  <Accordion title="Plan mode" icon="workflow">
    Agent mode with a deliberate review step — the agent shows you a plan before writing code. See [Plan mode](/building/plan-mode).
  </Accordion>

  <Accordion title="Project" icon="folder">
    A single vly app. Has its own schema, code, deployments, and (optionally) custom domain.
  </Accordion>

  <Accordion title="Prompt" icon="message-square-code">
    The natural-language description of a change you want vly to make. The most important code you write. See [Prompting fundamentals](/prompting/fundamentals).
  </Accordion>
</AccordionGroup>

## Q

<AccordionGroup>
  <Accordion title="Query (Convex query)" icon="search">
    A Convex function that reads data, reactively. Clients subscribe and receive updates automatically when underlying data changes. See [Convex queries](/convex/queries).
  </Accordion>
</AccordionGroup>

## R

<AccordionGroup>
  <Accordion title="Revision" icon="git-commit">
    A snapshot of your project after a single completed change. Every prompt produces a revision. See [Version history](/building/version-history).
  </Accordion>
</AccordionGroup>

## S

<AccordionGroup>
  <Accordion title="Schema" icon="database">
    The TypeScript file (`convex/schema.ts`) that defines your tables, fields, and indexes. Single source of truth for data shape. See [Schema](/convex/schema).
  </Accordion>

  <Accordion title="Secret" icon="key">
    An encrypted value (API key, webhook secret) scoped per-environment, available to server-side code only. See [Secrets management](/security/secrets-management).
  </Accordion>
</AccordionGroup>

## T

<AccordionGroup>
  <Accordion title="Template" icon="file-stack">
    A pre-built starting point for a new project — SaaS, marketplace, dashboard, etc. See [Templates](/building/templates).
  </Accordion>
</AccordionGroup>

## V

<AccordionGroup>
  <Accordion title="Visual edits" icon="mouse-pointer-2">
    Click directly on UI elements to edit them, instead of describing the change in a prompt. See [Visual edits](/building/visual-edits).
  </Accordion>
</AccordionGroup>

## W

<AccordionGroup>
  <Accordion title="Workspace" icon="building">
    The top-level container for projects, members, and billing. A user can belong to many workspaces. See [Workspaces](/features/workspace/workspaces).
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={3}>
  <Card title="What is vly?" icon="info" href="/getting-started/what-is-vly">
    The bigger picture.
  </Card>

  <Card title="How vly works" icon="workflow" href="/getting-started/how-vly-works">
    The four-step loop.
  </Card>

  <Card title="FAQ" icon="circle-help" href="/getting-started/faq">
    Common questions.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.