VixlVixl
Docs
Changelog
GitHub
Docs
Changelog
GitHub
  • Get Started

    • Overview
    • Philosophy
    • Installation
    • Set up providers and models
    • Add a project
    • Create a project group
    • Your first chat
  • Concepts

    • How Vixl works
    • Chat modes
    • Permissions and approvals
    • Projects and home chats
    • Models and roles
    • Context
    • Code graphs
    • The .vixl directory
  • Using Vixl

    • Manage chats
    • Queue and stop messages
    • Review and restore changes
    • Compact and hand off long chats
    • Export a transcript
    • Work with plans
    • Orchestrate sub-agents
    • Best practices
    • Use the workbench
    • Shortcuts and the command palette
  • Customize

    • Providers
    • Models
    • MCP servers
    • Skills
    • Custom agents
    • Rules and AGENTS.md
    • Language servers
    • Appearance
    • Permission settings
  • Reference

    • settings.json
    • mcp.json
    • Custom agent frontmatter
    • SKILL.md format
    • Keyboard shortcuts
    • Chat statuses
    • .vixl layout
    • Managed components
  • Resources

    • Troubleshooting
    • FAQ
    • Privacy
    • Comparison
    • Roadmap
    • Brand and press
    • Changelog

Your first chat

First launch opens the home screen: a chat input in the main pane. New Agent in the sidebar, or Cmd/Ctrl+N, returns here. You need a provider and a model before you can send. With no provider, the model picker is disabled.

Send from home

  1. Click New Agent if you are not already on home.
  2. Select a project, or leave Home. The picker defaults to the last active project.
  3. Choose a mode. The default is Agent.
  4. Choose a model if one is not already filled from your Default role.
  5. Type a message and send. Enter sends. Shift-Enter inserts a new line.

Home creates a home chat whose workspace is your user home directory. A selected project creates a project chat and opens that thread. New chats are titled New Agent until Auto-title fills one in (on by default).

The plus menu attaches images. The shield under the input is the permission dial (default Allowlist). On a git workspace, a branch control appears next to it. The MCP control lists configured servers. Skills and custom agents are / in the editor.

Modes

Agent implements changes in this chat. Ask is read-only exploration. Plan researches, then writes a durable PLAN.md. Orchestrator coordinates work through sub-agents. Tool allowlists live on Chat modes.

After you send

The thread opens and the first message is sent.

A Vixl chat thread with the composer at the bottom and an empty workbench

The agent can read the workspace, call tools the mode allows, and ask before actions the permission dial does not already allow. The workbench is the right-side panel: editor, terminals, and plan tabs. While a reply is running, send becomes Stop generating.

To rename, pin, fork, or delete a thread, see Manage chats. Delete is permanent. See Philosophy.

Edit this page
Last Updated: 10/11/26, 7:48 PM
Prev
Create a project group