SLW / devportal Production apps Signing in…
Guide Β· how to work

How to work

You work in the Claude desktop app: you describe what you want in plain English, it builds, and you review. Here's the day-to-day β€” plus a couple of habits that keep it smooth.

Getting into your workspace

You work through the Claude desktop app connected to your personal cloud workspace β€” one environment with every app you have access to inside.

Show steps for:
01

Set up once

Open the Set up my computer guide and paste the single command. It installs everything, signs you in, and builds your workspace. Add it to Claude Desktop once as an SSH connection (codespace@localhost / port 2222)(cs.<your-workspace>.main, port empty) β€” saved in the app after that.

02

Each session, open your link

Run irm rivent.dev/connect | iex in PowerShell and leave the window open (~15s). See Connect Claude Desktop.

02

Open Claude Desktop

On Mac there's nothing to run each session β€” Claude Desktop connects to your workspace directly.

03

Open your app & work

In Claude Desktop, connect to your workspace, then in Select Remote Folder type /workspaces and pick your app (terminal, podcast, lpflow) β€” experiments sit one level down, in /workspaces/experiments/<name>. Then say what you want β€” e.g. "work on Terminal."

The everyday loop

You talk to Claude in plain English, like giving instructions to a capable teammate. You never write code β€” you describe, review, and decide.

You"Add a button that marks an email as read."
ClaudeMakes the change and shows you.
You"Nice β€” make it blue, and can you show me the page?"
ClaudeAdjusts it and opens the app so you can see it live.

Want to see your change running? Just ask Claude to show you β€” it starts the app for you; you don't need to know any commands. Not sure how something works? Ask it to explain.

When you have a lot to do, use /capture

Three commands carry ideas from "thought" to "shipped" β€” plus a quick read on where everything stands. Reach for them especially when several things pile up.

/captureDrop an idea in. Claude shapes it β€” even a quick mockup β€” and lines it up in the backlog, ready to build.
/executeBuild a batch. Takes what's lined up and carries it all the way to done β€” designed, built, and shipped.
/statusSee where things stand. Inbox, ready, in flight, and just shipped β€” a quick read on the backlog.
πŸ’‘

Recommendation: when a bunch of ideas hit you at once, don't fire them off one by one β€” capture each one. It keeps them organized, makes sure each gets thought through and designed before it's built, and nothing gets lost. Then execute builds them in a tidy batch. A pile of ad-hoc "also do this" requests gets messy fast; capturing first avoids that.

Full command reference lives on How we build → The commands →

How your work goes live

You build on the app's safe copy (Dev) and the finished change crosses to the live app (Production) through one reviewed gate. New to that two-copies idea? Start here covers it β†’

1DevYou describe it, Claude builds it on the safe copy. It can't affect the live app or anyone else's work β€” experiment freely on safe data.
2DevIt becomes a proposed change with its own live preview link on the app's Review & publish tab β€” try the real thing on safe data before it's live.
3The gateApprove it. Tick the ready changes and publish once the automatic checks are green β€” no git or pull-request jargon. Risky ones wait for Shawn (below); Claude tells you which kind yours is.
4ProductionIt goes live β€” the change crosses into the real app and teammates see it.

βœ… You ship it yourself

Publish once the automatic checks pass

  • βœ“
    New buttons, screens, and layout changes
  • βœ“
    Copy, styling, and behavior tweaks
  • βœ“
    Adding a data source or a dev key

πŸ”’ Waits for Shawn

Code-owner review before it can go live

  • β—†
    Database changes β€” a new field, list, or record type
  • β—†
    Production / deploy config
  • β—†
    Anything touching real data or money β€” ask first

Plan what's next on the app's Plan tab β€” a simple Inbox β†’ Up next β†’ In progress β†’ Done board built right into the portal. Cards can hold notes and file / image / PDF attachments. No GitHub, no leaving the portal.

βœ…

Everyone works on a separate copy, so many people can build at once without clashing. You ship normal work yourself on green CI. Shawn is pulled in only for database changes and production config β€” where a mistake could hit real data.

When a change needs new data

Sometimes a feature needs to store something new β€” a new field on a form, a new list, a new kind of record. That's a database change. You don't do anything special: describe what you need and Claude builds it, on practice data. But a database change is one of the few things that pauses for Shawn's review before it can go live, because real data is involved β€” Claude opens it for his sign-off automatically.

One thing to know: adding new fields is routine. Changing or removing existing ones is handled more carefully β€” with a backup β€” because real data is involved. Claude follows that rule for you.

Habits that help

  • βœ“
    Describe the what, not the how. Plain English is the whole interface.
  • βœ“
    Ask to see it. Have Claude run the app or show the change before you call it done.
  • βœ“
    Capture when it piles up. Lots of ideas at once β†’ /capture each, then /execute.
  • βœ“
    Keep changes small. One thing at a time reviews faster and breaks less.
  • βœ“
    Something's off? Check the fix list. Push failed, workspace asleep, Desktop won't connect β€” the connect guide's "If something's off" list has the 30-second fix for each.
  • βœ“
    Ask when unsure β€” especially anything touching real data or money.

← Start here β€” the five-minute overview.