Volter World

Join a team's World

Ask your team for its platform URL, the organization/World name and the intended scope. You do not need to administer a host to use a shared World.

Before signing in

Install the same exact application dependencies as the team with npm ci. Read the team's selected vendors, seed, handlers and data provenance. A clone or vendor refresh may contain real records; synthetic local defaults do not establish that all shared Worlds are synthetic.

For a platform, run this in the app directory, using the URL your team supplied:

$ npx volter login <platform-url>

The command prints a link and code. The person approves them in their browser; an agent cannot approve the sign-in. The hosted-product guide describes platform keys. A directly served host instead uses a scoped token supplied by its administrator; share a World owns that flow.

After approval, npx volter whoami shows the platform, signed-in person and organizations you can reach. If the organization or World is missing, ask its administrator for access; do not create a similarly named World to work around it. An expired CLI session is a sign-in problem, not a reason to reset local data. Use the team-provided URL again to sign in.

Choose the workflow with your team

TaskGuideWhat changes
Work on local history derived from a team WorldWork from a shared WorldYour own branch, until you push
Run an app against a shared endpointPoint an app at a shared WorldThe shared World's records; coordinate writers
Send local work for the teamShare a WorldEntries move between Worlds with receipts
Read current vendor recordsRead the vendor through a shared WorldA refresh records observations from the real service
Perform writes at the real vendorDeploy from a shared WorldVendor state under the real root's policy

Confirm the exact organization and World before linking a remote. Keep scoped tokens out of source control and browser captures. Push does not mean deploy. Your console's Real services settings and receipts show the root policy; use the model for these semantics.

Host administrators have a separate host setup guide and self-hosting guide. Those are not prerequisites for a teammate joining an existing platform.

View Markdown source

On this page