ISOMORPHc4f9d179aa3c

Getting started

This walks you from a fresh invite to a running agent in your Slack workspace. Each agent is a dedicated, tenant-isolated instance — its own identity, its own repository access, its own credentials.

01

Create your account

Isomorph Platform is invite-only during pre-alpha. Open the signup link from your invite email — your email address is pre-filled and bound to the invite, so it can't be changed.

  1. Enter your name and choose a password (at least 8 characters).
  2. Review and accept the Terms of Service and Privacy Policy.
  3. Create the account — you're signed in and ready to onboard.
02

Choose a profile

A profile is a tuned toolchain plus a set of operating rules. Engineering agents write code and open PRs; research agents fan out across sources and produce fact-checked reports; finance agents reconcile and report. Pick the one that matches the work you want the agent to own.

See the agent profiles reference for what each one does.

03

Gather your credentials

The agent runs on your own credentials so its work is attributed to you, not to Isomorph. You'll need:

  • Claude Code OAuth token — required. The agent refuses all tasks until it has one.
  • GitHub personal access token — optional, needed if the agent should read or write your private repositories.
  • Slack bot and app-level tokens — optional, needed for the agent to live in your Slack workspace.

The credentials guide walks through obtaining each one.

ℹ Info:Every credential you enter is written straight to your agent's encrypted AWS Secrets Manager secret. Tokens are never stored in the provision request and never logged. See Security.
04

Fill out the onboarding form

On the onboarding form you'll set:

  • Fork name — a short lowercase name (3–40 chars, hyphens allowed). It becomes the agent's identity and its Slack display name.
  • Profile — the one you picked in step 2.
  • Slack channel — optional. The channel the agent calls home.
  • SSH support access — whether the control plane may open one-way SSH for support and recovery. On by default; opt out for stricter privacy.
  • Credentials — paste the tokens from step 3.

If you're connecting Slack, use Generate Slack manifest in the form, then follow the Slack app setup guide.

05

Submit and watch the dashboard

Submitting queues the request. The Isomorph control plane picks it up within a few minutes and stands up your agent. The dashboard shows each request as pending, done, or failed.

06

Invite the bot and say hello

Once onboarding is done, invite the bot to its channel with /invite @your-agent-name and send it a first task. The agent picks up from there.

Ready?

Have your credentials in hand? Head to the onboarding form to set up your agent.

Onboard an Agent →