Nawa

Nawa is a desktop assistant for Windows that works with the language model of your choice. You chat with it, and it can research on the web, build and run applications in a workspace of its own, drive a browser, control the desktop through plugins, and review code changes — while you decide what it may do without asking.

This site is the handbook: what to do, in the order a new owner meets it. Each page says what kind of page it is at the top, so you know whether you are being taught, told how, given facts, or given reasons.

Where to start

• Install Nawa

  The Windows installer, first start, and updates.

• Connect a provider

  A cloud card or a local server, tested and chosen.

• Your first chat

  An answer with a source, in five minutes.

• Your first app

  Ask for an app, watch it built and verified, open it in the drawer, keep it.

• Permissions

  The modes, the cards that ask you, and what runs in the sandbox.

• Plugins and connectors

  MCP servers, the Chrome and desktop plugins, and tool permissions.

• Instructions, agents and skills

  AGENTS.md, where it lives, and who reads it.

• Troubleshooting

  The messages Nawa shows and what to do about them.

Everyday tasks

• Queue and steer prompts, work in projects, and attach or deliver files.
• Schedule automations and build dashboards.
• Manage memory and understand tokens and budgets.
• Ask Nawa from Explorer and use location.
• Back up and recover your data.

Generated reference

Generated from the code and checked against it on every safety-gate run:

• Settings — shipped client defaults, the controls that edit them, and how a turn resolves runtime settings.
• Workspace tools — the tools an agent gets in a workspace, per configuration, with their contracts.

About this site

The pages are written for one reader: the owner of a Nawa installation who comes back to a feature months later. They use the words the interface uses, quoted exactly as shown. A page marked generated is produced from the source and must not be edited by hand.

This site was built from the development branch and is a development preview unless its build label says otherwise; the documentation that ships inside a release matches that release.

Maintaining Nawa itself? Start with docs/README.md in the source checkout. It links to the authoritative setup, engineering, design, plugin-authoring and release guides, and explains how to rebuild and verify this handbook. Private deployment instructions are intentionally outside shipped Help.