# Threads · OmniGet Docs

- URL: https://getomniget.com/docs/threads
- Updated: 2026-10-02
- OmniGet 1.0.0

> Free, open-source yt-dlp GUI for Windows, macOS and Linux. Paste a link to save video, audio and files from 1,000+ sites, or run AI coding agents.

---

AI agents

# Threads

A thread is one agent conversation tied to one project folder: you give a coding task to Claude Code, Codex, OpenCode, an ACP agent or OmniGet’s own agent, and follow the work, the file changes and the approvals in one place. Keep one thread per task, so each change has its own history and can be reviewed or undone on its own.

## Where it is

**LLM › Threads**. The first time, the page asks **What should we build?** and offers **Add project**.

## Before you start

-   A project: any folder. Worktrees and diffs need a git repository.
-   A driver: OmniGet’s own agent is always listed. Claude Code, Codex, OpenCode and the ACP agents appear once the tool is installed and signed in ([Coding tools](https://getomniget.com/docs/cli-tools)). Claude Code and Codex get one entry per account you added in [Connections](https://getomniget.com/docs/accounts-limits).

Each tool runs with your own account and under its provider’s terms and limits.

## How to use it

1.  Click **Add project** and pick the folder.
2.  Click **New thread**.
3.  Choose the **Project** and the **Driver**. Drivers that cannot run right now are marked **unavailable**.
4.  Optionally set the **Model** (empty means **Default of the driver**) and a **Title** (empty means **From the first message**).
5.  Choose the **Access mode** (see the table below).
6.  Turn on **Work in a separate worktree** if you want the agent on its own branch.
7.  Type the **First message (optional)** and click **Create thread** (`⌘↩` (macOS) / `Ctrl+Enter`).

OmniGet remembers the last project, driver, model, access mode and worktree choice for the next thread.

### Plan first

Click **Plan** in the composer to make the agent propose a plan before it touches files. When the plan is done, the thread shows **Plan ready** with **Implement** and **Implement in a new thread**.

## Access modes

| Option | What it does |
| --- | --- |
| **Ask first** | Every edit and command waits for your approval. This is the default. |
| **Accept edits** | File edits run; commands still ask. |
| **Auto** | The agent decides what is safe; risky actions ask. |
| **Full access** | Nothing asks. Use it in a worktree. |

`⇧⌘X` (macOS) / `Ctrl+Shift+X` cycles through the access modes from the composer.

## Worktrees

**Work in a separate worktree** creates a new branch in its own folder, so your checkout stays untouched. It is off by default and only offered for git repositories.

-   The worktree lives in OmniGet’s data folder, in `worktrees/`, on a branch named `omniget/…`.
-   Setup runs in stages: **Fetch**, **Checkout**, **Submodules** and **Setup script**. A setup script can be defined in the project’s `.omniget/project.json`.
-   **Cancel setup** stops it before the thread starts.

The thread header shows the branch, and the thread list shows a **Worktree** pill with its path.

## The side panel

The panel on the right has these tabs (`⌘J` (macOS) / `Ctrl+J` shows or hides it):

| Tab | Keys | What it shows |
| --- | --- | --- |
| **Diff** | `⌥D` (macOS) / `Alt+D` or `⌘D` (macOS) / `Ctrl+D` | The changes of a turn or of the whole thread. |
| **Terminal** | `⌥T` (macOS) / `Alt+T` | A terminal in the thread’s folder. |
| **Files** | `⌥F` (macOS) / `Alt+F` | The project files. |
| **Plan** | `⌥P` (macOS) / `Alt+P` | The current plan. |
| **Tasks** | `⌥A` (macOS) / `Alt+A` | The agent’s task list. |
| **PR** | `⌥R` (macOS) / `Alt+R` | The pull request for the branch. |
| **Browser** |  | A browser preview. |

**Diff**, **Terminal** and **PR** need a folder; otherwise they say **This thread has no folder**.

### Diffs and going back

-   Switch between **Turn** and **Whole thread**, and use **Pick a turn** to see an earlier one. **Ignore whitespace** hides space-only changes.
-   The diff opens by itself after a turn that changed many files or lines.
-   **Revert to here** asks **Edit from here?** and offers **Revert chat only** or **Revert files and chat**. OmniGet keeps a checkpoint of each turn in the repository, under `refs/omniget/checkpoints`.

Warning

Without a worktree, **Revert files and chat** changes the same folder you work in. Commit or stash your own changes first.

## Approvals

When the agent needs permission, the **Approval needed** drawer opens. It says what kind of request it is (a command, a file read, a file change, app access, a permission or a tool) and offers:

| Button | Key |
| --- | --- |
| **Approve** | Y |
| **Approve for this session** | S |
| **Always** | A |
| **Decline** | N |
| **Cancel turn** |  |

With several requests waiting, \[ and \] move between them. Some drivers send their own choices (for example **Allow once** or **Deny**); the same keys still work.

When the agent asks you something instead, the drawer shows **Question from the agent**.

## Shortcuts

| Action | Keys |
| --- | --- |
| New thread | `⌘N` (macOS) / `Ctrl+N` |
| Add project | `⌥⌘N` (macOS) / `Ctrl+Alt+N` |
| Rename thread | F2 |
| Fork thread | `⇧⌘K` (macOS) / `Ctrl+Shift+K` |
| Archive thread | `⌘⌫` (macOS) / `Ctrl+Backspace` |
| Toggle right panel | `⌘J` (macOS) / `Ctrl+J` |
| Toggle plan/default mode | `⇧⌘A` (macOS) / `Ctrl+Shift+A` |
| Cycle access mode | `⇧⌘X` (macOS) / `Ctrl+Shift+X` |
| Send | `↩` (macOS) / `Enter` |
| New line | `⇧↩` (macOS) / `Shift+Enter` |
| Send now (interrupt) | `⌘↩` (macOS) / `Ctrl+Enter` |
| Interrupt the running turn | `esc` (macOS) / `Esc` |
| Keyboard shortcuts | ? |

## Common problems

### “No drivers available. Install or log in to a CLI in Tools.”

No coding tool is installed and signed in. Open [Coding tools](https://getomniget.com/docs/cli-tools), install one and click **Sign in**.

### **Work in a separate worktree** is greyed out

The project is not a git repository (**Only for git repositories.**). Run `git init` in the folder, or work without a worktree.

### **Plan** does nothing useful with some drivers

Plan mode depends on the driver. Claude Code supports it; OmniGet’s own agent and Codex do not, and the button is shown anyway.

### **Fork** or **Compact** is missing

They only appear for drivers that support them.

[Previous**← AI provider**](https://getomniget.com/docs/ai-provider) [Next**Work: tasks, routines, missions and arena →**](https://getomniget.com/docs/work)