Skip to content

Projects and namespaces

Set up your agent

Give your coding agent a Steel browser and the Steel skills, so that it browses and writes Steel code the right way. Learn more

Install the Steel CLI. It signs you in and installs the skills for your coding agents.

curl -fsS https://setup.steel.dev | sh

Or send this prompt to your coding agent, and it does the same:

Read https://setup.steel.dev/install.md and follow it to set up Steel for this coding client.
Then continue my requested task using the installed Steel skill.

Set up your agent →

Steel groups your work by organization, project and namespace. An organization is your account. A project is a group inside the organization. It has its own sessions, profiles, credentials and API keys. A namespace is a label inside a project that selects which stored credentials a session uses. Use projects to keep apps or environments apart. Use namespaces to keep your own users' logins apart inside one app.

Organization, project, namespace

organization
  members, billing, files, extensions
  project (one is the default project)
    sessions, profiles, API keys
    namespace "default"
      credentials
    namespace "example:jane"
      credentials
  • The organization is what you sign up for. It has the members, the plan and the bill. Organizations and members covers it.
  • A project belongs to one organization. Every organization has a default project, and you can add more. Each project has an id, a name and a slug. Projects shows how to create and use them.
  • A namespace is a name that a session and its credentials share. Namespaces need no setup. A session that names none uses default. A namespace name can use letters, digits, _, ., : and -, and it cannot be . or ...

What a project isolates

A project holds these, and they do not reach across projects:

ResourceHow it follows the project
SessionsA session runs in one project. A key for one project sees and releases only that project's sessions.
ProfilesA profile belongs to one project. A session can load only a profile from its own project.
CredentialsA credential belongs to one project, and to one namespace in it.
API keysA project key works in its project only.
Quick actionsEach request runs in a project.

Uploaded extensions belong to the organization, not to a project, and so do the files that you upload to the organization's file storage.

A project limits what its keys can reach. Give each app or each environment its own project and its own key. A key that leaks then exposes one project, not the whole organization.

What a namespace isolates

A namespace selects credentials. A session uses only the credentials stored in its own project and its own namespace, for the page's origin. The match is exact. No namespace inherits from another, and there is no wildcard.

Namespaces let you store a login for each of your users on the same site. Store Fred's login under example:fred and Jane's under example:jane. A session created with namespace: "example:fred" fills in Fred's login only.

A namespace is not an access control. Any key that can create a session in the project can name any namespace. Your backend decides which namespace each request may use. Do not use a namespace from an untrusted client without checking it. Credentials shows how to store a login and use it in a session.

API key scopes

A project key reaches one project, and an organization key reaches every project in the organization. Choose a scope lists what each key can do and who can create it.

When you create a session, Steel picks its project in this order:

  1. A project key: the key's project.
  2. An organization key: the project in projectId. Without projectId, the request fails with 400. The same holds for Quick actions, profiles and credentials.
  3. A sign-in to the dashboard: the project in projectId, or the default project.

The session's namespace is the one in namespace. Without namespace, the session uses the project's namespace, which is default for a new project.

The MCP server follows the same rules. When a client signs in, you pick one project, and the sessions that the agent creates run there. A client that sends an API key works in the key's project, so it needs a project key.