Workspace

What is a Workspace?

A Workspace in Tool Forge is the top-level organizational unit that groups your tools, environments, and team members together. Think of it as an organization or team account—it's where all your Tool Forge resources live.

Every Tool Forge account starts with creating a workspace. You can be a member of multiple workspaces, making it easy to collaborate across different teams or projects.

Creating a Workspace

When you first sign up for Tool Forge, you'll be guided through an onboarding flow to create your first workspace:

1. Sign in to Tool Forge using GitHub, Google, or email
2. Name your workspace - Choose a descriptive name that reflects your team or project (e.g., Billing Team, Customer Support, Acme Corp)
3. Complete setup - Your workspace is ready to use

You can create additional workspaces at any time from the dashboard.

Workspace Structure

Each workspace contains:

Workspace (e.g., "Acme Corp")
├── Environments
│   ├── Development
│   ├── Staging
│   └── Production
├── Members
│   ├── admin@acme.com (Owner)
│   ├── developer@acme.com (Member)
│   └── support@acme.com (Member)
└── API Keys
    ├── pk_test_xxx (Development)
    └── sk_live_xxx (Production)

Team Members

Workspaces support team collaboration. You can invite team members to join your workspace and work together on tools.

Inviting Members

1. Navigate to your workspace
2. Go to Members in the sidebar
3. Click Invite Members
4. Enter the email address of the person you want to invite
5. Send the invitation

The invited member will receive an email with a link to join your workspace. Once they accept the invitation, they'll have access to all tools and environments in the workspace.

Managing Invitations

You can view and manage pending invitations from the Pending Invitations tab in the Members section. From here you can:

• View all outstanding invitations
• Resend invitation emails
• Revoke pending invitations

Member Roles

Workspace members can have different levels of access:

Workspace Settings

Access workspace settings to:

• Update workspace details - Change the workspace name and other metadata
• Manage API keys - Generate, view, and revoke API keys for different environments
• Danger zone - Leave or delete the workspace

Switching Workspaces

If you're a member of multiple workspaces, you can easily switch between them:

1. Click on the workspace name in the sidebar
2. Select the workspace you want to switch to from the dropdown
3. You'll be redirected to the selected workspace

Best Practices

Naming Conventions

Use clear, descriptive names for your workspaces:

• ✅ Acme Corp - Engineering
• ✅ Customer Support Tools
• ✅ Billing Operations
• ❌ test
• ❌ my-workspace

Workspace Organization

Consider how you want to organize your workspaces:

• By team - Each team has their own workspace (e.g., Engineering, Support, Finance)
• By project - Each major project gets a workspace (e.g., Project Alpha, Project Beta)
• By environment - Separate workspaces for different stages (though environments within a workspace are usually preferred)

Security

• Generate separate API keys for each environment
• Use pk_test_ keys for development and sk_live_ keys for production
• Regularly rotate API keys
• Remove members who no longer need access

Next Steps

• Tools - Learn about building tools in Tool Forge
• Agents - Create multi-step workflows with context and branching
• Environments - Learn about creating and managing environments within your workspace
• Quick Start - Connect your first tool to your workspace
• Build from Scratch - Set up a Tool Forge project manually