Run your first workflow

Desktop is the fastest path from a work item to a running agent. Have a Git repository ready and sign in to Claude Code or Cursor before setup if you plan to use either runtime. Codex is bundled.

1. 1

   Open Desktop

   Install and open One Horizon Desktop, then sign in and choose the workspace that owns the work.

2. 2

   Choose the automation level

   Open Workflows and choose the guided setup that matches the work. Start with a simple build workflow if you want one agent to implement a task, or include review steps when approval must happen before the run continues.

3. 3

   Select a runtime and repository

   Choose Codex, Claude Code, or Cursor, then select the repository folder the agent may use. Claude Code and Cursor require authenticated local CLIs. The selected repository belongs to this agent on this machine.

4. 4

   Complete setup

   Review the model, agent access, code isolation, workflow file, and pull request or merge request settings. Finish setup and wait until the agent shows as online. The wizard's Skills step is currently disabled and does not block setup.

5. 5

   Launch with Send to…

   Open an initiative, bug, or todo that contains a usable specification. Select Send to…, choose the published workflow, and confirm the run.

   Inspect the workflow names at the top of the menu and the available agents below them.

   
6. 6

   Verify the run

   Open Workflows or Work queue and confirm the first step is active or queued for the selected agent. The linked work item keeps the run, activities, documents, branch, and review result.

The run may pause for human review, agent input, or a configured route. Monitoring explains the available actions for each state.