Give AI agents full access to your development machine - command execution, file operations, screen capture, and autonomous mode
npm install higherup-agentGive AI agents full access to your development machine.
A CLI agent that connects your local environment to Higherup, enabling AI platforms to execute commands, manage files, capture screens, and work autonomously.
``bashInstall globally from npm
npm install -g higherup-agent
Quick Start
1. Sign up at higherup.ai and create a workspace
2. Copy your credentials from the dashboard:
- Workspace ID
- API Token
3. Configure the agent (one-time setup):
bash
higherup config --token YOUR_API_TOKEN
`4. Connect your workspace:
bash
higherup connect -w YOUR_WORKSPACE_ID -p /path/to/your/project
`5. Enable autonomous mode (optional - removes all restrictions):
bash
higherup connect -w YOUR_WORKSPACE_ID -p . --autonomous
`Commands
$3
Connect a local workspace to Higherup.
bash
higherup connect [options]Options:
-w, --workspace Workspace ID from dashboard (required)
-p, --path Local workspace path (default: current directory)
-t, --token API token (or use config/env var)
-n, --name Custom agent name for identification
--autonomous Enable autonomous mode (unrestricted access)
`$3
Manage agent configuration.
bash
Save your API token
higherup config --token YOUR_API_TOKENSet default workspace
higherup config --workspace YOUR_WORKSPACE_IDShow current configuration
higherup config --show
`$3
Check active agent sessions.
bash
higherup status
`Capabilities
When connected, AI agents can:
| Capability | Description |
|------------|-------------|
|
| Run any shell command |
| file_read | Read file contents |
| file_write | Create/modify files |
| file_list | List directory contents |
| screen_capture | Take screenshots |
| system_info | Get machine details (OS, CPU, memory) |Autonomous Mode
Enable
--autonomous to remove all restrictions:- ✅ No command blocking
- ✅ Full system access
- ✅ Unrestricted file operations
- ✅ Complete AI control
`bash
higherup connect -w WORKSPACE_ID -p . --autonomous
`Security
- All connections use HTTPS encryption
- Path traversal attacks are blocked automatically
- Operations are restricted to your workspace directory only
- Dangerous command patterns blocked by default (unless autonomous)
- API tokens can be regenerated at any time
Screen Capture Requirements
- macOS: Built-in
(may need Screen Recording permission)
- Windows: PowerShell (built-in)
- Linux: scrot or imagemagick (import command)`bash
Linux: Install screen capture tools
sudo apt install scrot # Debian/Ubuntu
sudo dnf install scrot # Fedora
`How It Works
1. Agent registers with Higherup using your API token
2. Polls the server for pending commands every 2 seconds
3. Executes commands locally in your workspace directory
4. Reports results back to the server
5. AI platforms receive command output in real-time
Supported AI Platforms
Works with any AI assistant that integrates with Higherup:
- Claude (via MCP protocol)
- GPT/ChatGPT
- Lovable
- Bolt
- Cursor
- Other AI platforms via the Higherup API
Requirements
- Node.js 18+
- macOS, Linux, or Windows
Environment Variables
bash
API endpoint (defaults to Higherup service)
HIGHERUP_API_URL=https://pltlcpqtivuvyeuywvql.supabase.co/functions/v1/agent-relayYour API token (alternative to --token flag)
HIGHERUP_API_TOKEN=your_token_here
`API Integration
Once connected, AI platforms can control your machine via:
- REST API - Standard HTTP endpoints
- WebSocket - Real-time streaming
- MCP Protocol - Native AI assistant integration
See API Documentation for details.
Troubleshooting
$3
- Ensure your API token is correct (regenerate from dashboard if needed)
- Check that the workspace ID matches your dashboard
- Verify your firewall allows outbound HTTPS connections$3
- macOS: Grant Screen Recording permission in System Preferences
- Linux: Install or imagemagick`MIT