Getting Started with Nexrall Work

Nexrall Work is a desktop app for Mac, Windows and Linux. This page walks through signing in, connecting a folder, and running your first task.

1. Sign in

Open Nexrall Work and sign in with the same account you use for the web app, VS Code extension or CLI. Sign-in is shared across all of them — sign in from any one surface and you're signed in everywhere.

2. Connect a folder

Nexrall Work has no single "current project" — you connect the folders you want the agent to work in. Each connected folder becomes a Project:

1. Open the Projects view.
2. Add a folder from your disk.
3. Optionally give the project a name and add project-level instructions in a nexrall.md file inside that folder.

The agent can only read and write inside folders you've connected. Anything outside those folders is off-limits, enforced by the same permission policy used across the CLI and VS Code.

3. Start a task

From the Tasks view, start a new task and pick the connected folder it should work in. Then describe what you want in plain language:

"Read through this repo, find why the login flow fails on empty inputs, and fix it."

The agent plans, reads files, makes edits and runs commands — asking for your approval before anything that modifies files or runs a shell command.

4. Approve or deny as it works

As the agent works, each permission-sensitive action is presented to you:

• File edits — you see what's changing before it's applied.
• Shell commands — you see the exact command before it runs.

You can approve one action at a time, or allow the agent to proceed without further prompts for the rest of the task.

5. Pick a model and effort

Each task can run on a model from several providers — Anthropic, OpenAI, DeepSeek and Qwen — with an effort level to trade speed against depth of reasoning. See Models for the catalogue and guidance on which to pick.

Working with a running task

• Follow-ups — keep sending messages; each one is another turn of the same agent working in the same folder.
• History — open a task's ↩ History to see checkpoints newest-first. Restoring a checkpoint rolls the working tree and the conversation back to just before that turn ran.
• Tasks persist — tasks are saved to disk and listed when you reopen the app. A task that was running when you quit is shown as stopped (it does not keep running in the background).

Next steps

• Working with documents — generate and edit Word, Excel and PowerPoint files.
• Customizing Nexrall Work — add Skills, connectors, plugins and agents.