@devicelink/dlink
v0.2.2
Published
DeviceLink CLI agent — secure, local-first device access with explicit user consent
Maintainers
Readme
@devicelink/dlink
DeviceLink CLI agent — secure, local-first device access with explicit user consent.
Share files from your machine with AI assistants (ChatGPT, Claude, etc.) through the Model Context Protocol (MCP). Your files never leave your device — they're streamed in real-time with your explicit permission.
Install
npm install -g @devicelink/dlinkQuick Start
# Sign in with your DeviceLink account
dlink signin
# Share a directory
dlink share /path/to/project
# That's it — ChatGPT can now access your shared files via MCPCommands
| Command | Description |
|---------|-------------|
| dlink signin | Authenticate with DeviceLink |
| dlink signout | Sign out and revoke device access |
| dlink share <path> | Share a directory with MCP clients |
| dlink status | Show connection status |
| dlink debug on/off | Toggle debug logging |
How It Works
- Sign in — authenticate via Google OAuth using a device code flow
- Share directories — choose which folders to make available
- Connect — the agent maintains a secure WebSocket connection to the DeviceLink bridge
- Use — AI assistants call tools (list files, read files, search, grep) through MCP
- Control — you see every tool call in real-time and can disconnect anytime
Security
- Files never stored on servers — streamed in real-time only
- Ed25519 proof-of-possession — device identity is cryptographically verified
- Encrypted credential storage — AES-256-GCM with machine-bound keys
- Shared directory boundaries — path traversal protection, symlink escape prevention
- Short-lived tokens — access tokens expire in 30 seconds, auto-refreshed
Configuration
Environment variables (optional):
| Variable | Default | Description |
|----------|---------|-------------|
| DLINK_CONTROL_URL | https://api.devicelink.ai | Controller API URL |
| DLINK_BRIDGE_URL | wss://api.devicelink.ai/ws | Bridge WebSocket URL |
| DLINK_DEBUG | false | Enable debug logging |
Requirements
- Node.js 20 or later
- Internet connection for authentication and MCP bridge
License
Proprietary. Copyright (c) 2026 DeviceLink. All rights reserved.
