INTEGRATIONS

Using Nah Cloud in the terminal

Log in to Nah Cloud from your terminal and launch agents from plain English descriptions — no web dashboard required for day-to-day use.

Log in to Nah Cloud

Nah Cloud agents are opt-in. Before you can launch agents from the terminal, authenticate once with the nah cloud logincommand. The token is stored in your platform credential store and scoped to one tenant.

Commands

# Authenticate once — stores a bearer token scoped to your tenant
nah cloud login

# Verify the token is active
nah cloud status

Environment variable fallback

If you prefer not to use the login flow, setNAH_CLOUD_TOKEN as an environment variable. This is useful for CI or scripting scenarios.

Launch an agent from the terminal

Once logged in, launch agents with a plain-English description:

# Launch an agent from a plain-English description
nah cloud launch "Review the login flow in src/auth.ts and summarize failure cases"

# Check progress from the terminal
nah cloud status

# Stop an agent
nah cloud stop <agent-id>

# View the dashboard URL for this agent
nah cloud url <agent-id>

Opt-in telemetry tiers

By default, agents run with Tier 1 metrics only — duration, token usage, step counts, and errors. No prompt content leaves the machine.

Set trace: true on launch to enable content tracing (prompts, assistant text, tool outputs) for that specific run. Traces are captured per-project, behind a flag, with a short TTL — never sold or stored long-term.

Dashboard mirror

Every operation you perform from the terminal is mirrored in the Nah Cloud dashboard. Open the dashboard to view:

  • Real-time event stream and run progress
  • Token usage and step counts as they accumulate
  • Full trace waterfall if tracing was enabled
  • Billing information and spend ceilings

The dashboard URL is printed to the terminal on agent launch, or retrieve it at any time with <agent-id>.

Design principles

Opt-in by default

Nah Cloud never sends anything unless you explicitly log in and launch an agent. Local sessions continue to run read-only with no network traffic.

Terminal-native

Every Nah Cloud operation maps to a terminal command. Launch, stop, status and URL lookups all work from the shell — no web dashboard required for day-to-day use.

Workflow summary

In the terminal: run nah cloud login, then launch with a plain-English description — e.g. nah cloud launch “Review the login flow in src/auth.ts and summarize failure cases”.

The agent runs in a cloud sandbox, collects metrics (and optionally traces via trace: true), and reports back to the dashboard.

That’s it. The agent runs in the cloud, reports back to you, and you can stop it at any time. No web forms, no hidden orchestration.