Getting started

Connect an agent, start a task, and pick it up again when you need to.

Start your first task

1. Download Esquip for Mac, open the DMG, and drag Esquip to Applications. You need macOS 13 or newer and Apple Silicon.
2. Open Esquip. Choose the folder you want to work in and an agent. Codex, Claude Code, and OpenCode are available now.
3. Click Create project. Let Esquip prepare the agent and follow the sign-in prompts. Already use that agent? Keep Use my usual settings under Agent options to use your existing account.
4. In New task, describe one outcome and click Create task. For example: “Find why this test fails” or “Compare these proposals and recommend one.”
5. Let the agent investigate first, without changing your project. Open the task, read its findings, and tell it what to do next. If the terminal is stopped, click Start.

For OpenCode, configure your provider and sign-in in OpenCode itself before asking it to work. Esquip is free; your agent provider’s subscription or usage fees are separate.

Add a work or personal account

Use separate profiles to keep multiple accounts for the same agent available — for example, work and personal Codex.

1. Open the project selector and click the edit icon next to your project.
2. Under Agent profile, choose Create profile…. Select the agent, choose Separate settings, and name the profile, such as “Work”.
3. Continue through setup, sign in with the intended account, and click Use profile.
4. Click Save changes. Repeat for another account, or select a profile you already created for another project.

New tasks use the selected profile; existing tasks keep their original one. Set up any needed integrations separately for each new account profile.

Run tasks and come back later

• Work across projects: choose Add project in the project selector. Start tasks in each project, then select All projects to see them together. Switching tasks does not stop the others.
• Pause and continue: click the task’s Stop terminal button. Later, open the same task and click Start to return to its saved conversation.
• See what needs you: read the task summary and unread updates. Open the task to answer the agent or review its result, then use Mark done when finished.
• Come back at a set time: open the task menu and choose Remind me… for yourself or Agent check… for a follow-up investigation.

Keep Esquip open and your Mac awake while agents or scheduled checks need to run. Give parallel tasks separate folders if they must not edit the same files.

If something does not start

• Sign-in problem: open App settings → Profiles → Manage profile… for the affected profile, then choose Connect account or Reconnect account. Check your provider’s available usage too.
• Agent missing: in the same profile settings, choose Managed by Esquip, apply the choice, and download the agent. Or fix your local installation and select its correct path.
• OpenCode cannot use a model: configure a provider in OpenCode, then choose one of its models under your project’s Task defaults.
• A check did not run while the Mac slept: wake the Mac and open Esquip. Allow Esquip notifications in macOS if you want alerts.