CTRL NODE

Changelog

New features, improvements and fixes — every release documented.

June 2026 Latest
v2.2

Hermes & Work Directory

A new provider with persistent memory. A new mode that edits your repo directly.

v2.2 ships two independent features. Hermes joins as the seventh native Bridge provider — a stateful AI agent with persistent memory, auto-generated skills, and its own MCP server. Unlike every other provider, Hermes remembers the context of previous tasks: each agent maintains a continuous conversation thread that survives across dispatches, restarts, and sessions.

Work Directory mode lets you send an agent into an entire folder — a full repository, a project directory, or any subtree on your Bridge machine. Instead of generating files into an isolated output folder, the agent operates directly inside the folder you choose, reading existing code and editing files in place. You can narrow its focus to specific files or subfolders using the built-in path picker, or leave it open to let the agent explore the entire working directory and decide where to act.

Work Directory mode — select repo → agent edits code directly
What's new
🧠
Hermes provider — stateful AI with per-agent isolated profiles

The Bridge now supports Hermes as a native provider via the ACP protocol (hermes acp). Hermes is fundamentally different from every other supported provider: it maintains a persistent conversation thread with SQLite-backed memory across tasks. Skills the agent auto-generates accumulate over time. When you dispatch a follow-up task, Hermes already knows what happened in the previous one — no re-prompting required. Each agent maps to its own isolated Hermes profile directory (~/.hermes/profiles/{agentId}/) with its own config.yaml (model selection), SOUL.md (identity), and credential symlinks — agents with different models or roles never share state.

Hermes setup guide
🗂️
Work Directory mode — send agents into an entire folder

Tasks and routines now support a Work Directory mode alongside the existing output-only mode. Instead of generating files into an isolated output folder, the agent operates directly inside a folder you choose — a full repository, a project directory, or any subtree on your Bridge machine. You can narrow its focus to specific files or subfolders using the built-in path picker, or leave it open to let the agent explore the entire working directory. The agent reads existing code, edits files in place, and reports back what changed — no manual file staging required.

Work Directory mode guide
🔧
New binary ctrlnode with setup wizard and startup diagnostics

The Bridge binary is now ctrlnode[.exe] (previously ctrlnode-bridge). Run ctrlnode --setup to configure it interactively: the wizard asks for your workspace root and your pairing token (from Settings → Bridge in the app), saves them to <workspace>/.ctrlnode/.env, and persists BASE_PATH as a user environment variable — no manual file editing required. On subsequent runs the Bridge prints which .env it loaded and reminds you of --setup if the token is missing. Available for Windows x64, Linux x64 (AVX2 and baseline), and macOS Apple Silicon.

May 2026
v2.1

Routines

Set it once, run it on schedule.

Routines are scheduled automations: you write the instructions, pick an agent, choose a time, and CTRL NODE fires the task automatically — every day, every hour, or on a custom cron. The agent runs on your local machine, the output streams back live, and every run is permanently logged.

This release completes the loop from manual task to fully automated workflow. Routines are the bridge between ad-hoc agent use and production-grade automation — without a single line of infrastructure code.

Routine lifecycle — create · schedule · execute · result
What's new
⏱️
Scheduler — cloud-side cron that wakes your Bridge

The CTRL NODE scheduler runs in the cloud and triggers your Bridge at the exact time you configured — whether you're at your desk, away from your computer, or the lid is closed. Supported presets: Hourly Daily Weekdays Weekly plus full custom cron expressions. Timezone-aware with UTC offset configuration.

🤖
Agent executes, files land in workspace

When a routine fires, the Bridge dispatches the instructions to your configured agent — Claude, Copilot, Gemini, or any other connected provider. The agent runs in your local workspace, reads your project files, and writes its outputs directly to disk. Reports, summaries, generated code, logs — anything your agent produces stays on your machine, git-trackable and immediately usable.

📋
Full run history with live output

Every run is logged permanently: status (Running, Done, Cancelled), trigger source (scheduler or manual), start time, duration, and the complete terminal output stream. You can open any historical run and read everything the agent printed. File artifacts produced during the run are listed and linked. The history panel is accessible from the routine detail page and from the run detail view.

📄
File artifacts — outputs tracked per run

Files written by the agent during a routine run are detected, catalogued, and attached to the run record. Each artifact shows its filename, size, and write time. This gives you a clear audit trail of what each scheduled execution produced — especially useful for recurring reports, generated documentation, or code changes committed by the agent.

Manual trigger — RUN NOW at any time

Don't wait for the scheduled time. Hit RUN NOW from the routine detail page to trigger an immediate execution. The run is logged in history exactly like a scheduled run, with trigger source set to "manual". Useful for testing new instructions, backfilling a missed run, or on-demand reporting.

⏸️
Pause, resume and archive

Pause a routine to stop it from firing without deleting it — useful during vacations, incident response, or while you're iterating on the instructions. Resume it at any time and the scheduler picks up the next scheduled slot. Archive a routine to remove it from the active list while preserving the full run history for audit purposes.

April 2026
v2.0

Six Providers

Orchestrate Claude, Copilot, Gemini,
Codex, Cursor & OpenClaw like a crew.

CTRL NODE v2.0 expanded the platform from a single-provider tool into a unified control plane for every major AI coding agent. You can now mix providers in a single Bridge instance, assign a different agent to each step of a workflow, and see every agent's live status in one dashboard.

Version 2.0 also introduced the Team view, the Activity Dashboard, per-provider model selection, and the open Bridge binary distributed via GitHub Releases — making CTRL NODE fully self-hostable and open-source at the runtime layer.

Team view — all agents, live status
Activity dashboard — runs, tasks, events
What's new
🔌
Six AI providers — Claude, Copilot, Gemini, Codex, Cursor, OpenClaw

v2.0 added native Bridge support for GitHub Copilot via the ACP protocol, Google Gemini CLI via browser-login or API key, OpenAI Codex CLI with per-agent sandbox isolation, Cursor's headless background agent API via gRPC, and OpenClaw via gateway token. Every provider is a first-class citizen: dedicated env var documentation, provider-specific model lists, and individual setup guides at /start/{provider}.

👥
Team view — live agent grid across all providers

A new Team page shows every configured agent as a card with live status: ONLINE (idle, ready), RUNNING (executing a task with progress bar), OFFLINE, or FAILED. Status updates arrive in real time over SignalR. The card shows the provider badge, model name, last heartbeat, and a link to the agent's current task if one is running.

📊
Activity dashboard — pipelines, tasks, events at a glance

The Dashboard gives you an instant overview of your org's activity: active pipeline runs with step progress, recent task completions by agent, a live event stream showing Bridge notifications, and aggregate stats (total runs, tasks done, agents online). All widgets update in real time without refreshing the page. Designed as the first screen you open to understand the state of your automation environment.

🎯
Model selection — live model list per provider

When the Bridge connects it queries each provider for its available models and sends the map to CTRL NODE via a new WebSocket message. The agent creation and edit forms show a searchable MODEL dropdown populated from the live list. Start typing to filter, press Enter or click to confirm. If no model is entered the provider uses its default. The list is scoped to the selected provider when one is detected.

🧠
Agent workspace & AGENTS.md — persistent context per agent

Every agent now has a dedicated workspace on the Bridge machine. An AGENTS.md file — seeded from templates stored in the database and customisable per agent — is injected into every task so the agent knows its role, constraints, and available tools. Re-run the Migrations console app after editing templates to propagate changes to all agents in your org.

🔓
Open-source Bridge — self-hostable, MIT licensed

The Bridge runtime is fully open source under the MIT license and distributed as pre-built binaries for Windows x64, Linux x64 (AVX2 and baseline), and macOS Apple Silicon via GitHub Releases. No build step required — download the binary, set your environment variables, and run. The CTRL NODE control plane (API + web app) remains hosted, but the execution layer is yours to audit, fork, and extend.

March 2026 Initial Release
v1.0

Orchestrate agents remotely

From your computer or VPS. From anywhere.

CTRL NODE 1.0 launched with a single mission: let you control AI agents running on your own hardware from any browser, without opening ports, configuring VPNs, or writing any infrastructure code. The initial release shipped two core primitives — multiagent visual workflows and a Kanban task board — both powered by the Bridge, a lightweight open-source daemon you drop on any machine.

The founding insight was that AI agents are most powerful when they run locally — with access to your filesystem, your toolchain, your private repos — but most useful when you can dispatch and monitor them remotely. CTRL NODE is the remote control layer that connects those two worlds, without touching your data.

Multiagent workflows — n8n-style visual pipeline builder
Kanban task board — create, assign and track tasks
What launched
🌉
Bridge runtime — outbound-only, zero config networking

The Bridge is a single binary (no dependencies) that runs on any machine you control — laptop, home server, cloud VM, or corporate workstation. On startup it establishes a persistent WebSocket connection outbound to CTRL NODE, authenticated by a pairing token you generate in the web app. No inbound ports, no firewall rules, no VPN, no proxy configuration. Behind NAT or inside a restrictive corporate network? It just works. The Bridge reconnects automatically on disconnect and queues commands during offline windows.

🔀
Multiagent workflows — n8n-style visual pipeline builder

Design complex automations on an infinite canvas: drop agent nodes onto the stage, connect their inputs and outputs to form a directed acyclic graph, and assign a different agent to each node. When you hit Deploy, the Bridge activates the workflow and begins orchestrating tasks in dependency order — a node doesn't start until every predecessor has completed and its output file is available as the successor's input. Every step streams its output back to the browser in real time.

📌
Kanban task board — one-off tasks across the BACKLOG → DONE pipeline

The Kanban board is the lightweight alternative to workflows: create a task, write the instructions, assign it to any online agent, and hit Run. Tasks progress through four columns — BACKLOG, INBOX (queued to the Bridge), ACTIVE (agent is executing), DONE — with real-time status updates pushed over SignalR. Each task gets its own dedicated workspace and output panel so you can read the agent's terminal output without leaving the board.

Live output streaming — zero-latency terminal in the browser

Every byte the agent writes to stdout is forwarded over the Bridge WebSocket and displayed in the browser in real time — no polling, no buffering delays. The output panel renders ANSI colour codes, handles long lines gracefully, and auto-scrolls as new output arrives. You can watch a multi-hour research pipeline run step by step from any device on any network, with no connection to your local machine other than the Bridge's single outbound socket.

📁
Per-agent file workspace — isolated, persistent, git-ready

Each agent on your Bridge gets its own directory in the local filesystem. Files created during a task persist between runs, allowing agents to build up context, maintain state, and reference prior outputs. Workflow nodes that feed into each other share files via a structured input/output manifest: predecessor output files are automatically staged as successor inputs before the next node starts. The workspace is a normal directory on disk — you can open it in your editor, commit it to git, or share it with other tools.

🔐
Multi-tenant architecture — row-level security from day one

CTRL NODE is built multi-tenant from the ground up: every database query is scoped to the caller's organisation via PostgreSQL row-level security, enforced by the OrganizationMiddleware on every API request. Authentication uses Clerk JWTs in production and a dev-bypass mode for local development. No data from one organisation can ever be read by another — isolation is enforced at the database layer, not just the application layer.