> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getrilo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Graph Mode

> Visual workflow editor with graph-based interface for creating and managing workflows.

Graph Mode is Rilo's visual workflow editor that displays workflows as interactive graphs. It provides an intuitive way to create, edit, and visualize your automation workflows.

## Overview

Graph Mode transforms your workflows into visual representations where:

* **Blocks** are nodes in the graph
* **Dependencies** are edges connecting blocks
* **Execution flow** is visualized from left to right

<Info>
  Graph Mode automatically determines the execution order based on block dependencies. You don't need to manually specify execution order.
</Info>

## Display Modes

Graph Mode supports three distinct display modes:

### 1. Edit Mode

**Default mode** for creating and editing workflows.

* ✅ Add, edit, and delete blocks
* ✅ Modify block configurations
* ✅ Create dependencies between blocks
* ✅ Full editing capabilities

<Note>
  Edit Mode is the default when creating or modifying workflows.
</Note>

### 2. Cloned Onboarding Mode

**Progressive reveal** for cloned template workflows.

* 🔒 Read-only (no editing)
* 📊 Progressive block reveal based on onboarding step
* 🎯 Guided workflow exploration
* 📈 Shows blocks up to current onboarding step

<Warning>
  Cloned Onboarding Mode is automatically enabled for cloned workflows during onboarding. Once onboarding is complete, it switches to Edit Mode.
</Warning>

### 3. Run Page Mode

**Execution visualization** for monitoring workflow runs.

* 🔒 Read-only (no editing)
* 📊 Shows execution status for each block
* 🎯 Real-time execution monitoring
* ✅ Visual feedback on block completion

<Info>
  Run Page Mode is used when viewing workflow execution results. It shows the current state of each block during execution.
</Info>

## Block Types in Graph

Different block types are represented visually:

<CardGroup cols={2}>
  <Card title="Start Block" icon="play">
    Workflow triggers (manual, scheduled, app events)
  </Card>

  <Card title="Code Block" icon="code">
    Action steps that execute tools and process data
  </Card>

  <Card title="Wait Block" icon="clock">
    Pause execution (time delay, webhook, manual)
  </Card>

  <Card title="HITL Block" icon="user-check">
    Human review and approval steps
  </Card>
</CardGroup>

## Creating Workflows

### Adding Blocks

1. **Via Chat**: Describe what you want in natural language
   ```
   "Scrape Reddit posts and send an email summary"
   ```
   The AI agent creates blocks automatically.

2. **Manual Creation**: Use the graph interface to add blocks manually
   * Click "Add Block" button
   * Select block type
   * Configure block settings

### Setting Dependencies

Blocks automatically determine dependencies based on:

* **Data flow**: Blocks that use output from previous blocks
* **Execution order**: Blocks must execute in dependency order

<Info>
  Dependencies are created automatically when blocks reference data from previous blocks. You can also manually set dependencies in the block configuration.
</Info>

## Visual Features

### Block Status Indicators

Blocks show visual indicators for their status:

| Status           | Indicator       | Description                     |
| ---------------- | --------------- | ------------------------------- |
| `pending`        | Gray            | Block not yet started           |
| `running`        | Blue (animated) | Block is executing              |
| `completed`      | Green           | Block finished successfully     |
| `failed`         | Red             | Block encountered an error      |
| `awaiting_input` | Yellow          | Waiting for human review (HITL) |

### Execution Visualization

During workflow execution:

* **Active blocks** are highlighted
* **Completed blocks** show checkmarks
* **Failed blocks** show error indicators
* **Progress** is visualized with connecting lines

## Graph Navigation

### Zoom and Pan

* **Zoom**: Use mouse wheel or zoom controls
* **Pan**: Click and drag the background
* **Fit to Screen**: Auto-fit all blocks in view

### Block Selection

* **Click block**: Select and view block details
* **Multi-select**: Hold Shift and click multiple blocks
* **Deselect**: Click on empty space

## Best Practices

<AccordionGroup>
  <Accordion title="Organize Blocks Logically">
    While the graph auto-arranges blocks, you can manually organize them for better readability. Group related blocks together.
  </Accordion>

  <Accordion title="Use Clear Block Names">
    Descriptive block names make workflows easier to understand. The AI agent automatically generates names, but you can edit them.
  </Accordion>

  <Accordion title="Minimize Dependencies">
    Keep dependency chains simple. Complex dependency graphs can be harder to debug and maintain.
  </Accordion>

  <Accordion title="Visualize Before Execution">
    Review the graph before running workflows to ensure the flow matches your expectations.
  </Accordion>
</AccordionGroup>

## Limitations

<Warning>
  Workflows must be DAGs (Directed Acyclic Graphs). Circular dependencies are not allowed.
</Warning>

* **No circular dependencies**: Blocks cannot depend on each other in a loop
* **Single trigger**: Each workflow has exactly one trigger type
* **Execution order**: Determined automatically by dependencies

## Tips and Tricks

<Tabs>
  <Tab title="Quick Navigation">
    * Use keyboard shortcuts for faster navigation
    * Double-click blocks to edit quickly
    * Use search to find specific blocks
  </Tab>

  <Tab title="Block Organization">
    * Group related blocks visually
    * Use block colors/categories if available
    * Keep the graph clean and readable
  </Tab>

  <Tab title="Debugging">
    * Check block status indicators
    * Review execution logs for failed blocks
    * Use Run Page Mode to see execution flow
  </Tab>
</Tabs>

## Related Features

* [Configs](/features/configs) - Configure block settings
* [Code Generation](/features/code-generation) - How blocks generate code
* [Human-in-the-Loop](/features/human-in-the-loop) - Review blocks in the graph

***

<Note>
  Graph Mode is continuously being improved. New features and enhancements are added regularly based on user feedback.
</Note>