Create a Workspace
Sign up for IAS and create your first workspace -- the organizational boundary for your team's repositories, agents, and goals.
Create a Workspace
A workspace is your team's top-level container in IAS. It groups repositories, team members, goals, and configuration under a single boundary. Everything you do in IAS -- running agents, creating goals, reviewing decisions -- happens inside a workspace.
What a workspace gives you
When you create a workspace, you get:
- A shared home for your repos. All repositories registered in the workspace share a single job queue, decision log, and goal history.
- Team membership. Invite colleagues to your workspace so they can view progress, answer decision requests, and create goals.
- A unique slug. Your workspace slug (e.g.,
acme-eng) is used in URLs, CLI configuration, and API calls. - Workspace-scoped settings. Configure default behaviors, agent policies, and integrations at the workspace level.
Most teams need only one workspace. Create additional workspaces when you need hard isolation -- for example, separate workspaces for different clients, business units, or security boundaries.
Sign up
- Go to app.ias.dev in your browser.
- Sign up with your email or SSO provider. IAS uses Clerk for authentication, so you can use Google, GitHub, or email/password.
- After signing in, you will be prompted to create your first workspace.
Create your workspace
- Choose a workspace name -- this is the display name your team will see (e.g., "Acme Engineering").
- Choose a workspace slug -- a URL-safe identifier used in the Console URL and CLI config (e.g.,
acme-eng). The slug cannot be changed after creation. - Click Create Workspace.
You are now inside the Console, ready to add repositories and invite team members.
Invite team members
Once your workspace exists, invite others to join:
- Open Settings from the sidebar.
- Go to the Members tab.
- Click Invite Member and enter their email address.
- The invited user will receive an email with a link to join the workspace.
Invited members can view all repositories, goals, and decision requests within the workspace. They can also run their own agents and answer Inbox items.
Workspace settings overview
The Settings page lets you configure workspace-level preferences:
| Setting | What it controls |
|---|---|
| General | Workspace name, slug (read-only after creation), and display preferences |
| Members | Team membership, invitations, and roles |
| Agents | View connected agents, their status (online/offline), and heartbeat history |
| Integrations | GitHub App installation, MCP research tool configuration, and third-party connections |
You can return to settings at any time from the sidebar.
Next steps
With your workspace created, you are ready to connect your first repository:
- Add a repository -- Register a Git repo in the Console and link it to your local checkout.
- Install and bootstrap -- Deploy the IAS scaffold into your repo.
- Configure agents -- Set up a local agent to start processing tasks.
Core Concepts
Understand the key building blocks of IAS -- workspaces, repositories, agents, jobs, goals, the Context Lake, and the principles that tie them together.
Add a Repository
Register a Git repository in the IAS Console and link it to your local checkout so agents can operate on your codebase.