Connect an agent
EVY gives tasks to the agents on your machines. You pair a machine once, and from then on its Claude Code, Codex, Hermes or Aside takes the tasks you hand it. The same settings page connects EVY to Claude and ChatGPT as a custom connector, so you can use EVY from any chat.
Pair a machine where your agents run
Connect a server pairs a machine, so EVY can give its agents tasks. The same button pairs a second machine, or pairs one again.
- Open Settings, then Agents.
- Under Your agents, click Connect a server.
- Pick Paste into the agent that runs your server or Paste into a terminal.
- Click Copy message or Copy command, and paste it there.
Good to know: the code works once, for ten minutes. On a Mac, EVY Desktop does this for you. With no agent yet, the page reads “No agent yet. Connect the machine where Claude Code, Codex or Hermes runs.”
Run agents on this Mac
Run agents on this Mac lets EVY run your tasks with the agents installed here, also with the window closed.
- Open Settings, then Agents.
- On the row This Mac, click Run agents on this Mac.
Good to know: once on, the row says “EVY runs @
Disconnect or reconnect an agent
Disconnect stops EVY sending tasks to that agent, and Reconnect pairs it again.
- Open Settings, then Agents.
- On the agent’s row, click Disconnect or Reconnect.
Good to know: a dot on the row says Checking in or Not checking in.
Let an agent run two tasks at once
The 2 at once switch lets that agent take two tasks from different sections at the same time.
- Open Settings, then Agents.
- Turn on 2 at once on the agent’s row.
Install EVY’s plugin for Claude Code
The plugin gives Claude Code EVY’s tools and hooks, so a session in a linked folder reads the space’s tasks and reports back.
- EVY Desktop installs the plugin during setup.
- By hand, run
claude plugin marketplace add banzai2k/evy-plugins, thenclaude plugin install evy@evy.
For agents: get_context, claim_task, report, ask, add_task, update_task, add_plan, comment, propose, update_progress, record_decision, knowledge_search, knowledge_page, save_note.
Give Codex the same tools
The plugin’s codex/setup.sh writes the same tools and hooks into Codex’s own config.
- Run the plugin’s
codex/setup.sh, which writes~/.codex/config.toml. - In Codex, trust the hooks in
/hooks.
Good to know: Codex runs the hooks only after you trust them.
For agents: the same tools as Claude Code.
Add EVY to Claude or ChatGPT
The address in Claude and ChatGPT adds EVY as a custom connector, so you can use EVY from any chat, on your phone too.
- Open Settings, then Agents.
- In the group Claude and ChatGPT, click Copy beside the address.
- In Claude or ChatGPT, add a custom connector with that address, then sign in to EVY when it asks.
Approve a sign-in from an app
The connect page shows what the app will be able to do, and lets you allow or cancel it.
- Open the connect page the app sends you to.
- Read the list: Read your spaces, tasks and notes, Save notes and add tasks when you ask it to, Record decisions you make in the chat.
- Click Allow, or Cancel.
Good to know: the page reads “You can disconnect it any time in Settings › Agents.”
Disconnect an app from EVY
Disconnect on an app’s row stops that app’s access at once.
- Open Settings, then Agents.
- In the group Claude and ChatGPT, find the app’s row.
- Click Disconnect.
Good to know: each row shows Allowed