Local Mode

Run your agent on your machine

What is Local Mode?

Local Mode means your OpenCode agent runs on your own machine. Evident creates a secure tunnel to connect it to your channels (Slack, WhatsApp, web).

Benefits:

  • Your code and data stay on your machine
  • Access to local files, tools, and environment
  • No cloud compute costs
  • Full control over your agent

How it works

When you run npx evident connect, we create an encrypted WebSocket tunnel from your machine to Evident's relay servers.

When you send a message from Slack, WhatsApp, or the web:

  1. The message arrives at Evident's relay
  2. We forward it through the tunnel to your local OpenCode
  3. OpenCode processes the request
  4. The response comes back through the tunnel
  5. We send it to you via your channel

Requirements

  • OpenCode running locally
  • Internet connection
  • The tunnel must be running to receive messages

Keeping the tunnel running

The tunnel needs to stay connected for your agent to receive messages. A few options:

Option 1: Run in a terminal

Just keep the terminal open:

npx evident connect

Option 2: Run in the background

Use a process manager like pm2:

pm2 start "npx evident connect" --name evident

Option 3: Use tmux/screen

Run in a detached session that persists after you close the terminal.

What happens when offline?

When your machine is offline or the tunnel isn't running:

  • Messages to your agent will be queued
  • Senders get a message that your agent is offline
  • When you reconnect, queued messages are delivered

Coming soon: GitHub Actions

Want your agent always on? We're building GitHub Actions runtime — your agent runs in GitHub's CI/CD infrastructure using your free minutes. No local machine needed.