EVO Code

EVO Code

Tauri desktop app for Claude/Codex agent workflows in either local Standalone mode or Remote mode backed by a separate `EVO-Code-host` service.

---

What It Is

EVO Code is the desktop UI. It manages:

• agent roster configuration
• persistent chat threads
• plan/run/review workflow files in your repo
• repo-scoped context files (PROJECT.md, AGENTS.md, etc.)

The app supports two execution modes:

• Standalone (default): all agent execution runs on the same machine as the app.
• Remote: app acts as a thin client, execution runs on a host machine via the separate EVO-Code-host repository.

---

Repositories

• App repo (this repo): UI + local Tauri runtime
  GitHub: https://github.com/0xdippo/EVO-Code
• Host repo: EVO-Code-host (separate repo/service process)
  GitHub: https://github.com/0xdippo/EVO-Code-host

Remote mode requires both:

1. EVO Code app on client machine
2. EVO-Code-host running on host machine

Browser note: `EVO-Code-host` can also serve the browser remote UI, so remote access works from any modern browser-capable device (iPad, tablets, laptops, desktop browsers) in addition to the desktop app.

---

Requirements

App (EVO-Code)

• Node 18+
• Rust toolchain
• claude CLI and/or codex CLI for providers you plan to use

Host (`EVO-Code-host`)

• Rust toolchain
• claude and/or codex installed on host
• host config at ~/.config/evo-code-host/config.toml

---

Quick Start (Standalone)

npm install
npm run tauri dev

Then in the app:

1. Open a local git repository in Setup
2. Configure project metadata
3. Add at least one agent to roster
4. Use Thread to chat/run tasks

---

Quick Start (Remote)

1) Run `EVO-Code-host` on host machine

From the `EVO-Code-host` repo:

mkdir -p ~/.config/evo-code-host
cp config/config.example.toml ~/.config/evo-code-host/config.toml

Edit config:

listen_addr = "0.0.0.0:7700"
service_token = "