> ## Documentation Index > Fetch the complete documentation index at: https://docs.voido.ai/llms.txt > Use this file to discover all available pages before exploring further. # Set up and use the Voido AI assistant > Connect a CLI agent, a ChatGPT account or your own API to the Voido AI assistant, choose how tool actions are approved, chat in project folders, and review or undo changes. The Voido AI assistant reads your events, tasks, projects and notes to find free time and plan your schedule. Before it changes anything, it shows a suggestion card for you to confirm. The assistant is available in the desktop app only. ## Connect an assistant Open Settings → AI → **Models & Accounts** and pick one of the options below. Until you connect one, the AI panel shows **Connect an AI assistant first** with a **Set up AI** button that takes you there. > [tab] Assistants > > Use a CLI agent that is installed and signed in on this Mac: Claude Code, Codex, OpenCode, Cursor, Kimi CLI, CodeBuddy, Qwen Code, GitHub Copilot or Google Antigravity. > > * Click **Use** to select an agent and **Test** to check that it works. > * If a newly installed agent is missing, click **Detect Again**. > * If it isn't signed in, click **Sign In in Terminal** and follow the agent's own login. > > To use a Claude subscription, sign in through Claude Code. > [tab] Subscriptions > > If Settings shows **Continue with ChatGPT**, you can sign in with your ChatGPT account. Requests then run on your ChatGPT plan, separate from Voido Pro. After signing in you can **Manage Usage** or **Sign Out**. > [tab] Custom API > > Bring your own API key. > > 1. Under **API type**, choose **OpenAI-compatible** or **Anthropic**. > 2. Enter the base URL, model and API key. > 3. Click **Save and Test**, then **Use BYOK**. > > The key is stored encrypted on this Mac, separately for each Voido account. **Void Managed AI** in the same list uses your Voido account and AI credits. It requires a paid subscription with available AI credits and supports text chat only. ## Review and undo changes Proposed changes appear as **Suggested timeboxes** or **Suggested changes** cards. Choose **Add All to Calendar**, **Confirm Changes**, **Adjust One by One** or **Discard**. Larger plans appear as **Review plan**, where you can **Accept all**, apply only the items you select, or **Plan again**. After changes are applied, the chat's **Operation History** bar offers **Undo All**, **Keep All** and **Review**, and each item can be undone on its own. The undo rules are described under "Undo AI calendar changes" in [Connect calendars](https://docs.voido.ai/en/calendars.md). ## Approving tool actions With an assistant or a custom API, you decide how the assistant's tool actions are approved. Switch modes from the permission menu in the composer, or set the default in Settings → AI → **Chat & Permissions** → **Assistant Permissions (Advanced)**. A change applies from your next message. | Mode | What happens | | - | - | | Ask every time | Every action except reading files in the working folder waits for your approval. | | Ask for risky actions | New and edited local events apply automatically. Deletions, note text and external calendar changes still wait on the card. | | Allow all | Every action applies directly, with unrestricted access to the internet and files on your computer, except Voido's own app data. Not available for Qwen Code and GitHub Copilot. | When the assistant asks, choose **Allow Once**, **Always Allow**, **Deny** or **Always Deny**. ## Chat in a project folder In the chat list, choose **Add project**, then **Link folder**. Chats in that project run the CLI agent in the linked folder. * The folder link stays on this device and is never uploaded. Other devices show **No folder on this device** until you link it there. * **Remove project** keeps the chats and moves them to **No project**. ## Online agents An online agent is an assistant that lives in the cloud: it replies even when Voido is closed, and the chat syncs to all your devices. You need to be signed in to your Voido account with a membership that includes AI credits. Online agents work in the desktop app and on the web. 1. In the chat list, click **Online** above **Projects**, then click **+** at the top right. 2. Give it a name (up to 40 characters), pick a cat and a color, and click **Create**. 3. Select it in the list to chat with it on the right. While it works, the list and the chat show **Thinking…**. * Each account can have up to 10 online agents. An online agent answers one message at a time with up to 4 more waiting; when the queue is full, wait a few seconds and send again. * It can only read your synced calendar, tasks, projects and notes. When it wants to change your schedule or due dates, it sends a suggestion card for you to confirm first. * Right-click an agent in the list to edit its name and avatar, or to delete it. A deleted agent stops replying and its chat stays as read-only history. * Press Esc or the back button at the top left to return to the chat list. ## Send while it replies While the assistant is replying: * Press Enter to queue your message; it's sent after the current reply. * Press Shift+Enter to **Steer** the reply in progress. Steering works with a custom API or ChatGPT sign-in only, and steering messages can't carry attachments. * Press Alt+Enter for a new line. ## Attachments, memory and voice * Images can be PNG, JPEG, WebP or GIF, up to 5 MB each. Some assistants don't accept images. * Long-term memory holds up to 20 entries. Memories the AI suggests are saved only after you confirm them. * Voice input uses Apple's on-device speech recognition, so audio never leaves your Mac. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.