Chat interface
How to talk to your AI agent through the built-in chat panel.
Talking to your agent
The chat panel is how you communicate with the AI agent on your desktop. It sits next to the VNC viewer and terminal in the desktop view.
How it works
When you send a message, it reaches the AI agent running inside the VM. The agent forwards it to your configured AI model (Anthropic, OpenAI, or OpenRouter), which generates a response. The agent can then act on the desktop: running commands, opening applications, editing files, whatever your instructions call for.
Sending messages
- Open your desktop in the dashboard.
- Click the Chat tab in the viewer panel.
- Type your message.
- Press Enter to send.
Shift+Enter adds a new line without sending.
What you can ask
The agent has full access to the desktop. You can ask it to install software, write and run code, browse the web, manage files, run terminal commands, analyze data, or automate repetitive tasks.
Be specific. Instead of "set up a project," try "create a new Node.js project in ~/projects/my-app with Express and TypeScript."
Message history
Messages are stored per desktop. When you come back to a desktop, the previous conversation loads automatically. If the desktop is destroyed, dashboard-side history is kept, but the agent's internal context resets on the next desktop.
Session management
Each desktop has its own chat session. The agent's context includes your current conversation, the soul file (personality and instructions), and memory from earlier interactions if embeddings are configured.
If the agent seems to have lost context, it may have restarted. Check agent ready to confirm.
When chat is unavailable
Chat requires the agent to be fully initialized. You cannot send messages when:
- The desktop is in
pending,booting, orstoppedstatus. - The agent has not finished starting (agentReady is false).
- No AI provider is configured.
If you see a "not ready" message, wait for boot to complete. This takes about 60-90 seconds after the desktop enters booting.
Tips
- Keep chat open alongside the VNC viewer to watch your agent work in real time.
- For long instructions, write them in a text editor first and paste into the chat.
- If the agent is not responding, see the troubleshooting guide.