1
Install the desktop app
Download Nuphos for macOS from nuphos.ai and open the
app.
2
Sign in
Sign in with Google, or with your email and a verification code. The
first time you sign in, Nuphos creates a team for you — the container
that everything else lives in.
3
Connect Claude Code
On a machine where Claude Code is signed in, generate a long-lived token:In Nuphos, open Settings → Workspace → Agent and bind the generated
token. Nuphos prepares an isolated
OpenAB runtime for the workspace;
wait until its status is Online before starting a conversation.Only a workspace Administrator can bind or remove the token. See
Agent runtime for the full setup and security model.
4
Connect a cloud account
Open Connectors and connect your first account. The agent needs at
least one connected account to do anything useful.Both providers offer a guided setup where your agent runs your local CLI
and does the work for you — that’s the fastest path.
Connect AWS
Assume an IAM role via OIDC.
Connect GCP
Impersonate a service account.
5
Start an agent session
Open the Agent and start a new session. Select the account you just
connected as the session’s credential, then describe what you want — for
example:
“List the EKS clusters in this account and tell me if any nodes are unhealthy.”Claude Code investigates using real tools and streams its progress into the shared Nuphos transcript. See Agent sessions.
6
Approve a change (when you're ready)
Ask your agent to change something and it won’t act blindly — it proposes a
plan with the steps, risk, and cost, and waits for you to approve before
anything runs. See Plans & approvals.
Next steps
Core concepts
Teams, agent runtimes, plans, memory, and the credential model.
Invite your team
Add members and set roles.
Automate with triggers
Run the agent on a schedule or via webhook.
Chat from Slack or iMessage
Talk to the agent where your team already is.