What is Junis Desktop Agent?
Junis Desktop Agent (npx junis) is a CLI tool that connects your local device to the Junis platform, enabling AI agents to control your computer. File management, terminal commands, browser automation, and more — all accessible to your AI agents through a secure connection.
One command. One login click. Full device control for your AI agents.
Zero Configuration: Run the command, click login, and your device is connected. AI agents can immediately start working on your machine.
Why Use Junis Desktop Agent?
Complete Device Control
AI agents can read/write files, execute commands, automate browsers, and interact with your OS — all through your Junis agents.
One-Line Setup
No complex configuration. Run
npx junis, authenticate once, and you’re connected.Secure Connection
OAuth-based authentication with encrypted WebSocket relay. Your device connects outbound — no open ports required.
Two Operating Modes
Use Cloud Mode for remote AI access or Local Mode for direct integration with Claude Desktop.
Getting Started
Prerequisites
- Node.js 18+ installed on your machine
- A Junis account (sign up at junis.ai)
Quick Start
1
Run the CLI
Open your terminal and run:
2
Authenticate
A browser window opens automatically. If you’re already logged in to Junis, simply click “Approve” to authorize the device.
3
You're Connected
The CLI confirms the connection. Your device is now accessible to your Junis agents.
Available Tools
Once connected, your AI agents gain access to powerful device tools:File & Shell Tools
Browser Automation Tools
Operating Modes
- Cloud Mode (Default)
- Local Mode
Cloud Relay Mode
- Persistent connection with auto-reconnect
- 30-second heartbeat for reliability
- Exponential backoff on disconnection
- Device appears in your Junis dashboard
CLI Commands
Linking Devices to Agents
After your device is connected, link it to specific agents:1
Open Agent Settings
Go to Admin > Agents and edit the agent you want to give device access.
2
Link Device
In the Devices section, select your connected device from the list.
3
Test
Chat with the agent and ask it to perform a device action, like listing files in your home directory.
You can also link devices programmatically via Junis Magic MCP tools:
list_devices and link_agent_device.Cross-Platform Support
Security
Authentication
Authentication
- OAuth Device Flow: Industry-standard authentication
- Tokens stored locally in
~/.junis/config.json - Tokens can be revoked anytime via
npx junis logout
Connection Security
Connection Security
- Outbound-only connection: Your device connects out — no incoming ports needed
- Encrypted WebSocket: All communication is encrypted via WSS
- Per-request authorization: Each agent command is verified against your permissions
Device Permissions
Device Permissions
- Only agents explicitly linked to your device can send commands
- You control which agents have access via the dashboard
- Disconnect anytime by stopping the CLI
Use Cases
Development Automation
Browser-Based Research
File Organization
Related Guides
Junis Magic
Manage devices via MCP tools
Agent System
Learn about agent types
MCP Integration
Connect external services
Tools Overview
All available tools
Need Help? Contact us at contact@junis.ai for assistance with device setup and configuration.