Ravelon Agent and AI coding agents
Let the Ravelon Agent propose commands for your servers, and start coding agents such as Codex or Claude Code side by side.
On this page
Set up an AI provider#
AI features need a provider. Add one under Settings → AI providers → Add provider. Provider addresses must use https, except for providers on your own computer. Provider profiles are stored encrypted on this device and are not synced.
Ravelon Agent#
Open the Workspace, click Connections and tools and choose Ravelon Agent. Describe a task, for example "check disk space on my web servers". The agent knows your saved hosts, groups, tags and open terminals. It proposes commands for one or several terminals, connects to hosts and reads the results to plan the next step.
Safety rules:
- Nothing runs without your click. Each proposed command shows whether it only reads or can change the system.
- A command identified as changing the system needs an additional confirmation: you type
RUNbefore it starts. Check every command yourself before approving it. - Blocked commands cannot be run at all. Insert only types a command into the terminal without pressing Enter.
- Ravelon removes secrets and token formats it recognizes before sending data. Check terminal output for sensitive information before sharing it with the agent.
- When a command asks for a password, the agent stops and reports it. It never answers the prompt.
- Share terminal output controls whether recent terminal output is sent with the task.
The conversation is kept in your vault. ⌘J on macOS or Ctrl+J on Windows and Linux asks the AI about the text you selected in a terminal.
AI coding agents#
The Agents sidebar area organizes coding work into project threads. Choose an installed CLI, a model, an access mode and a local folder or Git worktree. Use Changes, Files, Terminal and Browser to review the project alongside the conversation.
The AI Agents launcher in the Workspace tab strip also opens 1 to 8 terminal sessions of Codex, Claude Code, Gemini CLI or OpenCode, in a new tab, to the right or below. Pick a project folder first. The selected CLI must already be installed on this computer.
Under Settings → Agents you can adjust the built-in agents or click Add agent for another command-line agent, with its program, arguments, icon and optional provider. API keys are handed to the agent when it starts and are never typed into the terminal. Only select a provider for a CLI you trust. Agent definitions and provider credentials stay on this device.
Agents on your other devices#
Under Settings → Other devices, click Share computer to offer this computer's agent threads to your other devices signed in to the same account. On your iPhone or iPad the computer shows up under Agents, on another computer under Agents → Other computers. Open it to see its threads, start new ones in a project, in a folder you pick on that computer or without a project, send messages, answer the agent's requests and stop it. Some requests can only be answered on the computer itself.
- Ravelon stays open on the shared computer, with its vault unlocked.
- Each device needs your encryption password, as it does for sync.
- Messages between your devices are end-to-end encrypted. The server only forwards them.
- Through Ravelon Cloud this needs Pro. With your own sync server it is free.
- Block next to a connected device shuts that device out. Stop sharing pauses access for all of them.
Ravelon Voice#
The Voice button in the title bar starts a spoken conversation. It uses a realtime API profile for OpenAI, xAI or Google Gemini with access to the required models. API charges are separate from provider subscriptions such as ChatGPT. Voice can open panes, editors and workspaces for you. It inserts shell commands for you to review but never runs them. Transcripts stay in memory and are not saved.
Last updated 12 November 2026