Nous Contact

Docs

Getting started

Nous pairs with a SpaceApp you run. It does not run agents by itself. Here is how to set it up once the app is on Google Play.

  1. Install SpaceApp

    SpaceApp runs your agent CLIs (Claude Code, Codex, OpenCode, Gemini CLI and others) side by side on your own machine or server. Install it from spaceapp.dev; its documentation is at spaceapp.dev/docs.

  2. Choose how the phone reaches SpaceApp

    On Free, the phone connects straight to your SpaceApp, so it needs an address the phone can reach:

    • Your LAN, when the phone is on the same network.
    • A VPN. Nous has a WireGuard tunnel built in. In Settings → WireGuard tunnel, import your configuration from a file, a QR or pasted text; Nous can bring the tunnel up on its own when your SpaceApp is out of reach.
    • Your own domain with HTTPS in front of your SpaceApp.

    With Pro, after launch, a relay will reach a SpaceApp behind NAT with no inbound ports.

  3. Pair the phone

    In SpaceApp on a computer, open Settings → Account → Mobile app → Pair a phone. It shows a QR code that is valid for 2 minutes. Open Nous, scan the code (or paste it), compare the fingerprint Nous shows with the one in SpaceApp, and pair. From then on every message between them is end-to-end encrypted; see Security.

  4. Answer your first card

    When a pane waits for you, Nous shows a Needs you card. Approve, decline or answer it. Turn on notifications to be alerted, and set quiet hours if you want silence at night.

If something goes wrong

The QR code was not accepted

Each code is valid for 2 minutes and works once. Open Settings → Account → Mobile app → Pair a phone again for a new one.

Nous shows a red screen about a changed key

Your SpaceApp's key is not the one pinned at pairing. Nous will not connect, to protect you. If you reinstalled SpaceApp yourself, remove the pairing and pair again; if you did not, check your server before you do.

The phone cannot connect

Check that the phone can reach the address you paired with: the same LAN, the VPN tunnel on, or your domain resolving from the phone's network.

Remove a phone

In Nous, remove the pairing from its settings; its keys are deleted from the phone. To end it in SpaceApp too, remove the device under Settings → Account → Devices.

Still stuck? Write to dev@nousapp.dev.