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

# Arch

> Where everything waiting on you comes together, where new work starts, and how you're told while away.

**Arch** sits at the top of the sidebar, and the app opens on it. It tells you, in one line, how many things are waiting on you and how many sessions are working. The count beside **Arch** in the sidebar is the same number.

## What waits on you

**Needs you** lists the approvals, questions and choices from every conversation in one place: your folders, your other computers, plugins and the companies you belong to. The one waiting longest comes first.

* Only one row is open at a time. You answer it right in the list, the same way you would in the conversation. **Allow once** and **Deny** for an approval, or the agent's suggested answers for a question.
* Once you answer, the row goes away and the next one opens.
* **J** and **K** move between rows. **Y** and **N** press **Allow once** and **Deny** on the open approval (while you aren't typing in a field).

Next to the list:

* **Continue** shows the sessions that are working, and how far each one's plan has got.
* **News** shows what came in lately. **Seen up to here** marks where your last visit ended.

If an approval comes in while you're on another page, it shows up in the bottom-right corner of the window. You can allow or deny it right there.

## Hand Arch a goal

Under **What should we get done?**, write what you want done and press Enter. Arch doesn't do the work itself. It finds a place for the work and hands it to a session:

**1. Read**

It reads what you asked for.

**2. Find computers**

It checks this computer and your paired ones, giving each 3 seconds to answer.

**3. Choose a folder**

It picks the folder where the work belongs.

**4. Make a place**

It uses a worktree, another computer, or the folder as it is.

**5. Hand off**

The session opens in its folder and starts.

The chip at the end of the top line says **Auto**. To decide yourself, pick a computer or a folder there. Anything you write while Arch is looking goes to the session along with the goal. The field works like any other: `@` to mention, `/` for commands, and files.

## Notifications

On the desktop, a notification comes when an approval or a question is waiting, or when a request fails or finishes after a while. You can answer from the notification itself with **Allow**, **Deny**, **Answer** or **Reply**, or choose **Remind in an hour** or **Mute this session**.

Change this in **Manage → Notification settings**:

| Setting | What it does |
| - | - |
| **Done after** | How long a request has to run before you're told it finished |
| **From plugins** | Whether plugins' notices reach you |
| **Quiet hours** | When nothing is sent |
| **Sound** | Whether notifications make a sound |
| **Muted sessions** | Sessions you muted; **Unmute** brings them back |

The phone gets the same notifications ([Devices](https://docs.archetype.ing/en/use/devices.md)). Answer on any device, and the notification disappears from the others.

## While you're away

* **Unattended approvals** (**Manage → Permissions**): when a schedule, a trigger or a pull request's run asks for approval and you aren't there, the run stops and the request waits in Arch. Your answer starts the next turn. **How long a call waits** sets how many days a request stays before it runs out. When this is off, nothing is kept.
* **Time away by company** (**Manage → Notification settings**, if you belong to a company): set **First day away** and **The day you are back**, **Who covers** and **A note colleagues see**. Before it's sent, you read and edit a handover brief of what's in flight. Nothing goes to your colleague until they accept. **I'm back** ends it, and the work they held comes back to you. See [Teams](https://docs.archetype.ing/en/teams/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.