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

Adding a project

A project is a folder you register so chats, MCP, plans, and the workbench use that directory as the workspace. You can skip this and send a home chat with Home.

Add a folder

  1. Click Add project in the Chats toolbar of the left sidebar.
  2. Choose the folder in the native picker.

If that folder is already registered, it becomes the active project. Cancel does nothing.

You can also right-click in the Chats section and choose Open Project.

Left-click a project to expand its chats. Right-click it and choose Open Project for the project page (chats, MCP, graph, plans, skills, agents, and rules). Escape returns home. See Projects and home chats.

Remove a project from the sidebar

Right-click the project, then Remove from sidebar. That unregisters the folder. It does not delete the folder, its .vixl directory, chats, or graph indexes. Graph stores can be deleted later in Settings, Graphs.

To span more than one folder in a single chat, create a project group.

Next, send a first chat.

Edit this page
Last Updated: 10/16/26, 8:17 PM
Prev
Set up providers and models
Next
Create a project group