Task Relay
Open source · Runs on your computer
Task Relay connects the agents, apps and APIs you already use into jobs that can keep moving.
You choose what matters. Relay coordinates the work around it.
Tell Relay what you need done.
Relay can route work through connected agents, applications and tools. Keep the brief, selected files, review decisions and final outputs together—even when the work crosses several tools.
Review important steps, select the result you want to continue with, and let Relay carry that selection into the next stage.
Explore guides for site research, Rhino, Blender and editable presentations
Brief → research → editable presentation
Concept → 3D model → render → presentation
Relay can move work between an AI agent, Blender or Rhino, image and video tools, and presentation generation without treating every step as a separate conversation.
Keep working with the files you receive. Blender models (.blend), Rhino models (.3dm) and PowerPoint presentations (.pptx) stay editable in their respective applications.
Plan and review each stage with the tools and accounts you have connected.
This beta includes five versioned starters. Use /templates in Telegram or Messages to inspect their stages and required tools, then ask Relay to plan your job.
Check sources, collect evidence and turn selected findings into a report. Document exports require a file worker with suitable libraries.
Research constraints, review a concept, build in Blender or Rhino, and prepare a presentation.
Inspect an existing model, review an exact edit, then check the candidate and its preview.
Plan an adaptation from selected cards and assets, then produce and inspect a reel through a media worker with rendering tools. A connected video model alone does not assemble the reel.
A file worker validates the dataset and prepares reproducible calculations. Relay’s presentation operation turns the reviewed results and chart data into an editable deck.
Starters describe steps built from registered operations and capable workers. Tools and accounts must be connected, and review decisions remain yours. Native model scripts require approval before execution. The download version determines which workflow features are included; complete output quality still needs review with your tools and accounts.
Relay records which outputs were produced from which selected inputs.
Replace a selected model and Relay can show which downstream outputs are affected, so you can review the impact and decide what should run again.
Changing an input does not automatically authorize a rebuild. You stay in control of what runs next.
Use the capabilities you already have.
Codex, Claude and Gemini for work that needs reasoning, file editing or iterative execution.
Blender and Rhino for editable 3D models and rendering; Blender also supports animation.
Text, image, speech and video models when a full agent is unnecessary.
Presentation generation, scripts and other repeatable operations for work that does not need an agent.
Relay coordinates the work without requiring every capability to come from the same provider.
These integrations are implemented in Task Relay. Connect your own accounts and install the tools you want to use. The 0.13.155 release includes the features below; account access and installed tools determine what you can run.
Create scenes from geometry data, inspect and revise selected models, import textures and objects, render previews, and animate transforms or cameras. Saves editable Blender files. Video encoding also needs FFmpeg and ffprobe.
Create, inspect and revise native Rhino models with reviewed Python scripts. Save in the selected Rhino version and render named views with Rhino Render. Requires Rhino and a usable license on macOS.
Create new definitions in Rhino 7 or 8 on macOS with reviewed Python. Save native .gh and .ghx files, then independently reopen and solve both to check the graph and declared outputs. Existing-definition editing is outside this operation.
Create presentations with editable text, shapes, tables, charts and images. Relay saves a native .pptx file without requiring PowerPoint or a Google account. Included in the Mac beta; CLI installations need the presentation extra.
Continue Codex desktop tasks, run Codex CLI workers, use managed Claude sessions, or use Gemini file workers. Codex and Claude can edit files and run commands within their permissions; Gemini’s file-worker route writes declared text files.
Run text conversations and read project files. A direct text API connection does not itself provide application control or file editing.
Use Gemini for image generation/editing and speech, Veo for video, and Runway or Higgsfield for image and video generation. The available output depends on your selected model and account access.
Enable Browser use in Settings to set up a dedicated Chrome profile and sign in to websites. Perplexity Search has a standalone worker; other websites need a supported browser executor. Verification challenges still require you. Telegram is the main task and file-delivery interface; Apple Messages is a separate macOS text pilot.
Direct local application execution is currently supported on macOS. Windows task execution is not supported yet. There is no native Keynote, Word, Excel or PowerPoint application-control integration.
These file routes are implemented in Relay. Each row names the tool that produces the file. Native models and PowerPoint presentations remain editable.
| Program / task | Inputs | Creates and saves |
|---|---|---|
| Blender models & assets | .blend scenes/libraries; .png and .jpg textures; prepared .json geometry or reviewed .py scripts | Editable .blend, .png previews, .json checks; asset import can also save a .zip bundle |
| Blender animation | Selected .blend and a prepared .json animation manifest | Editable .blend, H.264 .mp4 video and .png frames/preview |
| Rhino 7 / 8 | .3dm models; reviewed .py scripts and .json modeling/render settings | Editable .3dm in Rhino 7 or 8 format, .png previews/renders and .json checks |
| Grasshopper definitions | Reviewed .py, declared .json checks and selected template data; requires Rhino 7/8 on macOS | New native .gh and .ghx definitions, with independent reopen/solve checks |
| PowerPoint presentations | Prepared .json slide content and selected .png/.jpg images | Editable .pptx with native text, shapes, tables and charts. Included in the Mac beta; CLI installations need the presentation extra. |
| Gemini images | Text prompts and supported .png, .jpg or .webp references | .png, .jpg or .webp, according to the model’s returned image format |
| Gemini speech | Text and configured voice/model | .wav; also .mp3 when FFmpeg conversion is available |
| Runway & Higgsfield | Text prompts; Runway also supports bounded image references | .png images or .mp4 clips through reviewed generation stages |
| Meshy 3D assets | Text description | Untextured .glb mesh. Texturing and image-to-3D are not included. |
| Veo video | A video prompt with a configured Veo model | .mp4 |
| Text, data & code workers | Project text files and your instructions | Text files such as .md, .txt, .csv, .json, .py, .js, .html and .css |
.docx, .xlsx, .pdf and .svg need a capable Codex/Claude worker with the appropriate libraries or export tools. These are worker-dependent outputs. PowerPoint .pptx generation has its own implemented Relay operation, listed above; it does not include existing-template editing or PDF export.
OpenAI and OpenRouter image stages save PNG candidates. Runway and Higgsfield provide image and video generation; Meshy creates untextured GLB assets from text. Choose defaults under Models by task and connect the relevant API accounts. These new provider adapters have controlled tests; live generation remains unqualified.
Native Keynote .key is not supported. Editing existing Grasshopper definitions is outside the authoring operation. CAD/mesh exchange formats such as .dwg, .dxf, .obj, .stl and .fbx are not standard Relay export operations; any such export needs a separately scoped tool or script. Meshy’s .glb generation does not provide general GLB import or export.
A program’s ability to open a format does not mean Relay can automate it. Support depends on the operation, installed tools and selected files.
07 / Get started
Task Relay runs locally on your Mac. Telegram is the current interface for sending instructions, receiving files, reviewing progress and answering questions.
Package contents: 0.13.155 release includes Browser use settings, separate model defaults, Runway/Higgsfield image and video adapters, Meshy text-to-3D, editable PowerPoint generation, and workflow starters. It also includes Apps and tools switches, workflow recovery, reusable procedures, browser screenshots, and bundled PPTX, DOCX, XLSX and PDF dependencies. The current desktop workspace, universal request scope, saved-project Codex task creation and Grasshopper authoring are also included. API credentials and optional native apps are separate.
Beta 0.13.155 · Apple Silicon · macOS 14+
Coming later · Execution not supported yet
Early beta: this build has no Apple Developer ID or notarization. After trying to open it, macOS may require Privacy & Security → Open Anyway. Only approve the download if you trust it. Apple’s opening instructions. Updates may require refreshing permissions; managed Macs may block this beta.
Python is included. You’ll need your own AI access and a dedicated Telegram bot; provider usage may cost money. First-time Messages setup remains a separate pilot. Optional tools such as Blender are installed separately.
Upgrading from 0.13.25 or earlier: quit Relay, replace the app in Applications, and reopen it. If Settings offers Review service handoff, complete it for Telegram and Messages as shown. Keep your existing data folder. Later compatible beta updates use App updates → Install and restart.
For developers on macOS or Linux. Requires Python 3.11+, curl and tar. Download this beta’s source, then run the guided terminal setup:
curl -fLO https://github.com/StepanKukharskiy/task-relay/releases/download/v0.13.155/Task-Relay-0.13.155-source.tar.gz
tar -xzf Task-Relay-0.13.155-source.tar.gz
cd task-relay-0.13.155
sh install.sh --terminal-setupThe installer creates its own environment and prints the installed CLI path. Keep that folder in place. Optional CLI capabilities require their extras: images, presentations or browser. Setup saves connections without starting provider work. Follow the printed instructions to start Relay and pair Telegram.
The CLI honors the data connection already selected in the companion. Existing login services are preserved; switching their owner requires a reviewed handoff. Linux service support depends on an available user service manager.
Download CLI source · Source checksum