Skip to content
Docs
HomepageDemo
Overview
Getting started
QuickstartChoose an installationWhat is Metis?Accounts and initial setupConnect your first providerYour first taskSign inInstall on LinuxInstall on macOSInstall on Windows
Chat & context
Navigation & chatsCompose messagesResponses & tool callsAnswer questionsApprove actionsSearch & quick actions
Workspace
Agent overviewCanvasPlansMemoryFilesTerminalBrowserDesktopsServer monitorArrange the workspaceExport workspaces
Projects & teams
Create a projectProject overviewChat visibilityProject picture, color, and iconProject instructionsProject memoryProject skillsProject filesProject notesAgent model defaultLet agents manage the teamMembers & invitationsAgent teamsTeam presetsTeam overview
Notes
Notes & scratchpad
Agent Hub
SkillsConnections / MCPsCustom modes & rulesGlobal agent rules
Settings
GeneralModels — ConnectionsAgent — Runtime & memoryDevices — Remote clientsAdmin / ChatsUpdatesSearch settingsAttachments and file sizeSubagent modelToken compressionPreview compressionSounds and notificationsNotification deliverySet up voice inputChoose a microphoneRecording and streamingDictionaryConfigure the browser previewManage website dataWebsite and source code
Models & providers
AgentDeep ResearchPlanAskGauntletCursorOpenAIAnthropicGoogle GeminixAI / GrokOpenRouterOllama / LocalOpenAI-compatibleOpenAI CodexClaude CodeGoogle AntigravityGrok BuildOpenCodeModel options
Account & sharing
ProfileNotificationsUsage & costsShare chatsPublic shares
Guides & operations
Charts, graphs & mediaAutomationsOperate your installationTroubleshootingSet up a complete projectWork on a connected PCResearch and produce a reportGlossary and scopes
Metis AI
Docs/Settings

Settings

Devices — Remote clients

Remote clients connect additional computers to Metis. The device establishes a connection to the installation; device settings determine which actions are available.

1 min readUpdated: October 2026
Remote clients before pairing a device. Captured in an isolated Metis test instance with fictional sample data (October 2026).
Remote clients before pairing a device

Remote clients before pairing a device. Captured in an isolated Metis test instance with fictional sample data (October 2026).

Step by step

  1. 01

    Open Settings → Devices → Remote clients and choose Add client.

  2. 02

    Choose the operating system and access mode.

  3. 03

    Install the offered app and pair it using the server URL and pairing code.

  4. 04

    Check connection status and permissions before using files, commands, or desktop control.

Devices

  • Remote clients

Remote Clients

  • Device name
  • Platform
  • Connection status
  • Client list
  • Reload and errors

Add client

  • Choose OS → Install → Connected
  • Linux/Windows/macOS
  • Server URL
  • Pairing code
  • Installer and installation command

Permission mode

  • User access
  • Admin/system access
  • Installation and confirmation differences

Permissions

  • Full Access
  • Device information
  • List directories
  • Read, create, edit, and delete files
  • Allowlisted commands
  • Terminal

Computer Use

  • Desktop permission
  • Screen, mouse, and keyboard
  • macOS Screen Recording/Accessibility
  • Linux X11 requirements

Command allowlists

  • Global allowlist
  • Device allowlist
  • Exact commands
  • Save

Check connection and permissions

  • Test connection
  • Check desktop permissions
  • Check now
  • Grant on Mac

Remote Client notifications

  • Native notifications
  • Select target device
  • Client must be running

Remove client

  • Remove with confirmation
  • Changes to device access

Good to know

  • User access and Admin/system access use different installation and permission paths.
  • Computer Use also requires an available desktop and appropriate screen and control permissions.
  • Allowlists permit specific commands. A connection alone does not grant blanket administrator access.

Troubleshooting

If a device appears offline, its client must be running and able to reach the Metis address. On macOS, also check Screen Recording and Accessibility. Linux desktop control requires a supported X11 session.

Troubleshooting guide

Related articles

GeneralModels — ConnectionsAgent — Runtime & memoryAdmin / Chats
PreviousAgent — Runtime & memoryNextAdmin / Chats
Back to homepageReport an issue

On this page

Step by stepDevicesRemote ClientsAdd clientPermission modePermissionsComputer UseCommand allowlistsCheck connection and permissionsRemote Client notificationsRemove clientGood to knowTroubleshooting
Back to top ↑
Documentation
Overview
Getting started
QuickstartChoose an installationWhat is Metis?Accounts and initial setupConnect your first providerYour first taskSign inInstall on LinuxInstall on macOSInstall on Windows
Chat & context
Navigation & chatsCompose messagesResponses & tool callsAnswer questionsApprove actionsSearch & quick actions
Workspace
Agent overviewCanvasPlansMemoryFilesTerminalBrowserDesktopsServer monitorArrange the workspaceExport workspaces
Projects & teams
Create a projectProject overviewChat visibilityProject picture, color, and iconProject instructionsProject memoryProject skillsProject filesProject notesAgent model defaultLet agents manage the teamMembers & invitationsAgent teamsTeam presetsTeam overview
Notes
Notes & scratchpad
Agent Hub
SkillsConnections / MCPsCustom modes & rulesGlobal agent rules
Settings
GeneralModels — ConnectionsAgent — Runtime & memoryDevices — Remote clientsAdmin / ChatsUpdatesSearch settingsAttachments and file sizeSubagent modelToken compressionPreview compressionSounds and notificationsNotification deliverySet up voice inputChoose a microphoneRecording and streamingDictionaryConfigure the browser previewManage website dataWebsite and source code
Models & providers
AgentDeep ResearchPlanAskGauntletCursorOpenAIAnthropicGoogle GeminixAI / GrokOpenRouterOllama / LocalOpenAI-compatibleOpenAI CodexClaude CodeGoogle AntigravityGrok BuildOpenCodeModel options
Account & sharing
ProfileNotificationsUsage & costsShare chatsPublic shares
Guides & operations
Charts, graphs & mediaAutomationsOperate your installationTroubleshootingSet up a complete projectWork on a connected PCResearch and produce a reportGlossary and scopes

Popular starting points

Getting startedQuickstartGo from installation to your first verifiable task: set up Metis, connect a model, and start with a small request.Getting startedChoose an installationNative installation is recommended for Linux, macOS, and Windows. Install Metis on the computer or server that will run it, then pGetting startedWhat is Metis?Metis is your self-hosted workspace for AI agents. Conversations, files, browser, tools, and persistent context stay together. YouGetting startedAccounts and initial setupOn first launch, you set up the instance with an administrator account. The single-use operator token confirms your authority to mGetting startedConnect your first providerMetis needs model access to generate responses and run agent tasks. Setup displays authentication methods supported by the selecteGetting startedYour first taskCheck your setup with a small task whose result you can assess directly. You can then add files, browser access, or project contexGetting startedSign inSign in with an account on the relevant Metis instance. Your displayed profile name may differ from your login username.
↑ ↓ select · Enter openEsc close