Workgraph 2.0 — Explore freely. Keep what works.

Workgraph is a local visual tree of working product states for Hermes, Codex, and Claude Code. Save source, SQLite development data, explicit context, real screenshots, and independently replayed behaviors. Continue from a saved point or ask your configured agent to borrow one feature into a new branch.

This is a Linux developer preview. The installed release stays fixed while development continues on main.

Watch the new 70-second launch film · Captions

Hermes catalog PR is open, pending maintainer review. Direct installation is available now.

Install the native Hermes plugin

hermes plugins install aliiqbal24/workgraph --ref 37c7280a514d3fa23e7193f44b5123d1f9c90163
hermes plugins enable workgraph

Install the visual workspace and browser tools

Python 3.11+, Git 2.43+, working bubblewrap, and Chromium are required. Install the wheel in a dedicated environment:

python3 -m venv ~/.local/share/workgraph/runtime
~/.local/share/workgraph/runtime/bin/pip install 'workgraph-agent[browser] @ https://github.com/aliiqbal24/workgraph/releases/download/v2.0.0/workgraph_agent-2.0.0-py3-none-any.whl'
~/.local/share/workgraph/runtime/bin/python -m playwright install ffmpeg
~/.local/share/workgraph/runtime/bin/workgraph showcase --directory "$HOME/workgraph-live-test"

This creates a real Python/SQLite project. To use it from your existing Hermes sign-in:

cd "$HOME/workgraph-live-test"
WORKGRAPH_REPO="$PWD" hermes

Ask: “Open Workgraph for this project.” Browse a version and use Continue from here to make a live agent change. The example starts with disclosed scripted directions; your edits, snapshots, app instances, and browser checks are real.

Other agents

Claude Code: /plugin marketplace add aliiqbal24/workgraph, then /plugin install workgraph@workgraph-tools.

Codex: add the installed CLI as an MCP server with codex mcp add workgraph -- /absolute/path/to/workgraph mcp --unbound. New agent sessions discover the tools. The portable plugin ZIP is included as well.

Verification

69 tests and the full Chromium journey passed. A real Codex feature transfer changed only client/app.js, preserved the target database blobs, and independently passed comment persistence, issue persistence, and priority-filter checks. Source SHA: 37c7280a514d3fa23e7193f44b5123d1f9c90163.

The new 70-second launch film has an original score and sound design, a 60 fps composited edit, real UI footage, and saved results from actual Codex and native Hermes runs. The public-installed Hermes task changed only the app title, retained eight issues and identical database schema/rows, and independently passed all three protected behaviors. A fresh Hermes conversation also discovered and opened the native workspace tool.

The full 102-second narrated walkthrough is retained separately. Initial example directions are scripted and disclosed; model results and checks shown are actual saved results. No model execution is staged or product UI generated. The launch export is checked through actual exported-frame inspection, full software decode, Chromium playback, A/V timing, loudness/peaks/DC offset, and speech transcription of the encoded mix. Direct audio monitoring was unavailable; no listening review is claimed.

The official current upstream Hermes admission action passes at the exact public release commit. Catalog acceptance remains a separate maintainer decision.

Source and development state stay local. Approved commands and existing agents use their normal network access and permissions. This does not restore production services, credentials, process memory, or hidden conversation state. The Hermes catalog listing is a separate maintainer review; direct installation is available now.