Skip to main content
Start with a repository or folder you already have. A cloud account is optional.
1

Install and sign in

Download Nuphos Desktop for macOS, Windows or Linux. Sign in with Google, Apple, or an email verification code. Create or join the team you want to work in.
2

Choose a runtime and computer

To use a coding CLI already installed on this computer, open Settings → This computer → Local runtime. Select a supported runtime and follow its sign-in instructions.To work remotely, open Runtimes → Add runtime. An Administrator can add a Nuphos-managed New computer, connect a machine you manage with its join command, or connect a self-hosted runtime. Cloud capacity has a separate computer plan. See Runtimes and computers.
3

Start your first task

Choose New agent and select the runtime in the composer. For a local runtime, point it at a folder that exists on that computer:
Work in ~/code/my-app. Read the README, explain how to run the project, and identify one small improvement. Show me the proposed change before committing anything.
Replace the path with your own. For a cloud or remote computer, first clone the repository there using access you are authorized to use. A path on your laptop is not automatically a path on the remote machine.
4

Follow and steer the work

The transcript shows progress and tool results. Send a correction while the agent is working to steer it. Answer question cards when it needs input; stop the turn if you need it to halt.Start in Auto Mode: actions the runtime considers risky ask for approval. A code edit does not automatically require an infrastructure plan. Ask explicitly for review before committing or publishing when that is the workflow you want.
5

Bring your team and tools

Share the session with a teammate when you want them to read or contribute. The teammate also needs access to the computer where work runs.Connect GitHub, Linear, or another connector when you need it, then select it for the conversation. For cloud work, add AWS or GCP and start with only the provider permissions the task needs.

Continue after closing your laptop

A local runtime needs its computer and Nuphos to stay running. For work that must continue independently, move to a remote or cloud runtime using the conversation’s runtime picker. Read the move confirmation and prepare the repository and its files on the destination; conversation history is not a file synchronization tool. The Desktop guide, Agents guide, permission modes and plans explain the next steps. Add triggers only when you are ready for scheduled work.