<!-- Generated from the plugin's Notebook wiki. Do not edit this file here: the next export overwrites it. -->

# User guide

These pages explain the plugin **AI CLI Agents** for the person who uses it. Each page tells you
where a feature is in the WebGUI, how to use it, what each choice means, and what to do when
something looks wrong. You do not need to read code.

## Start here

- [Getting started](getting-started.md): install the plugin, run the first-time setup, sign in to an
  agent, and find your way around the two pages of the plugin.
- [Workspaces](workspaces.md): open an agent in a folder, use the drawer, switch between
  workspaces, resume a conversation, close one, and work from two devices at once.

## Work with an agent

- [Workspace settings and automation](workspace-settings-and-automation.md): launch arguments, environment variables and
  secrets for one workspace, favourites, export and import, SSH reattach, automatic launch after a
  restart, and the Continue automations.
- [The terminal](terminal.md): clickable links, copy and paste on desktop and phone, uploads,
  theme and font, touch controls.
- [Voice](voice.md): let an agent speak, dictate into an agent, and read your voice mail.
- [The Notebook](notebook.md): the drawer where an agent puts things you must read, follow,
  compare or decide, instead of the terminal.
- [The wiki](wiki.md): the living documentation of a workspace, built from linked pages.

## Keep your data safe

- [Home and agent storage](storage.md): where the plugin keeps homes and agents, why it uses
  layers, where to put storage, the home card, saves and merges, and what happens at array stop.
- [Home backup and restore](backup-restore.md): a second, plain copy of a home on a target you choose,
  on a schedule, and how to put it back.

## Agents and their shared setup

- [Agent Store](agent-store.md): install, upgrade and remove agents, pick versions and channels,
  set each agent's defaults.
- [Config Hub](config-hub.md): one shared definition of tools, instructions, skills and commands
  for every agent that supports it, with history.
- [Agent Relay](relay.md): the shared mailbox between workspaces, topics and direct messages,
  and connecting another machine.
- [Plugin management tools for agents](agent-tools.md): what an agent may ask the plugin, what it
  may change, and what it may only propose for your approval.

## When something looks wrong

- [Health, Activity and troubleshooting](health-and-troubleshooting.md): the health dot and its checks, the
  Activity tray, the Debug Console, the support bundle, and a symptom table.

## Every setting

- [Settings reference](settings-reference.md): each setting on each tab, with its meaning, default and
  effect.